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

At a glance

Works with
Portable with changesCodex · Claude Code
You'll need
Chrome with remote debuggingWhisper ASR helper (optional, for transcription)Shell / CLINetwork accessLocal filesystem
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)

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'.

  1. A market researcher comparing how sugar-free tea is discussed on RedNote, Douyin, and Instagram, citing specific posts, comments, and replies.
  2. A Claude Code or Codex user pulling structured JSON social data through CLI subcommands inside scripted workflows.
  3. A content team reading competitor author profiles (socai xhs author <author_id>) to analyze their notes and comment engagement.
  4. An analyst who needs text from video content: --ocr for cover text and --transcribe-audio with the local Whisper helper for speech.
  5. 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 | sh
  • cargo install --path cli --force --locked
  • cargo 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 | sh

CLI 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; & $installer

The 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 --locked

How 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 --pretty

RedNote 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 \
--pretty

Run 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 stop

What are this agent's strengths and limitations?

Pros
  • 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.
Limitations
  • 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?

FollowAgents source review · FARS-2.1
Major gaps
55/ 100 5-point scale 2.8 / 5
This review covers the source as of Nov 08, 2026. The project has shipped 1 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 14/29
Reliability 8/14
Adaptability 10/18
Convention 11/18
Effectiveness 7/13
Verifiability 5/8
Why each dimension lost points
Trust14 / 29 · 2.4/5

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.

Reliability8 / 14 · 2.9/5

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.

Adaptability10 / 18 · 2.8/5

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.

Convention11 / 18 · 3.1/5

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.

Effectiveness7 / 13 · 2.7/5

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.

Verifiability5 / 8 · 3.1/5

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.

Risks and how to mitigate them
  • 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.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 8f42465ef88a New commits since this review; the score may not cover them
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/socai.svg)](https://followagents.com/en/agents/socai)
<a href="https://followagents.com/en/agents/socai"><img src="https://followagents.com/badge/socai.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 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 ↗
  2. 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 ↗
  3. 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?
Yes. The source code is on GitHub (socai-io/socai) under the Apache-2.0 licence.
Is socai safe to use?
FollowAgents' FARS review (Nov 08, 2026) scored socai 14/29 on trust and safety. None of the eight safety controls the review checks for was missing outright. The repository has changed since that review.
Is socai still maintained?
Yes. The latest commit on GitHub is from 2026-11-09, within the last 30 days. The latest release is v0.6.18 (2026-11-08).
Who makes socai?
socai is published on GitHub by the account socai-io. FollowAgents has not verified which person or company is behind that account.
What is socai's official website?
The project's GitHub repository lists https://socai.io/ as its website. That link is set by the repository owner; the source code itself is on GitHub (socai-io/socai).
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts