采集

其他 社区 v1.0.0

技能解读

scrape 是浏览器侧的「只读抓取」入口——专门处理「我想从某网站把一组数据弄下来」这一类需求,并明确把写动作(提交表单、登录、点击下单)拒之门外,留给将来上的 /automate(browser-skills Phase 2 P0)。

设计思路

作者把抓取拆成 Match → Prototype 两层:能被现有 browser-skill 命中就直接跑命中的那个;命不中再用 $B 原语手写原型。这避免了「同一类抓取被反复重写」。

工作流

① Step 1 Determine intent — 用户给一行意图("top stories on Hacker News"),没给就只问一次;② Step 2 Refuse mutating intents — 出现 submit / post / send / log in / click X / fill the form / delete / create / order / book 之类动词,回复「/scrape is read-only…」并停止;③ Step 3 Match — 跑 $B skill list 列出现有 browser-skill,再用 $B skill show <name> 读它们的 triggers: / description: / host:,三件事都对得上才视为命中(host 域、triggers 描述同一份数据、不要它没声明的 args)。命中跑 $B skill run <name> [--arg key=value ...];④ Step 4 Prototype — 没命中走 $B goto / snapshot --text / html / links 这套原语手写抓取,迭代选择器,输出 stable JSON shape({"items":[...],"count":N});⑤ Step 5 Skillify nudge — 写完原型主动建议沉淀为 browser-skill。

红线

本技能不做写操作;不会自动登录;不会过 captcha;不会绕 robots——这些都是 /automate 的事,作者明确写了「Until then, use $B click / $B fill / $B type directly」。

适合的场景

  • 一次性把某网站的列表 / 表格 / 链接收集成 JSON
  • 已经有 browser-skill 仓库的团队,想把抓取流量先尝试命中既有 skill
  • 把抓取脚本稳定化、沉淀为可复用 skill

不适合

  • 需要登录态 / 写操作:见 automate,目前未发布就直接用 $B 原语
  • 抓的网站要求 API 接入:直接走 $B js "await fetch(...)" 或同等 API 客户端更可靠

配套

webapp-testing(同样基于 $B 但偏 QA)、web-artifacts-builder(拿到数据后做可分享的可视化)、skillify(把抓取原型沉淀成 browser-skill)、setup-browser-cookies(命中前置:导真实浏览器登录态)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@garrytan · v1.0.0 · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步——确定意图

`/scrape`之后的用户请求就是意图。如果他们不包括,请询问一次:“你想刮什么?用一行描述它,例如“黑客新闻上的头条新闻”或“example.com/products 上的产品名称 + 价格”。不要预先提出多个澄清问题。任何进一步的问题

02
第 2 步——拒绝改变意图

如果意图暗示写入 - 像 *提交*、*发布*、*发送*、*登录*、*单击 X*、*填写表格*、*删除*、*创建*、*订购*、*书籍* 这样的动词 - 响应:“/scrape 是只读的。对于变异流程,请使用 /automate(TODOS.md 中的浏览器技能第 2 阶段 P0 — 尚未发布)。在此之前,请使用 $B 单击 /

03
第 3 步 — 匹配阶段

列出现有的浏览器技能:对于每个技能,`$B skill show <name>`公开了完整的SKILL.md,包括`triggers:`、`description:`和`host:`。阅读这些并判断用户的意图在语义上是否与其中之一匹配。置信匹配意味着这三个都为真:

04
第 4 步 — 原型阶段

没有匹配。使用 `$B` 原语驱动页面: `$B goto <url>` — 导航到目标。用户的意图通常是命名一个主机或一个 URL;直接使用它。 `$B snapshot --text`(或`$B text`)—获得页面的干净文本视图以查找选择器。

05
第 5 步——技能化推动

原型成功后,仅附加一行:“说 /skillify 使其成为永久技能(下次调用时 200 毫秒)。”这就是整个推动过程。不要唠叨,不要列出优点,不要催促。主动表面处理是第 3 阶段旋钮 (`gstack-config browser_skillify_prompts`),而不是此技能的工作。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。