socai
A local research agent that actually reads social media: it drives your signed-in Chrome like a researcher would — searching, reading posts and comments, and returning structured results.
- Source repo
- socai-io/socai
- Stars
- ★ 259
- Last updated
- 11d ago
- License
- Apache-2.0
- Primary language
- Rust
- FA score
- 55/100 · Major gaps
At a glance
- Works with
- Portable with changesCodex · Claude Code
- You'll need
- Typical use
- A market researcher comparing how sugar-free tea is discussed on RedNote, Douyin, and Instagram, citing specific posts, comments, and replies.
- Main limitation
- Depends on local Chrome and per-platform login state, so it cannot run unattended and your accounts bear platform risk-control pressure.
- Website
- socai.io ↗ set on GitHub
- Maintenance
- Commits in the last 30 dayslast commit 2026-11-09latest release v0.6.18 (2026-11-08)
- Source review
- 55/100 · Major gaps
What does this agent do, and when should you use it?
socai is a local social-media research agent that is neither a scraper nor a reverse-engineered API: it drives your signed-in Chrome over CDP, opens real pages, and reads posts, comments, and author profiles across Xiaohongshu, Douyin/TikTok, Instagram, and LinkedIn, with local OCR on images and speech transcription on videos. It ships three interfaces sharing the same browser connection and run-record core: a desktop app (macOS/Windows), a structured CLI designed for agents like Claude Code and Codex, and an interactive terminal UI (running socai with no subcommand). Every run writes structured JSON, media artifacts, a media_manifest., and reports or spreadsheets under ~/.socai/runs/<timestamp>_<task>/. Research commands are read-only by default; publish and comment commands require an explicit target and content and never automatically retry uncertain submissions. The project is Apache-2.0 licensed, and the hosted cloud browser (socai pro remote mode) is currently in beta.
socai connects to your Chrome (via remote debugging) and runs per-platform research commands: socai xhs search supports --num-notes, --num-comments, --filter publish_time=一周内, --download-media, --ocr, and --transcribe-audio; socai dy, socai tiktok, socai instagram, and socai linkedin provide search, author profiles, post details, comments, and media downloads. OCR runs locally on images, and transcription uses a local Whisper helper installed alongside socai (cargo install --path asr). Running socai without a subcommand opens the terminal interface for agent-led cross-platform research. Results are written to ~/.socai/runs/ including structured JSON, media_manifest., and debug snapshots. socai config set chrome.profile switches among four browser modes: existing, managed, auto, and remote. Write operations are limited to explicit invocations such as socai xhs comment '<complete_note_url>' --text 'Exact comment text'.
- A market researcher comparing how sugar-free tea is discussed on RedNote, Douyin, and Instagram, citing specific posts, comments, and replies.
- A Claude Code or Codex user pulling structured JSON social data through CLI subcommands inside scripted workflows.
- A content team reading competitor author profiles (socai xhs author <author_id>) to analyze their notes and comment engagement.
- An analyst who needs text from video content: --ocr for cover text and --transcribe-audio with the local Whisper helper for speech.
- A user exporting findings as reports, spreadsheets, or Feishu documents; the desktop app supports preview, download, and Feishu export.
Key setup facts
Pulled from the install and usage notes below. The project README has the current values.
- Install / run
curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | shcargo install --path cli --force --lockedcargo install --path asr --force --locked
- Config files
~/.socai/bin/socai- Install notes cover
- Windows · macOS
How do you install or deploy this agent?
Desktop app: download the macOS universal .dmg or Windows x86_64 setup.exe from GitHub Releases, then follow the in-app steps to connect Chrome (first connection requires enabling remote debugging and confirming the browser permission prompt).
CLI install (macOS):
bash
curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | shCLI install (Windows PowerShell):
powershell
$installer = Join-Path $env:TEMP 'socai-install.ps1'; Invoke-WebRequest -UseBasicParsing https://github.com/socai-io/socai/releases/latest/download/install.ps1 -OutFile $installer; Unblock-File $installer; & $installerThe installers place socai at ~/.socai/bin/socai (macOS) or %USERPROFILE%\.socai\bin\socai.exe (Windows) and configure the PATH. If no prebuilt binary exists, or for development:
bash
git clone https://github.com/socai-io/socai.git
cd socai
cargo install --path cli --force --locked
cargo install --path asr --force --lockedHow do you use this agent?
Connect Chrome, then run structured commands. Examples:
bash
socai xhs search "beginner camping gear mistakes" --num-notes 10 --num-comments 8 --pretty
socai dy search "beginner camping gear" --num 20
socai tiktok search "beginner camping gear" --num 20 --pretty
socai instagram search "beginner camping gear" --num 20 --pretty
socai linkedin search "product designer" --type people --num 20 --prettyRedNote search also supports platform filters and media processing:
bash
socai xhs search "content marketing ideas" \
--num-notes 30 \
--num-comments 20 \--filter publish_time=一周内 \
--filter sort=最多评论 \
--download-media \
--ocr \
--prettyRun socai with no subcommand to open the terminal interface and let the agent run natural-language cross-platform tasks. Switch browser modes with:
bash
socai config set chrome.profile managed
socai stopWhat are this agent's strengths and limitations?
- Works through your real signed-in Chrome pages, avoiding public API limits and scraper bans.
- Reads deeper than search cards: opens posts, expands comments and replies, reads author profiles, and runs local OCR and Whisper transcription.
- Five platforms (RedNote, Douyin, TikTok, Instagram, LinkedIn) share one CLI, desktop app, and run-record core, with a media_manifest. inventory per run.
- Research commands are read-only by default; writes need explicit target and content, verify the signed-in actor before dispatch, and never auto-retry — a clear safety boundary.
- Depends on local Chrome and per-platform login state, so it cannot run unattended and your accounts bear platform risk-control pressure.
- Desktop builds are macOS and Windows only — no Linux build; the hosted cloud browser (remote mode) is beta and requires socai pro activation.
- Transcription requires building and installing a separate local Whisper helper (the asr crate) via Cargo — extra cost for non-Rust users.
- Video transcription on some routes requires signing in and selecting the socai agent; the bundled model applies only on paid or offline transcription routes.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| socai This agent | 55 · Major gaps | — | ★ 259 | 11d ago | Rust | Codex · Claude Code |
| Jev Social | 88 · Good | CLIFree + model costs | ★ 216 | 13d ago | JavaScript | — |
| Social Media Research Skills Pack | 60 · Some gaps | Agent plugin / skillFree + model costs | ★ 6.9k | 2mo ago | Python | ChatGPT · Codex · Claude Code |
| XScientist | 80 · Good | CLIFree + model costs | ★ 128 | 20d ago | Python | OpenAI API · Claude API |
How does FollowAgents rate this agent?
Why each dimension lost points
The CLI skill makes research read-only unless the user explicitly requests a write, and says task registration does not connect to Chrome; status also reports readiness without connecting. The site skill constrains HTTPS domains, manifest-declared tools, and the current hostname; the ASR worker limits duration and channels. These support least privilege and sensitive-data controls. The sample does not fully describe data flows or retention for the shared daemon, authenticated Chrome, model APIs, and external services. Social comment/reply commands can have external effects, but per-action confirmation and rollback are not shown. The research skill requires source links, supporting attribution. Dependency security is thin: versioned dependencies and a few workflow actions pinned to major versions appear, but the sample does not show a comprehensive audit.
AGENTS.md, the CLI skill, and the site skill generally agree on CLI, runtime, and manifest responsibilities; the CLI and ASR source also show structured inputs and protocol error handling. Installation documentation points to downloads and platform procedures, but the product depends on authenticated Chrome, network services, model providers, or a podcast data source, and the sample does not establish availability guarantees. ASR reports clear errors for invalid requests, protocol mismatches, missing audio, and no speech; the research skill also says to treat access barriers as limitations.
The README lists multiple platforms and research commands, and the CLI skill describes use cases involving real posts, comments, creator profiles, and podcasts. The rsi skill distinguishes the generic browser runtime, site packages, and optional native adapters, while restricting tools, domains, and resource paths through manifests. The CLI skill gives a clear trigger for research tasks. Desktop support covers macOS and Windows, but the README's CLI installation example is macOS-only, and browser login and platform access conditions limit portability.
The repository directs installation, command, and development documentation to a guide and provides multilingual READMEs, concrete command examples, and skill workflows; README platform examples align with marketplace metadata. The rsi skill specifies package contracts and resource boundaries, while the CLI skill documents older versions, registration failures, login, and access limitations. Apache-2.0 is backed by a full LICENSE and workspace metadata, warranting full marks. The sample shows version 0.6.17 and a marketplace plugin version but no substantive changelog. The publisher is named socai, but the publisher is unverified and the sample does not identify a responsible maintainer or a trusted update commitment, so maintenance responsibility scores low.
Structured CLI and JSON output, along with comment/profile retrieval and source links, can produce material usable in downstream analysis; platform-specific knowledge offers clear potential value over generic browser operation. Claims about speed, precision, and depth are not supported by measurable evidence in this sample. Installation, browser login, and a separate data scope for podcasts also make the cost-benefit case incomplete.
The README, marketplace metadata, CLI skill, AGENTS.md, CLI, and ASR source provide multiple corresponding pieces of evidence for platform capabilities, command use, and boundaries. Promotional claims about speed, depth, and platform understanding lack quantitative support in the sample; the static materials provide no execution or independent validation results. The research skill requires sources and a distinction between collected evidence and inference; the site skill requires clear errors for incomplete results rather than pretending success, supporting separation of fact and inference.
- Comment and reply commands can affect social platforms; the sample does not show per-action confirmation or rollback, so verify command behavior before use.
- Authenticated Chrome, shared daemon tasks, and model/API services involve data flows whose full retention and handling details are not established by this sample.
- The README's claims about speed, precision, and depth are product claims not verified by this static sample.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.6.18 socai 0.6.18
Release notes excerpt
downloads China mirror: - [universal mac dmg](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.18/socai-macos-universal.dmg) - [windows app installer (.exe)](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.18/socai-windows-x86_64-setup.exe) - [macOS CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.18/install.sh) - [Windows CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.18/install.ps1) GitHub archive: …View on GitHub ↗ -
v0.6.17 socai 0.6.17
Release notes excerpt
downloads China mirror: - [universal mac dmg](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.17/socai-macos-universal.dmg) - [windows app installer (.exe)](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.17/socai-windows-x86_64-setup.exe) - [macOS CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.17/install.sh) - [Windows CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.17/install.ps1) GitHub archive: …View on GitHub ↗ -
v0.6.15 socai 0.6.15
Release notes excerpt
downloads China mirror: - [universal mac dmg](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.15/socai-macos-universal.dmg) - [windows app installer (.exe)](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.15/socai-windows-x86_64-setup.exe) - [macOS CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.15/install.sh) - [Windows CLI installer](https://socai-downloads.oss-cn-hangzhou.aliyuncs.com/releases/v0.6.15/install.ps1) GitHub archive: …View on GitHub ↗
FAQ
Is socai open source?
Is socai safe to use?
Is socai still maintained?
Who makes socai?
What is socai's official website?
Thanks — we use this to improve the page.