socai

一个真正在浏览器里阅读社交媒体的本地研究代理:像研究者一样驱动你已登录的 Chrome,搜索、读帖、看评论并产出结构化结果。

Star 数
★ 259
最近更新
12 天前
License
Apache-2.0
主语言
Rust

30 秒速览

可在哪里用
兼容但需适配Codex · Claude Code
开始前需要
开启远程调试的 ChromeWhisper ASR 辅助程序(可选,用于语音转录)Shell / 命令行网络访问本地文件系统
典型场景
市场研究者需要对比小红书、抖音和 Instagram 上关于某产品(如无糖茶)的讨论,并引用具体帖子、评论和回复。
主要局限
依赖本地 Chrome 和各平台的登录账号状态,无法无人值守运行,账号可能承担平台风控压力。
官网
socai.io ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-09最新版本 v0.6.18(2026-11-08)

这个 Agent 能做什么,适合哪些场景?

socai 是一个本地运行的社交媒体研究代理,定位既不是爬虫也不是逆向工程 API:它通过 CDP 驱动你已登录的 Chrome,打开真实页面,搜索并阅读小红书、抖音/TikTok、Instagram、LinkedIn 的帖子、评论和作者主页,还能对图片做本地 OCR、对视频做语音转录。它提供三种共享同一浏览器连接与运行记录核心的界面:桌面应用(macOS/Windows)、面向 Claude Code、Codex 等代理的结构化 CLI,以及交互式终端界面(直接运行 socai)。每次运行在 ~/.socai/runs/<timestamp>_<task>/ 下生成结构化 JSON、媒体文件、media_manifest. 及报告、表格等交付物。研究命令默认只读;发布和评论命令需要显式目标和内容,且不会自动重试不确定的提交。项目采用 Apache-2.0 许可证,托管云浏览器(socai pro remote 模式)目前处于 beta 阶段。

socai 连接到你的 Chrome(通过远程调试),然后按平台执行研究命令:socai xhs search 支持 --num-notes、--num-comments、--filter publish_time=一周内、--download-media、--ocr、--transcribe-audio 等选项;socai dy、socai tiktok、socai instagram、socai linkedin 提供搜索、作者主页、帖子详情、评论及媒体下载。OCR 使用本地引擎识别图片文字,转录使用随 socai 安装的本地 Whisper 辅助程序(cargo install --path asr)。不带子命令运行 socai 时,代理会在五大平台间做跨平台研究。结果写入 ~/.socai/runs/,包含结构化 JSON、媒体清单 media_manifest. 和调试快照。通过 socai config set chrome.profile 可在 existing、managed、auto、remote 四种浏览器模式间切换;写入操作仅限显式调用,如 socai xhs comment '<complete_note_url>' --text 'Exact comment text'。

  1. 市场研究者需要对比小红书、抖音和 Instagram 上关于某产品(如无糖茶)的讨论,并引用具体帖子、评论和回复。
  2. Claude Code 或 Codex 用户希望通过 CLI 子命令获取结构化 JSON 社交数据,嵌入脚本化工作流。
  3. 内容团队需要读取竞品作者主页(socai xhs author <author_id>)分析其笔记与评论互动。
  4. 分析师需要视频内容文本:用 --ocr 读取封面文字、--transcribe-audio 用本地 Whisper 转录语音。
  5. 用户需要把研究结果导出为报告、表格或飞书文档,桌面应用支持预览、下载和飞书导出。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • 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
配置文件
~/.socai/bin/socai
安装说明涉及
Windows · macOS

如何安装或部署这个 Agent?

桌面应用:从 GitHub Releases 下载 macOS universal .dmg 或 Windows x86_64 setup.exe,安装后按应用内步骤连接 Chrome(首次连接需启用远程调试并确认浏览器权限提示)。

CLI 安装(macOS):
bash

curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | sh

