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.