ninnettesudanese653 Socials Test Suite
Run comprehensive tests on all Socials tools to verify the extension and MCP server are working correctly.
Mode Selection
IMPORTANT: Before running any tests, ask the user which mode they want:
Which test mode would you like to run?
1. **Dry Run** (safe) - Tests read-only tools only. Will NOT post, reply, or engage.
2. **Full Test** (destructive) - Tests ALL tools including posting and engagement.
WARNING: This will create real posts, replies, likes, and connection requests!
Enter 1 or 2:
Wait for user response before proceeding. Default to Dry Run if unclear.
Test Execution
Run tests in this order, reporting results as you go:
1. Connection & Access Tests
Test: socials_check_access
Expected: connected=true, canUseMcp=true
If this fails, run the RECOVERY FLOW before stopping:
RECOVERY FLOW:
1. socials_refresh_auth → try to restore auth
2. If still fails: socials_restart_bridge → restart WS bridge
3. Ask user to refresh Socials extension in browser
4. Retry socials_check_access
5. If still fails after recovery, stop and report the issue
Test: socials_health_check
Expected: is_healthy=true, connected=true
Test: socials_diagnostics
Expected: status=ok, extension_connected=true
2. Browser Control Tests
Test: socials_get_active_tab
Expected: Returns current tab info (tabId, url, title)
Test: socials_get_agent_tab
Expected: Returns agent tab info or null if not set
If no agent tab is set:
Test: socials_open_tab (url: "https://x.com/home", focus: false)
Expected: success=true, agentTabPinned=true
Test: socials_get_agent_tab (verify it's now set)
Expected: Returns the tab we just opened
Test: socials_set_agent_tab (tabId: <current agent tab id>)
Expected: success=true (re-pins the same tab)
Test: socials_focus_agent_tab
Expected: success=true, agent tab receives focus
Test: socials_refresh_auth
Expected: Returns auth status (validates device auth flow)
Test: socials_reload_tab
Expected: success=true, agent tab reloaded
Optional (only if testing recovery):
Test: socials_restart_bridge
Expected: success=true, message includes "listening on 127.0.0.1:9847"
Note: After this, user must refresh browser extension before continuing
3. X (Twitter) Tests - Read Only
Ensure agent tab is on X (https://x.com/home):
Test: socials_get_feed (platform: "x", count: 5)
Expected: Returns array of posts with id, author, content
Test: socials_get_page_content
Expected: Returns posts from current page
Test: socials_scroll (direction: "down", amount: 400)
Expected: success=true
Test: socials_x_search (query: "test")
Expected: success=true, navigates to search results (default mode: top)
Test: socials_x_search (query: "startup", mode: "latest")
Expected: success=true, navigates to Latest tab (f=live)
Test: socials_x_search (query: "AI", from: "elonmusk", min_faves: 100)
Expected: query="AI from:elonmusk min_faves:100"
Note: Tests user filter + engagement threshold
Test: socials_x_search (query: "tech", filter: "media", is_retweet: false, lang: "en")
Expected: query="tech filter:media -is:retweet lang:en"
Note: Tests content filter + exclusion + language
Test: socials_x_search (query: "news", since: "2026-01-01", until: "2026-03-01")
Expected: query="news since:2026-01-01 until:2026-03-01"
Note: Tests date range (YYYY-MM-DD format)
Test: socials_x_search (query: "#buildinpublic", has: ["media", "links"], min_retweets: 5)
Expected: query="#buildinpublic has:media has:links min_retweets:5"
Note: Tests hashtag + has filters + engagement
Test: socials_x_search (query: "conference", near: "San Francisco", place_country: "US")
Expected: query="conference near:\"San Francisco\" place_country:US"
Note: Tests location filters
Test: socials_x_search (query: "thread", is_reply: false, mode: "latest")
Expected: query="thread -is:reply", mode=latest
Note: Tests reply exclusion for finding original posts
After search results load, test post context:
Test: socials_get_feed (platform: "x", count: 1)
Expected: Returns at least one post with an id
Test: socials_get_post_context (tweet_id: <id from previous feed>)
Expected: Returns context around the post (replies, parent thread)
Navigate to notifications for notification tests:
Test: socials_navigate (url: "https://x.com/notifications")
Expected: success=true
Wait 2 seconds, then:
Test: socials_x_notifications (count: 5)
Expected: Returns array of notifications with:
- type: "like", "follow", "repost", "reply", "quote", "mention", or "unknown"
- user: { name, handle, avatarUrl, isVerified }
- timestamp: ISO datetime string
- relatedContent: truncated text of the liked/mentioned tweet (if applicable)
- tweetUrl: URL to the tweet (for tweets)
- tweetId: Tweet ID for use with socials_engage_post / socials_quick_reply
Note: Must be on https://x.com/notifications page
Note: If fewer notifications than requested, will auto-scroll up to 3 times
Test notification engagement workflow (if tweet notification found with tweetId):
Test: socials_engage_post (tweet_id: <tweetId from notification>, like: true, bookmark: true)
Expected: success=true, likes and bookmarks the tweet directly from notifications page
Note: No navigation needed - engage_post works on current page
Test: socials_quick_reply (tweet_id: <tweetId from notification>, reply: "Thanks for the engagement! [timestamp]")
Expected: success=true, replies to the notification tweet directly
Note: Opens reply modal on the notification tweet and posts - no navigation needed
4. X (Twitter) Tests - Destructive [FULL MODE ONLY]
Skip this section in Dry Run mode.
Before running, confirm with user:
About to test X engagement tools. This will:
- Create a test post on your X account
- Like and bookmark a post
- Reply to a post
Continue? (yes/no)
If confirmed:
Test: socials_create_post (content: "Test post from Socials MCP - please ignore [timestamp]", platform: "x")
Expected: success=true, returns post URL
Action: Note the post URL to delete manually later
Test: socials_create_post (content: "Testing newlines:\n\nLine 1\nLine 2\nLine 3\n\n[timestamp]", platform: "x")
Expected: success=true, post should display with proper line breaks
Action: Note the post URL to delete manually later
Note: Tests newline (\n) support in X compose box
Test: socials_create_post with video (content: "Testing video upload [timestamp]", platform: "x", media: [video file])
Expected: success=true, waits for upload progress to reach 100% before posting
Action: Note the post URL to delete manually later
Note: Tests video upload progress detection (waits for "Processing X%" to complete)
Test: socials_engage_post (tweet_id: <id from feed>, like: true, bookmark: true)
Expected: success=true
Note: This will like and bookmark a real post
Test: socials_quick_reply (tweet_id: <id from feed>, reply: "Test reply from Socials MCP [timestamp]")
Expected: success=true, returns reply URL
Action: Note the reply URL to delete manually later
After tests, remind user:
Destructive X tests complete. Please manually delete:
- Test post: [URL]
- Test reply: [URL]
- Undo like/bookmark if desired
5. LinkedIn Tests - Read Only
Navigate to LinkedIn:
Test: socials_navigate (url: "https://www.linkedin.com/feed/")
Expected: success=true
Wait 2-3 seconds for page load, then:
Test: socials_get_feed (platform: "linkedin", count: 5)
Expected: Returns array of LinkedIn posts
Test: socials_linkedin_posts_search (query: "startup")
Expected: success=true
Test: socials_linkedin_people_search (query: "software engineer")
Expected: success=true
Test: socials_linkedin_get_people (count: 3)
Expected: Returns array of people results
Test: socials_linkedin_go_to_page (pageNumber: 2)
Expected: success=true, navigates to page 2 of results
Test: socials_linkedin_next_page
Expected: success=true, navigates to page 3 of results
Navigate to a profile for connection status and profile tests:
Test: socials_navigate (url: "https://www.linkedin.com/in/satyanadella/")
Expected: success=true
Wait 2 seconds, then:
Test: socials_linkedin_connection_status
Expected: Returns connection status with one of:
- connected (detected via "More" menu button)
- pending_sent (detected via "Pending, click to withdraw" button)
- not_connected (detected via "Invite to connect" button)
- follow_only, unknown
Also returns actions_available array
Test: socials_linkedin_profile
Expected: Returns profile details including:
- Basic: name, headline, location, profileUrl
- Connection: connectionDegree, followers, connections
- Content: about, currentRole, experiences, education, skills
- Contact Info: contactInfo object with emails[], phones[], websites[], birthday, twitter, address
Note: Tab will briefly focus to trigger LinkedIn's lazy-loaded content
Verify: Contact info extraction works (requires 1st degree connection for full data)
For contact info verification, navigate to a 1st degree connection:
Test: socials_linkedin_profile (on a 1st degree connection)
Expected: contactInfo should contain at least some fields if shared by connection
Note: Contact info visibility depends on the connection's privacy settings
6. LinkedIn Tests - Destructive [FULL MODE ONLY]
Skip this section in Dry Run mode.
Before running, confirm with user:
About to test LinkedIn engagement tools. This will:
- Like a LinkedIn post
- Send a connection request (optional)
Continue? (yes/no)
Also test connection request? (yes/no) - WARNING: Cannot be easily undone!
If confirmed:
Navigate to feed first:
Test: socials_navigate (url: "https://www.linkedin.com/feed/")
Test: socials_get_feed (platform: "linkedin", count: 1)
Expected: Returns at least one post with post_id
Test: socials_linkedin_engage (post_id: <id from feed>, like: true)
Expected: success=true
Note: This will like a real LinkedIn post
If user confirmed connection request test:
Test: socials_linkedin_people_search (query: "test account")
Expected: success=true
Test: socials_linkedin_get_people (count: 1)
Expected: Returns a person result
Test: socials_linkedin_connect (profile_url: <url from people result>, note: "Test connection from Socials MCP")
Expected: success=true
WARNING: This sends a real connection request!
After tests, remind user:
Destructive LinkedIn tests complete. You may want to:
- Unlike the post if desired
- Withdraw connection request if sent
7. Reddit Tests
Navigate to Reddit:
Test: socials_navigate (url: "https://www.reddit.com/")
Expected: success=true
Wait 2-3 seconds for page load, then:
Test: socials_get_feed (platform: "reddit", count: 5)
Expected: Returns array of Reddit posts with title, author, subreddit
Test: socials_get_page_content
Expected: Returns posts from current Reddit page
Test: socials_scroll (direction: "down", amount: 400)
Expected: success=true
Navigate to a specific subreddit:
Test: socials_navigate (url: "https://www.reddit.com/r/programming/")
Expected: success=true
Wait 2 seconds, then:
Test: socials_get_feed (platform: "reddit", count: 3)
Expected: Returns posts from r/programming
8. Persona Tests
Test: socials_list_personas
Expected: Returns array of personas with id and name
9. Feature Flag Tests
Test: socials_diagnostics (refresh: true)
Expected: Returns feature_gating status with flags
Reporting Results
After each test, report:
- Tool name
- Status: PASS / FAIL / SKIP
- Brief result or error message
At the end, provide a summary:
=== Socials Test Results ===
Mode: [Dry Run / Full Test]
Connection Tests: X/X passed
Browser Tests: X/X passed
X Read Tests: X/X passed
X Destructive Tests: X/X passed (or SKIPPED in dry run)
LinkedIn Read Tests: X/X passed
LinkedIn Destructive: X/X passed (or SKIPPED in dry run)
Reddit Tests: X/X passed
Persona Tests: X/X passed
Feature Flag Tests: X/X passed
Total: XX/XX tests passed
[Any issues or recommendations]
[If Full Mode: List of posts/actions to clean up manually]
Test Guidelines
Always ask mode first: Never run destructive tests without explicit confirmation
Handle failures gracefully: If a test fails, log it and continue with other tests
Wait for page loads: After navigation, wait 2-3 seconds before testing feed/content tools
Clean up reminders: In Full Mode, always remind user what to clean up at the end
Report issues clearly: If something fails, explain what the user might need to fix
Timestamps: Add timestamps to test posts/replies so they're identifiable
Newline testing: When testing posts with \n characters, verify the output has actual line breaks
Video uploads: Large video uploads may take 1-2 minutes; the extension waits for 100% progress
Modal targeting: Posts/replies correctly target the modal compose box (not timeline composer)
X Advanced Search: Test all modes (top/latest/people/photos/videos) and operators:
- User: from, to, retweets_of
- Time: since/until (YYYY-MM-DD), since_time/until_time (Unix)
- Engagement: min_faves, min_retweets, min_replies
- Content: filter (media/images/video/links), has[], is_reply, is_retweet
- Location: lang, near, place, place_country
- Advanced: list, conversation_id
Optional Parameters
The user may specify:
--dry-runor--safeto skip mode selection and run non-destructive only--fullto skip mode selection and run all tests (still confirms before destructive)--platform x,--platform linkedin, or--platform redditto test only one platform--skip-browserto skip browser control tests (if tab is already set up)--verbosefor detailed output of each tool response
Example Output - Dry Run
Running Socials Test Suite...
Mode Selection: Which test mode? (1=Dry Run, 2=Full Test)
> 1
Running in DRY RUN mode (safe, non-destructive)
[1/9] Connection Tests
socials_check_access: PASS (connected, Pro tier)
socials_health_check: PASS (healthy, 12ms latency)
socials_diagnostics: PASS (v1.0.39)
[2/9] Browser Control Tests
socials_get_active_tab: PASS (tab 123, x.com)
socials_get_agent_tab: PASS (tab 123 pinned)
socials_set_agent_tab: PASS (tab re-pinned)
socials_focus_agent_tab: PASS (focused)
socials_refresh_auth: PASS (auth valid)
socials_reload_tab: PASS (reloaded)
[3/9] X (Twitter) Read Tests
socials_get_feed: PASS (5 posts retrieved)
socials_get_page_content: PASS (5 posts)
socials_scroll: PASS
socials_x_search (basic): PASS (mode: top)
socials_x_search (mode: latest): PASS (f=live)
socials_x_search (from + min_faves): PASS (user + engagement)
socials_x_search (filter + is_retweet + lang): PASS (content filters)
socials_x_search (since/until): PASS (date range)
socials_x_search (hashtag + has + min_retweets): PASS (has filters)
socials_x_search (near + place_country): PASS (location)
socials_x_search (is_reply: false): PASS (exclusion)
socials_get_post_context: PASS (context retrieved)
socials_navigate (notifications): PASS (x.com/notifications)
socials_x_notifications: PASS (5 notifications: 3 likes, 1 follow, 1 mention)
[4/9] X (Twitter) Destructive Tests
SKIPPED (Dry Run mode)
[5/9] LinkedIn Read Tests
socials_navigate: PASS (linkedin.com/feed)
socials_get_feed: PASS (5 posts retrieved)
socials_linkedin_posts_search: PASS
socials_linkedin_people_search: PASS
socials_linkedin_get_people: PASS (3 results)
socials_linkedin_go_to_page: PASS (page 2)
socials_linkedin_next_page: PASS (page 3)
socials_linkedin_connection_status: PASS (not_connected)
socials_linkedin_profile: PASS (profile details)
[6/9] LinkedIn Destructive Tests
SKIPPED (Dry Run mode)
[7/9] Reddit Tests
socials_navigate: PASS (reddit.com)
socials_get_feed: PASS (5 posts retrieved)
socials_get_page_content: PASS (posts on page)
socials_scroll: PASS
socials_navigate (subreddit): PASS (r/programming)
socials_get_feed (subreddit): PASS (3 posts)
[8/9] Persona Tests
socials_list_personas: PASS (4 personas)
[9/9] Feature Flag Tests
socials_diagnostics (refresh): PASS (flags loaded)
=== Socials Test Results ===
Mode: Dry Run (non-destructive)
All 33 read-only tests passed!
6 destructive tests skipped.
Your Socials setup is working correctly.
Example Output - Full Test
Running Socials Test Suite...
Mode Selection: Which test mode? (1=Dry Run, 2=Full Test)
> 2
WARNING: Full Test mode will create real posts and engagement!
Running in FULL TEST mode
[1/9] Connection Tests
socials_check_access: PASS (connected, Pro tier)
...
[3/9] X (Twitter) Read Tests
...all pass...
[4/9] X (Twitter) Destructive Tests
Confirm: About to create posts and engage. Continue? (yes/no)
> yes
socials_create_post: PASS (posted: x.com/user/status/123456)
socials_engage_post: PASS (liked + bookmarked)
socials_quick_reply: PASS (replied: x.com/user/status/123457)
[5/9] LinkedIn Read Tests
...all pass...
[6/9] LinkedIn Destructive Tests
Confirm: About to like posts and optionally connect. Continue? (yes/no)
> yes
Test connection request too? (yes/no)
> no
socials_linkedin_engage: PASS (liked post)
socials_linkedin_connect: SKIPPED (user declined)
...
=== Socials Test Results ===
Mode: Full Test (destructive)
All 36 tests passed! (1 skipped by user choice)
CLEANUP REQUIRED:
- Delete test post: x.com/user/status/123456
- Delete test reply: x.com/user/status/123457
- Undo like/bookmark on X if desired
- Undo LinkedIn like if desired