socai-io/jev-social · 上手攻略
- 仓库：socai-io/jev-social
- 链接：https://github.com/socai-io/jev-social
- 分类：ai-agent · browser-automation · social-media-research
- 作者：Jay
- 更新：2026-09-26
这是什么
Jev Social 是一个浏览器 grounded 社交媒体研究智能体，将 AI 决策模型（Jev）与真实 Chrome 浏览器操作（socai CLI）配对，对 Instagram、TikTok、LinkedIn 三个平台执行可验证的社交研究任务。Jev 负责每一步「搜索 / 打开某个主页 / 阅读某条评论 / 下载视频 / 结束」的选择决策；socai CLI 负责在真实浏览器中执行这些操作。研究者获得的是带时间戳的原始截图卡片 + 最终带引用的 Markdown 报告，而非无法核实的 AI 总结。
解决什么问题
传统 AI 社交分析依赖爬虫 API 或 AI 模拟，容易产生幻觉引用、无备案来源、或因平台反爬而失败。Jev Social 的设计目标有两个：
- 可验证：每条发现必须附有抓取时的原始来源卡片；缺失引用或外国 URL 会自动回退到确定性证据报告模式。
- 真实浏览器：直接操控 Chrome，无需模拟登录或破解反爬，降低被封概率（依赖 Chrome 已登录状态和 socai CLI 的 CLI 封装）。
典型使用场景：营销人员做竞品帖子调研、学术研究者收集 Instagram/TikTok 公开数据、舆情监控人员获取带证明材料的报告。
快速安装
环境依赖
- Node.js 20+（含 npm）
- Chrome 已登录目标平台账号
- OpenRouter API Key（Jev 决策模型调用用，默认 gpt-4o-mini，可换）
- socai CLI（socai 出品的浏览器自动化 CLI，onboard 过程会自动提示安装）
最快上手（推荐）
无需 clone 仓库，直接用 npx 运行：
# 完整 onboarding（交互式引导安装 socai CLI + 输入 OpenRouter key）
npx github:socai-io/jev-social#v0.1.8 onboard
# 跳过 onboard，直接用 loopback demo（无需真实平台账号）
npx github:socai-io/jev-social#v0.1.8
⚠️ onboard 过程会引导配置 OpenRouter key，请确保 key 有效且有额度。
作为 GitHub CLI Skill 集成到 Codex（可选）
gh skill install socai-io/jev-social jev-social@v0.1.8 --agent codex --scope user
作为 OpenClaw Skill 集成（可选）
npx skills add https://github.com/socai-io/jev-social/tree/c411ae1532dd37ab94f8164f13552ed05f4c9ecc/skills/jev-social --skill jev-social --agent openclaw --copy
核心用法
基本研究流程
在 onboard 后的 CLI 提示中输入自然语言研究目标，例如：
find handmade art on Instagram
Jev 会自动循环执行以下步骤，直到认为已收集足够证据：
用户请求
→ Jev 选平台（Instagram / TikTok / LinkedIn）
→ Jev 选具体操作（搜索 / 打开某主页 / 打开某帖子 / 阅读评论 / 下载）
→ socai CLI 在真实 Chrome 执行
→ 结果返回 Jev
→ Jev 决定下一步
→ ……
→ finish → 输出带引用卡片 + evidence report.md
三大平台可用操作对照
| 操作 | TikTok | ||
|---|---|---|---|
| 搜索 | ✅ | ✅ | ✅（人/内容/公司） |
| 打开主页 | ✅ | ✅ | ✅（个人/公司档案） |
| 打开具体帖子/视频 | ✅ | ✅ | ✅ |
| 阅读评论 | ✅ | ✅ | ❌ |
| 下载视频媒体 | ❌ | ✅（仅当用户明确要求时） | ❌ |
| 读取教育/工作经历 | — | — | ✅ |
报告生成
研究完成后，若配置了 OpenRouter key（OPENROUTER_REPORT_MODEL，默认 openai/gpt-4o-mini），系统会用 AI 合成一份带引用的简明报告。设置 OPENROUTER_REPORT_MODEL=off 可完全禁用 AI 合成，输出纯确定性证据报告。
# 换用其他模型
export OPENROUTER_REPORT_MODEL=anthropic/claude-3-haiku
# 完全关闭 AI 报告（纯证据模式）
export OPENROUTER_REPORT_MODEL=off
Docker 部署（SOCAI CLI 独立服务模式）
socai CLI 本身可作为 Docker 服务运行，提供浏览器自动化能力。详情见 https://github.com/socai-io/socai。
典型适用场景
- 社交媒体舆情研究：给定主题（如「手工艺术」「可持续时尚」），自动抓取 Instagram/TikTok 上真实帖子、点赞数、评论内容，输出可引用报告。
- 竞品分析：追踪竞品公司在 LinkedIn 的帖子内容、员工动态。
- 内容创作者调研：了解特定垂类（宠物、美食、旅行）在 TikTok 的热门内容模式。
- 学术数据收集：研究者获取平台公开数据作为定性研究素材（需遵守平台 TOS）。
坑与注意
⚠️ 登录状态依赖：整个流程依赖 Chrome 已登录目标平台。账号被封/需要二次验证时任务会中断，不会伪造成功结果。
⚠️ 平台反爬风险：尽管是真实浏览器操作，TikTok/Instagram 的自动化检测策略可能在连续运行后触发 CAPTCHA。README 记录单次 Instagram 完整研究约 64 秒，TikTok 视频下载约 38 秒。
⚠️ 报告引用验证：所有发现必须附有捕获的原始 URL 来源；外部 URL、缺失引用、原始 JSON 会触发验证失败并回退到确定性报告模式——这是设计特性而非 bug。
⚠️ benchmark 尚未公开发布：v0.1.8 包含 benchmark 框架，但正式结果需要 ≥10 次独立运行才发布，当前状态为 INCOMPLETE。不要把现有数据当作已验证 benchmark 引用。
⚠️ 视频下载仅限 TikTok：Instagram 视频和 LinkedIn 内容不支持下载，只有 TikTok 在用户明确要求时才下载。
⚠️ OpenRouter 费用：Jev 每步决策 + 报告合成都会消耗 OpenRouter API 调用。默认 gpt-4o-mini 成本低，但大规模研究仍需关注用量。
与同类对比
| 工具 | 浏览器真实操作 | AI 决策 | 平台覆盖 | 本地离线 | 开源 |
|---|---|---|---|---|---|
| Jev Social | ✅ Chrome | ✅ Jev（每次操作） | IG / TikTok / LinkedIn | ❌（需 OpenRouter） | ✅ MIT |
| Browserbase | ✅ 云浏览器 | ❌ 需自搭 | 通用 | ❌ | ❌ 商业 |
| Steel Browser | ✅ 浏览器 API | ❌ 需自搭 | 通用 | 部分 | ✅ Apache 2.0 |
| OpenBot / ChatGPT Plugins | ❌ 模拟 | ✅ | 受限 | ❌ | 部分 |
| Traditional scraping | ❌ HTTP 模拟 | ❌ | 受反爬限制 | ✅ | 多样 |
Jev Social 的核心差异是 「Jev 每步决策 + socai 执行」双层架构：Jev 决定「做什么」（操作语义），不决定「怎么做」（DOM 坐标或 shell 命令），避免了传统浏览器自动化工具的脆弱性。
一句话推荐结论
需要从 Instagram / TikTok / LinkedIn 抓取真实、可引用、带时间戳的公开数据做研究，且希望整个过程可复现验证——Jev Social 是目前最直接的开源方案，核心价值在于把 AI 决策的「智能」和真实浏览器操作的「可信」结合在一起，MIT 协议免费使用。