socai
一个真正在浏览器里阅读社交媒体的本地研究代理:像研究者一样驱动你已登录的 Chrome,搜索、读帖、看评论并产出结构化结果。
- Star 数
- ★ 259
- 最近更新
- 12 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 开始前需要
- 典型场景
- 市场研究者需要对比小红书、抖音和 Instagram 上关于某产品(如无糖茶)的讨论,并引用具体帖子、评论和回复。
- 主要局限
- 依赖本地 Chrome 和各平台的登录账号状态,无法无人值守运行,账号可能承担平台风控压力。
- 官网
- socai.io ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-09最新版本 v0.6.18(2026-11-08)
- 源码审查
- 55/100 · 缺口较多
这个 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'。
- 市场研究者需要对比小红书、抖音和 Instagram 上关于某产品(如无糖茶)的讨论,并引用具体帖子、评论和回复。
- Claude Code 或 Codex 用户希望通过 CLI 子命令获取结构化 JSON 社交数据,嵌入脚本化工作流。
- 内容团队需要读取竞品作者主页(socai xhs author <author_id>)分析其笔记与评论互动。
- 分析师需要视频内容文本:用 --ocr 读取封面文字、--transcribe-audio 用本地 Whisper 转录语音。
- 用户需要把研究结果导出为报告、表格或飞书文档,桌面应用支持预览、下载和飞书导出。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | shcargo install --path cli --force --lockedcargo 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 | shCLI 安装(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?
查看各维度的扣分理由
CLI skill 将研究设为只读,并要求用户明确请求后才写入;task begin 不连接 Chrome,status 也声明不连接浏览器。站点 skill 约束 HTTPS 域名、manifest 声明的工具和当前域名,且 ASR 对时长和声道设上限,支持最小权限与敏感数据控制。任务共享 daemon、用户登录 Chrome、模型 API 和外部服务的具体数据流及保留策略未在样本中完整说明;社交评论/回复命令存在外部影响,但没有展示逐次确认或回滚机制。任务 skill 要求保留来源链接,支撑出处可追溯。依赖安全仅见版本化依赖及少量 workflow action 固定主版本,未见样本内的全面审计证据。
AGENTS.md、CLI skill 和站点 skill 对 CLI、runtime、manifest 的职责描述大体吻合;CLI 与 ASR 源码也展示了结构化参数和协议错误处理。安装指南指向下载及平台流程,但产品依赖已登录 Chrome、网络、模型提供商或 podcast 数据源,样本没有足够证据说明这些依赖的可用性保障。ASR 对无效请求、协议不兼容、缺少音频及无语音返回明确错误;研究 skill 也要求把访问限制作为限制处理。
README 列出多个平台及研究命令,CLI skill 描述真实帖子、评论、创作者资料和 podcast 场景。rsi skill 清晰区分通用 browser runtime、站点 package 和可选 native adapter,并以 manifest 限定工具、域名及资源范围。socai-cli skill 对研究任务的触发条件较明确。桌面应用支持 macOS/Windows,但 README 的 CLI 安装样例只展示 macOS,且浏览器登录环境和各平台访问条件限制了跨环境适用性。
仓库以 guide 为安装、命令和开发文档入口,并提供多语言 README、具体命令示例和技能流程;README 的平台示例与 marketplace 描述互相印证。rsi skill 明确列出包约定和资源边界,CLI skill 说明旧版本、注册失败、登录及验证限制。Apache-2.0 有完整 LICENSE 与 workspace 元数据,足以给满分。样本给出 0.6.17 版本和 marketplace 插件版本,但未含清晰的变更日志内容;维护者以 socai 名义出现,publisher 未验证,样本也未明确维护责任人或可信更新承诺,因此维护责任评分较低。
结构化 CLI、JSON 输出、评论/资料读取及来源链接能形成可供后续分析使用的材料,多个平台的专门知识相较通用浏览器操作有明确价值。README 声称速度和精确度优势,但样本无法静态证实结果质量或节省幅度;使用还需安装、浏览器登录,且 podcast 有独立数据范围,因此成本收益证据有限。
README、marketplace 元数据、CLI skill、AGENTS.md、CLI 和 ASR 源码对平台能力、命令方式及边界提供多处对应证据。README 的产品速度、深度和理解能力等宣传性主张缺少本样本中的量化依据;静态材料没有执行或独立验证结果。研究 skill 明确要求保留来源并区分收集证据与推断,站点 skill 要求未完成时返回明确错误、不伪装成功,支持事实与推断的区分。
- 评论和回复命令会与社交平台产生外部影响;样本未展示每次执行前的确认或回滚流程,使用前应核实具体命令行为。
- 登录 Chrome、daemon 任务共享以及模型/API 服务涉及数据流;本样本未说明完整的数据保留和处理细节。
- README 的速度、精确度和深度属于未由该静态样本验证的产品主张。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
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 查看 ↗ -
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 查看 ↗ -
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 开源吗?
socai 安全吗?
socai 还在维护吗?
socai 是谁开发的?
谢谢反馈,我们会据此改进页面。