socai CLI
socai uses your signed-in Chrome to search social platforms, read posts, comments and profiles and transcribe video from the CLI.
- 257 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Work runs in your signed-in Chrome session, so a platform may restrict the account for automated access.
- Direct `comment` and `reply` commands publish text in your name.
- The README installer runs through `curl` and `sh` from a server in China; read the script before running it.
Install
- Works in
Manual install
curl -fsSL https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/latest/install.sh | shThe first CLI command in the README, for macOS. On Windows use the app installer.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Work runs in your signed-in Chrome session, so a platform may restrict the account for automated access.
- Direct `comment` and `reply` commands publish text in your name.
- The README installer runs through `curl` and `sh` from a server in China; read the script before running it.
This is third-party code. Review the repository files before installing.
What it does
socai, a CLI with an agent skill, runs social media research from Claude Code, Codex and Cursor. The commands `socai xhs`, `socai x`, `socai dy`, `socai tiktok`, `socai instagram`, `socai linkedin`, `socai weixin` and `socai podcast` search content, open posts, expand comments, read profiles, OCR images and transcribe video. It works inside the user's already signed-in Chrome instead of scrapers with separate accounts. The `socai-social-research` skill keeps research read-only and asks the agent to turn findings into conclusions that cite specific posts and comments. Podcasts are read without a browser or login.
Who it is for. Marketers, social media managers and researchers who need real discussions from Instagram, TikTok, LinkedIn, X, RedNote or Douyin without browsing by hand.
Good fit when
- An agent collects product feedback and discussion across several platforms.
- A researcher compares how a topic is discussed on Instagram, X and RedNote.
- A team studies competitor accounts and their popular posts.
- Comments under a post are analysed with quotes and links.
Not a fit when
- Plain web search without logging in to social networks is enough.
- The Chrome account in use cannot risk a restriction.
- The agent is expected to publish or mass-post comments.
Example request
Compare how Instagram, TikTok and X discuss sugar-free tea and cite links to specific posts and comments.Limitations
A local CLI and Chrome with a signed-in session are required. macOS installs through `curl`, Windows through the app installer; the script downloads from an Aliyun server in China. The tool acts as your account, so a platform may restrict it for automated access. The `comment` and `reply` commands publish text when invoked directly. Some platform data is shown only to a signed-in user. The integration writes only the `socai-social-research` skill folder and does not replace different contents without the `--force` flag.
How to disable. Delete the `socai-social-research` skill folder from the agent's skills directory and remove the CLI itself. Sign out of social networks in the Chrome profile the tool used.
FAQ
How do I connect socai to an agent?
Run `socai integrate install all`, then `socai integrate status --json` to verify. For one agent use, for example, `socai integrate install claude-code`; the `--scope project` flag keeps the integration inside the repository.
Does it need a separate account or key?
No. The tool reuses the user's signed-in Chrome, so no scraper with borrowed accounts is needed.
Can socai post comments?
It can, but only on a direct command such as `socai x reply`. The research skill keeps work read-only.
Which platforms are supported?
RedNote, Douyin, TikTok, Instagram, LinkedIn, X, WeChat articles and podcasts. Podcasts are read without a browser or login.
How do I install socai on Windows?
Download the Windows app installer from the link in the README. The `curl` command in the README targets macOS.
Discussion
No questions or reviews yet.
Related
CLI toolsA local content crawler for agents: posts, video and pages from public sources and your sessions. Skill, MCP, CLI.
A CLI and MCP server that lets an agent drive your real Chrome with its logged-in sessions: 103 commands across 36 platforms plus browser automation
CLI and skill that let an agent read and search Twitter, Reddit, YouTube, GitHub, Bilibili and Xiaohongshu without paid APIs
An agent drives your real logged-in Chrome: a CLI, MCP and an extension with a separate tab group per session
A web research skill: SearXNG searches, Camofox reads pages and CloakBrowser opens sites that check their visitors
One CLI with unified JSON output for 11 platforms, from Xiaohongshu and Douyin to Taobao, X and 12306, with an agent skill
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| socai (this card) | no | 257 | |
| xiaohongshu-cli | no | 2,729 | covers RedNote only; socai adds five more social networks, WeChat and podcasts |
| Instagram agent skill | no | 6,177 | limited to Instagram; socai compares platforms in one research task |
README in short
The author builds an ontology of entities, states and flows for each platform so the agent works with those instead of raw markup. A desktop app for macOS and Windows is available.