site-use
v2026.4.18
Published
Site-level browser automation — deterministic CLI workflows for Chrome, optimized for LLM agent consumption.
Maintainers
Readme
site-use
想让 AI 帮你盯着 Twitter timeline,又怕封号、又嫌贵?
site-use 让你的 agent 像真人一样刷推,以最低成本把有价值的信息喂给你。
为什么用 site-use
不会封号
你的 agent 不是在"爬"Twitter,而是像一个真人一样在刷推。
site-use 使用你自己的 Chrome 浏览器,像真人一样浏览——滚动有加减速、鼠标移动有弧度、点击带抖动、操作之间会停顿。多年来,全网无数反检测项目和平台斗智斗勇,很多曾经有效的策略早已失效。我们持续追踪这场对抗,把当下仍然有效的策略融进 site-use,并内置诊断套件持续验证效果。
最低成本
没有 site-use 时,你的 agent 为了滚动一下屏幕,需要:截屏 → 看网页 → 决定下一步操作 → 执行。这些辅助动作消耗的 token 远超推文内容本身。
site-use 把这些浏览动作预先封装好,执行时零 token 消耗。agent 只需要处理最终拿到的推文内容。
一次 feed 抓取只需要几秒——稍有等待是因为刻意模拟真人浏览节奏。
对比其他方案
- 普通爬虫/抓取器 看不到你的专属 timeline,除非你把账号密码交给第三方
- 让 agent 自己去看网页 不仅贵,还没有结构化输出,每次都要重新抓
- Twitter 官方 API 是最佳选择,推荐有条件的用户优先使用以支持平台发展。site-use 是为暂时负担不起 $200/月的用户提供的替代方案
结构化语义
你的 agent 拿到的不是一大坨 HTML,而是有语义的结构化内容:
- 谁发的(作者、关注关系)
- 什么时候发的
- 以什么方式(原创、转推、回复、引用)
- 说了什么(推文全文)
- 互动数据(点赞、转推、回复、浏览量)
如果把整个网页丢给大模型,上下文会被大量 HTML 标签占满,真正有价值的内容占比极低——不仅贵,还会让模型降智。site-use 只把有意义的内容喂给 agent。
快速上手
你需要 Node.js 22.14+ 和 Claude Code。
1. 安装 site-use
npm install -g site-use2. 将技能添加到 AI agent
Claude Code:
/plugin marketplace add WilliamPenrose/site-use
/plugin install site-use@site-useOpenClaw:
openclaw skills install site-use-x3. 开始
对 agent 说"帮我设置 site-use",它会启动 Chrome、引导你登录 Twitter、完成第一次推文抓取。
命令行
不用 AI agent 也可以独立使用:
site-use twitter feed # 抓取 timeline(写入文件)
site-use twitter feed --stdout # 完整 JSON 输出到 stdout
site-use twitter search --query "AI agents" # 搜索 Twitter
site-use twitter profile --handle elonmusk # 查看用户资料
site-use twitter tweet_detail --url <url> # 查看推文及回复架构
Browser 层 → Sites 层 → CLIBrowser 层(安全基座)
独立 Chrome 配置文件隔离用户隐私,启动参数级别的反指纹,行为级别的拟人化,三层防护从底层开始构建信任。
Sites 层(确定性工作流)
Twitter 专属工作流,直接提取 Twitter 内部 API 的完整数据。返回结构化 JSON——agent 拿到的是干净数据,不是原始 HTML。
CLI(确定性自动化)
所有浏览动作预先封装为确定性代码——执行时零 token 消耗。agent 只处理最终的结构化内容。内置 Claude Code 插件,无缝集成 agent 工作流。
路线图
- [x] Twitter timeline、搜索、用户资料、推文详情
- [x] 关注/取关(带每日限额保护)
- [x] 反检测诊断套件
- [ ] Reddit 支持
- [ ] 小红书支持
- [ ] 更多站点(欢迎在 Issues 中投票)
License
MIT
