↑

Web 工具策略v1.0.0

web-tools-guide13 KB

在调用搜索、网页抓取或浏览器工具前必读,指导你按场景选择最优工具链:先 web_search/web_fetch,失败时优先用 opencli(覆盖 70+ 站点)而非直接上浏览器,并内置搜索 API 配置引导与网站登录地址速查。

0 0 0 0 更新于 2026-10-28 19:06

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 为网络信息获取任务提供完整的工具决策与故障处理策略。面对搜索关键词、已知 URL 抓取、动态页面交互等不同场景,它会引导你按「web_search/web_fetch → opencli → browser」的分支顺序选择工具,避免一上来就启动重量级浏览器。当搜索 API 报错时,它会输出固定配置指引引导用户完成密钥设置;当页面返回 403 或 CAPTCHA 时,它会优先调用 opencli 尝试 70 余个主流站点的结构化接口,而非直接降级到浏览器自动化。整套流程以 ReAct 范式写成,每次工具切换都要求向用户说明原因,杜绝静默失败。

技能包含

  • SKILL.md(本文件):工具决策树、失败处理流程与操作规范
  • references/web-search-config.md:搜索 API 配置步骤与降级方案
  • references/opencli-guide.md:opencli CLI 的渐进式用法与命令参考
  • references/well-known-sites.json:常用网站登录页、搜索引擎、热搜榜等 URL 速查表
  • scripts/setup-opencli.sh:opencli 与 Browser Bridge 插件的一键安装脚本(幂等)

核心能力

  • 四路分支决策:按「有无 URL」「静态或动态」「是否失败」自动判断该用 web_search、web_fetch、opencli 还是 browser
  • 搜索故障兜底:web_search 报错时不静默跳过,而是原样输出配置引导,协助用户完成 API Key 设置后再试
  • CLI 优先回退:web_fetch 遇到 403/空白页/CAPTCHA 时,先尝试 opencli 覆盖的 70+ 站点结构化接口,最后才启用浏览器
  • 浏览器规范操作:登录前必须获取用户确认,敏感操作二次确认,优先 CSS 选择器与智能等待,避免 sleep 硬等
  • 渐进式命令发现:opencli 支持 --help 层级下探,无需预先记忆各站点命令

应用场景

用户怎么说本技能做什么
"帮我搜一下最近 AI 的热点新闻"调用 web_search,对返回的 URL 按静态/动态判断选用 web_fetch 或 opencli 深入获取
"这个链接打不开,抓取失败"识别 403/CAPTCHA 等失败信号,先尝试 opencli 同站点接口,仍失败再升级到 browser 并告知用户原因
"搜索报错了,怎么办"读取 web-search-config.md,按 Step 1 原样输出 API 配置引导,等待用户反馈后再决定重试或降级
"我要登录微博查数据"从 well-known-sites.json 取登录页 URL,告知用户即将执行登录操作并等待确认,再用 browser 完成登录与后续抓取
"opencli 提示找不到命令"执行 setup-opencli.sh 完成 CLI 与浏览器插件的安装,然后继续原任务