socai-io avatar

socai-social-research

Research public posts, comments, creators, and trends on Xiaohongshu, Douyin, TikTok, Instagram, LinkedIn, and X/Twitter with the local socai CLI and the user's authenticated Chrome session.

version
0.5.0
GitHub stars
258

Install

/plugin install socai-social-research@socai

Run it inside Claude Code after adding the marketplace with /plugin marketplace add socai-io/socai.

Contents

Discovered from source

Skills 1

socai social research

Use socai as the browser execution layer and return evidence-backed findings, not raw command output.

Supported platform routing

Treat every row as a supported first-class research source. Match common platform names and aliases to the corresponding CLI site instead of limiting discovery to Xiaohongshu.

User wordingCLI siteResearch coverage
Xiaohongshu, XHS, RedNote, Redbook, 小红书socai xhsPosts, creators, note bodies, comments, images, and video transcripts when available
Douyin, 抖音socai dyVideos, creators, descriptions, and comments when available
TikToksocai tiktokVideos, creators, descriptions, and comments when available
Instagram, IGsocai instagramProfiles, posts, captions, and comments when available
LinkedInsocai linkedinProfiles, companies, posts, and search results when available
X, Twittersocai xProfiles, posts, threads, and replies when available

For a cross-platform request, invoke each named platform. If the user explicitly asks for “all platforms,” query all six supported platforms and report any platform-specific gate or empty result. For a broad but unspecified request such as “social media,” choose the platforms relevant to the audience and topic, state the selected coverage before synthesis, and never imply that an unqueried platform was checked.

Before research

  1. Confirm socai is available with socai version --no-check --json. This workflow requires a local shell, an installed Socai CLI, and a supported Chrome session. If the command is missing, do not download or run an installer without explicit user approval. Explain the prerequisite and link to https://socai.io/docs/installation/. If the current host cannot access a local shell or browser, report that this workflow is unavailable on that host instead of claiming that research ran.
  2. Run socai status --json. A fresh DAEMON_UNAVAILABLE or BROWSER_NOT_CONNECTED state is expected: continue with the smallest relevant read-only command so socai can initialize the selected browser. Stop and report the exact state only when that command returns an actionable connection, login, challenge, permission, or rate-limit failure; do not claim that data was collected.
  3. Check whether task context registration is available with socai task begin --help. When supported, register the original request once with socai task begin --context-file <path>. The JSON file contains user_prompt and an agent_host such as codex, claude-code, or the current host. Avoid shell-interpolating untrusted prompt text. If the installed release reports that task is unrecognized, skip registration and continue with the requested read-only research; task registration is telemetry context, not a research prerequisite.
  4. Read references/commands.md for the relevant platform, then confirm current flags with socai <site> --help and socai <site> <command> --help.

Execution rules

  • Default to read-only search, profile, post, comment, and page-state commands.
  • Use only the platforms relevant to the request. Preserve structured JSON until synthesis.
  • Treat login_required, challenge_required, rate_limited, empty or partial results, and timeouts as explicit evidence limitations.
  • Cite canonical post/profile URLs returned by socai. Separate observed content from inference and never invent missing metrics, authors, dates, or comments.
  • This plugin is strictly read-only. Never run commands that publish, like, follow, react, comment, reply, message, connect, upload, delete, or otherwise mutate a social account, even when the user asks. Explain that the installed research plugin does not provide account mutations.

Result

Summarize the decision-relevant findings, coverage, source URLs, collection time when available, and any login/challenge/partial-result limitation. Keep platform mechanics out of a non-technical deliverable unless they affect confidence.

Sponsors

Details

Marketplace
socai-io/socai
Source
plugins/socai-social-research
Category
Community