brainrot-creations/claude-plugins/using-socials

Working with Socials (MCP tools)

Follow this flow unless the user explicitly asks for something else.

1. Verify connectivity

• Call `socials_check_access` first.
• If the extension is not connected, tell the user they need a paid Socials plan (free tier does not connect), to stay signed in, and to keep the browser open with the extension loaded; do not assume tools work until access check succeeds.

2. Open the right context in the browser

• Use `socials_open_tab` with a concrete URL first. That tab is pinned as the Socials agent tab: feed, reply, scroll, search, and engage run there even if the user is focused on another tab or another Chrome window—automation uses the pinned tab id, not “the focused window.” By default the tab opens in the background; use `focus: true` to switch to it, or `socials_focus_agent_tab` to bring that tab’s window forward. Additional `socials_open_tab` calls open in the same window as the pinned tab when possible so a new empty window does not hijack the agent workspace.
• `socials_get_agent_tab` — see which tab is pinned (platform may be x, linkedin, reddit, or youtube). `socials_set_agent_tab` — pin an existing tab (e.g. X or YouTube already open) by tab_id from `socials_get_active_tab`.
• Use `socials_navigate`, `socials_reload_tab`, or `socials_scroll` on the agent tab (omit tab_id unless targeting a specific tab). `socials_get_active_tab` is the focused tab (what the user sees), not necessarily the agent tab.
• If platform is X: use `socials_x_search` first, then `socials_get_feed` / `socials_quick_reply` / (optionally) `socials_engage_post` on results.
• If platform is LinkedIn: use `socials_open_tab` with https://www.linkedin.com/feed/ and then `socials_get_feed` / `socials_quick_reply` (optionally `socials_scroll`) to work with posts and replies. Use `socials_linkedin_posts_search` to search for posts, then `socials_get_feed` to read results. Use `socials_linkedin_engage_post` to like or repost.
• If platform is Reddit: use `socials_open_tab` with the subreddit URL and then `socials_get_feed` / `socials_quick_reply` (optionally `socials_scroll`) to work with posts.
• If the user wants YouTube: use `socials_open_tab` with https://www.youtube.com/ (home), a watch URL, or search results https://www.youtube.com/results?search_query=... where the query value is URL-encoded (same idea as encodeURIComponent). Refine search with `socials_navigate` on the agent tab. To apply filters (Type/Duration/Upload date/Features/Prioritize), use `socials_apply_search_filters` with platform: "youtube" and filter labels. Read search cards with `socials_get_page_content`; on watch pages use `socials_get_page_content` for metadata + comments (each has `commentId` — the YouTube lc token). To reply to a YouTube comment, use `socials_quick_reply` with post_id set to that `commentId`. `socials_get_feed` is not used for YouTube.

3. Read content

• `socials_fetch_image` — pass a direct image URL (e.g. thumbnailUrl from YouTube cards, X pbs.twimg.com, Reddit preview URLs). Returns an MCP image for side-by-side visual inspection without opening tabs. Token policy: image blocks are high-cost; use this only when it materially improves the outcome (visual comparison/detail checks). If text/URLs are enough, keep thumbnails as URLs and summarize from metadata. Requires the same Socials Pro + extension connection as other MCP tools. Public CDN URLs work; cookie-only private URLs may fail (fetch runs in the MCP process).
• `socials_get_feed` — recent posts from a feed (requires Socials Pro; extension should be on the right feed page).
• `socials_get_post_context` — thread/reply context for a post URL (Pro).
• `socials_get_page_content` —
• On YouTube search results (/results?search_query=…): returns video cards (title, URL, thumbnail URL, channel, views, duration, snippet) with auto-scroll until `limit` is reached or no new rows load.
• On YouTube watch pages (/watch?v=…): returns structured page_data with title/channel/views/likes/description/comments count and extracted comments. Use comment_sort: "top" | "newest" to switch ordering before scrape, comments_limit (1–120, default 20), and expand_description (default true).
• On X/LinkedIn/Reddit: feed snippets as before.

4. Drafting and posting

• `socials_list_personas` — when the user cares about tone or persona-backed generation.
• `socials_generate_reply` — optional AI-assisted draft from Socials (Pro); you may also write copy yourself.
• `socials_quick_reply` — posts a reply in the browser: X/LinkedIn from the feed (post id from `socials_get_feed`); YouTube watch — post_id = `commentId` from `socials_get_page_content` page_data.comments. Always confirm exact text with the user before calling — this is a real post.

5. Errors and limits

• If a tool says not Pro or not connected, explain clearly and do not retry blindly.
• Respect each platform’s terms and the user’s intent; prefer summarizing and drafting over automating spam or harassment.