socai
一个真正在浏览器里阅读社交媒体的本地研究代理：像研究者一样驱动你已登录的 Chrome，搜索、读帖、看评论并产出结构化结果。
- Star 数
- ★ 217
- 最近更新
- 1 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 65/100 · 存在缺口
30 秒速览
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 开始前需要
- 典型场景
- 市场研究者需要对比小红书、抖音和 Instagram 上关于某产品（如无糖茶）的讨论，并引用具体帖子、评论和回复。
- 主要局限
- 依赖本地 Chrome 和各平台的登录账号状态，无法无人值守运行，账号可能承担平台风控压力。
- 源码审查
- 65/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 转录语音。
- 用户需要把研究结果导出为报告、表格或飞书文档，桌面应用支持预览、下载和飞书导出。
如何安装或部署这个 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 当前 | 65 · 存在缺口 | — | ★ 217 | 1 天前 | Rust | Codex · Claude Code |
| Jev Social | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 89 | 1 天前 | JavaScript | — |
| 社交媒体研究技能包 | 27 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 2.9k | 1 个月前 | Python | ChatGPT · Codex · Claude Code |
| EvoScientist：自我进化的 AI 科学家 | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5k | 1 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示写操作默认关闭、需要明确目标、一次性回执防重发（加1分以上），但least_privilege仅1分：工具要求接管用户已登录Chrome并启用远程调试，这是极高权限且托管/远程模式只是可选替代；敏感数据处理仅1分：依赖用户登录会话的cookie与凭据，未见任何加密、脱敏或会话隔离说明；回滚仅1分：只有socai stop与config切换，未说明失败写入或下载的撤销路径。
README内部自洽（模式、配置路径、命令与平台表一致），多安装路径（dmg/exe/脚本/cargo）提高可用性，故各2分；但失败信息仅体现在提及--help诊断命令，未见具体错误语义、退出码或重试策略文档，扣至1分。
面向桌面用户、CLI脚本与agent三类受众，平台矩阵和过滤器值详尽，给3分；能力边界仅2分（说明了读默认、pro beta限制，但ToS合规与平台风险几乎未提）；环境适配2分：仅macOS/Windows，Windows安装器仅x86_64，Linux无桌面版。
文档结构清晰（四语言README、DEVELOPMENT.md、站点扩展指南），安装说明覆盖三种路径，命名稳定（socai xhs/dy/tiktok/instagram/linkedin），license文件完整为Apache-2.0，均3分；known_limitations仅1分：除pro会话限制外无已知问题、平台封禁风险等说明；versioning_changelog仅1分：Cargo.toml为0.6.1但未见CHANGELOG或版本语义说明；维护责任2分：CI工作流显示活跃维护但无维护者名单、安全策略或响应承诺。
输出可用性强：结构化JSON、runs目录、media_manifest.、报表预览，给3分；边际价值2分：以真实登录浏览器绕开冻结API确有差异化但依赖平台不封禁的前提；成本收益仅1分：面向用户的成本（LLM调用、账号封禁风险）几乎未量化，仅CI提到每轮约¥4。
声称可部分追溯到具体命令与配置（2分）；交叉佐证仅1分：本次仅见README译文、Cargo.toml与工作流，回执机制、OCR、Whisper helper等核心声称无对应代码或测试证据可核对；事实与推断基本分离（2分），但'Fast. Precise. Deep.'等营销语未量化。
- 该工具默认接管用户已登录的Chrome（远程调试），等于授予对全部登录会话的读取能力；建议使用managed独立配置文件并使用专用小号。
- 对小红书/抖音/TikTok/Instagram/LinkedIn的自动化访问可能违反各平台服务条款，存在账号受限风险，文档几乎未提示。
- 发布者身份未经验证，安装脚本采用curl|sh直接执行，建议先审查脚本再运行。
- 写操作（发布/评论）虽有回执机制，但发送前确认的实际实现未经代码验证，敏感场景请人工复核。
- 无CHANGELOG与已知限制说明，升级前请阅读发布说明并保留旧版本回退能力。