用途:通过 Brave Search 进行无头网页搜索和内容提取,适合查找文档、API 参考、事实或当前信息,以及抓取指定 URL 的正文,无需交互式浏览器。
主要能力:search.js 支持基础搜索(默认 5 条结果)、用 -n 指定结果数量、用 --content 附带页面正文(Markdown 格式),两者可组合;content.js 可抓取单个 URL 并提取可读内容为 Markdown。输出按结果分块,包含标题、链接、摘要,使用 --content 时附加正文。
使用方式:首次使用前在技能目录执行一次安装:cd "${CODEX_HOME:-~/.codex}/skills/brave-search" 然后 npm ci。需要环境变量 BRAVE_API_KEY(优先)或 BRAVE_AI_API_KEY(备用)。脚本先尝试 BRAVE_API_KEY,缺失或限流时改用 BRAVE_AI_API_KEY;两者都失败则回退到 HTML 抓取。常用命令:./search.js "query"、./search.js "query" -n 10、./search.js "query" --content、./search.js "query" -n 3 --content、./content.js https://example.com/article。
适用场景:搜索文档或 API 参考、查询事实或最新信息、获取指定 URL 内容,以及任何需要网页搜索但不想交互式浏览的任务。
限制:依赖 Brave Search API 密钥,密钥缺失或限流时可能回退到 HTML 抓取;具体配额、收费与效果资料暂未提供。该技能复制自 steipete/agent-scripts,上游地址 https://github.com/steipete/agent-scripts,许可证为 MIT。