CLI 安装(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

安装器会把 socai 装到 ~/.socai/bin/socai(macOS)或 %USERPROFILE%\.socai\bin\socai.exe(Windows)并配置 PATH。若无预编译二进制或需源码构建:
bash

git clone https://github.com/socai-io/socai.git
cd socai
cargo install --path cli --force --locked
cargo install --path asr --force --locked

如何使用这个 Agent?

连接 Chrome 后,即可运行结构化命令。示例:
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

小红书搜索还支持平台过滤器和媒体处理:
bash

socai xhs search "content marketing ideas" \
--num-notes 30 \
--num-comments 20 \

--filter publish_time=一周内 \
--filter sort=最多评论 \

--download-media \
--ocr \
--pretty

不带子命令运行 socai 可打开终端界面,让代理跨平台执行自然语言研究任务。浏览器模式切换:
bash

socai config set chrome.profile managed
socai stop

这个 Agent 有哪些优点和局限?

优点
  • 通过已登录的真实 Chrome 浏览器页面工作,避开公共 API 限制和爬虫封号风险。
  • 读取深度不止于搜索结果卡:能打开帖子、展开评论与回复、读作者主页,并做本地 OCR 和 Whisper 语音转录。
  • 五种平台(小红书、抖音、TikTok、Instagram、LinkedIn)共用一套 CLI、桌面应用和运行记录核心,结果附带 media_manifest. 媒体清单。
  • 研究命令默认只读,写入操作需显式目标与内容、调度前验证登录者与目标、不自动重试,安全边界清晰。
局限
  • 依赖本地 Chrome 和各平台的登录账号状态,无法无人值守运行,账号可能承担平台风控压力。
  • 桌面端仅支持 macOS 和 Windows,没有 Linux 构建;托管云浏览器(remote 模式)为 beta 且需 socai pro 激活。
  • 转录功能需要额外用 Cargo 构建并安装本地 Whisper 辅助程序(asr 组件),对非 Rust 用户是额外成本。
  • 视频转录在部分路由下需登录并选择 socai agent,付费或离线转录才走内置模型。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
socai 当前 55 · 缺口较多 — ★ 259 12 天前 Rust Codex · Claude Code
Jev Social 88 · 表现良好 命令行工具免费 + 模型费 ★ 216 13 天前 JavaScript —
社交媒体研究技能包 60 · 存在缺口 Agent 插件 / 技能免费 + 模型费 ★ 6.9k 2 个月前 Python ChatGPT · Codex · Claude Code
XScientist 80 · 表现良好 命令行工具免费 + 模型费 ★ 128 20 天前 Python OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 1 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 11/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

CLI skill 将研究设为只读,并要求用户明确请求后才写入;task begin 不连接 Chrome,status 也声明不连接浏览器。站点 skill 约束 HTTPS 域名、manifest 声明的工具和当前域名,且 ASR 对时长和声道设上限,支持最小权限与敏感数据控制。任务共享 daemon、用户登录 Chrome、模型 API 和外部服务的具体数据流及保留策略未在样本中完整说明;社交评论/回复命令存在外部影响,但没有展示逐次确认或回滚机制。任务 skill 要求保留来源链接,支撑出处可追溯。依赖安全仅见版本化依赖及少量 workflow action 固定主版本,未见样本内的全面审计证据。

可靠稳定8 / 14 · 2.9/5

AGENTS.md、CLI skill 和站点 skill 对 CLI、runtime、manifest 的职责描述大体吻合;CLI 与 ASR 源码也展示了结构化参数和协议错误处理。安装指南指向下载及平台流程,但产品依赖已登录 Chrome、网络、模型提供商或 podcast 数据源,样本没有足够证据说明这些依赖的可用性保障。ASR 对无效请求、协议不兼容、缺少音频及无语音返回明确错误;研究 skill 也要求把访问限制作为限制处理。

适用触发10 / 18 · 2.8/5

README 列出多个平台及研究命令,CLI skill 描述真实帖子、评论、创作者资料和 podcast 场景。rsi skill 清晰区分通用 browser runtime、站点 package 和可选 native adapter,并以 manifest 限定工具、域名及资源范围。socai-cli skill 对研究任务的触发条件较明确。桌面应用支持 macOS/Windows,但 README 的 CLI 安装样例只展示 macOS,且浏览器登录环境和各平台访问条件限制了跨环境适用性。

规范维护11 / 18 · 3.1/5

仓库以 guide 为安装、命令和开发文档入口,并提供多语言 README、具体命令示例和技能流程;README 的平台示例与 marketplace 描述互相印证。rsi skill 明确列出包约定和资源边界,CLI skill 说明旧版本、注册失败、登录及验证限制。Apache-2.0 有完整 LICENSE 与 workspace 元数据,足以给满分。样本给出 0.6.17 版本和 marketplace 插件版本,但未含清晰的变更日志内容;维护者以 socai 名义出现,publisher 未验证,样本也未明确维护责任人或可信更新承诺,因此维护责任评分较低。

有效结果7 / 13 · 2.7/5

结构化 CLI、JSON 输出、评论/资料读取及来源链接能形成可供后续分析使用的材料,多个平台的专门知识相较通用浏览器操作有明确价值。README 声称速度和精确度优势,但样本无法静态证实结果质量或节省幅度;使用还需安装、浏览器登录,且 podcast 有独立数据范围,因此成本收益证据有限。

证据核验5 / 8 · 3.1/5

README、marketplace 元数据、CLI skill、AGENTS.md、CLI 和 ASR 源码对平台能力、命令方式及边界提供多处对应证据。README 的产品速度、深度和理解能力等宣传性主张缺少本样本中的量化依据;静态材料没有执行或独立验证结果。研究 skill 明确要求保留来源并区分收集证据与推断,站点 skill 要求未完成时返回明确错误、不伪装成功,支持事实与推断的区分。

风险与缓解建议
  • 评论和回复命令会与社交平台产生外部影响;样本未展示每次执行前的确认或回滚流程,使用前应核实具体命令行为。
  • 登录 Chrome、daemon 任务共享以及模型/API 服务涉及数据流;本样本未说明完整的数据保留和处理细节。
  • README 的速度、精确度和深度属于未由该静态样本验证的产品主张。
证据充分度:低 评估于 2026年11月8日 审查版本 8f42465ef88a 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/socai.svg?lang=zh)](https://followagents.com/zh/agents/socai)
<a href="https://followagents.com/zh/agents/socai"><img src="https://followagents.com/badge/socai.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.6.18 socai 0.6.18
    发布说明摘录
    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: …
    在 GitHub 查看 ↗
  2. v0.6.17 socai 0.6.17
    发布说明摘录
    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: …
    在 GitHub 查看 ↗
  3. v0.6.15 socai 0.6.15
    发布说明摘录
    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: …
    在 GitHub 查看 ↗

常见问题

socai 官网是什么?
socai 的 GitHub 仓库填写的官网是 https://socai.io/。这个链接由仓库作者设置;源码在 GitHub(socai-io/socai)。
socai 开源吗?
开源。源码在 GitHub(socai-io/socai),许可证是 Apache-2.0。
socai 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 socai 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
socai 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-09,在最近 30 天内。最新版本是 v0.6.18(2026-11-08)。
socai 是谁开发的?
socai 由 GitHub 账号 socai-io 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念