不用浏览器也能搜网页pi-skills的brave-search搜索与网页内容提取实战指南【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills想让 AI 编程助手查资料、读文档却不想启动一个笨重的浏览器pi-skills 项目中的brave-search技能就是为了解决这个问题它通过 Brave Search API 实现无浏览器网页搜索和网页内容提取把网页正文直接转成干净的 Markdown轻量、快速、适合 AI Agent 调用。本文带你从零配置到实战使用5 分钟上手。什么是 pi-skills brave-searchpi-skills是为 pi coding agent 编写的一组实用技能Skills同时兼容 Claude Code、Codex CLI 等主流 AI 编程工具。它的每个技能都是一个独立目录核心是一份 SKILL.md 说明文件加若干脚本。brave-search技能提供两个核心能力网页搜索调用 Brave 官方搜索 API返回标题、链接、摘要可加过滤条件内容提取抓取网页正文用 Mozilla Readability 算法提取可读内容再转成 Markdown 交给 AI 处理它不需要 Chrome、不需要登录、不需要图形界面一条命令就能把搜索结果变成 AI 能直接阅读的文本。为什么不用浏览器方案pi-skills 里其实还有一个 browser-tools 技能通过 Chrome DevTools 协议驱动真实浏览器。但它的启动成本高要拉起一个带远程调试端口的 Chrome 实例。对于查文档、搜事实、抓网页正文这类任务brave-search 是更轻量更快的选择——正如技能文档里写的适用场景见 brave-search/SKILL.md搜索文档或 API 参考查询事实或最新资讯抓取指定 URL 的正文一切不需要交互式浏览的搜索任务三步完成安装配置第 1 步获取技能先克隆 pi-skills 仓库Claude Code 用户建议把单个技能软链到~/.claude/skills/详见 README.md 的说明git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/pi-skills第 2 步安装依赖只需一次cd ~/pi-skills/brave-search npm install依赖很轻核心是 brave-search/package.json 中列出的mozilla/readability正文提取、jsdomHTML 解析和turndownHTML 转 Markdown几个库。第 3 步配置 BRAVE_API_KEY到 Brave Search 官方 API 控制台注册账号创建Free AI免费订阅并生成 API Key注意官方要求注册时填写信用卡但免费订阅不会产生扣费。然后把 Key 写入 shell 配置文件export BRAVE_API_KEY你的API密钥配好后运行一次search.js报BRAVE_API_KEY environment variable is required就说明还没生效重新打开终端即可。网页搜索实战常用命令速查搜索入口是 brave-search/search.js日常最常用的就是下面几条场景命令基础搜索默认 5 条search.js query返回更多结果最多 20 条search.js query -n 10搜索正文一起抓search.js query --content只要最近一周的结果search.js query --freshness pw指定国家/地区search.js query --country DE 几个实用细节--freshness支持pd24小时、pw周、pm月、py年也支持2024-01-01to2024-06-30这种自定义日期区间追热点、查时效性内容特别好用--content会额外抓取每条结果页面的正文Markdown 格式截断至 5000 字符以内一条命令完成搜读输出格式固定为Title / Link / Age / Snippet / Content分块见 SKILL.md方便 AI 逐条解析网页内容提取实战任意网页变 Markdown已经知道目标网页地址时直接用 brave-search/content.js 一步到位content.js https://example.com/article它会做三件事抓取网页 HTML用 Readability 算法剥离导航栏、广告等噪音只留正文转成带标题的 Markdown 输出提取失败时还会自动降级去掉script/nav/footer等标签后从main、article区域提取纯文本作为兜底鲁棒性不错。典型工作流是这样的search.js 某框架 官方文档 --freshness pm → 找到最新文档地址 content.js 文档地址 → 正文转 Markdown 喂给 AIAI 拿到的是干净的结构化文本而不是几千行 HTML理解效率和 token 利用率都更高。让 AI Agent 自动调用它作为 pi/Claude Code 技能Agent 会直接读取 brave-search/SKILL.md 里的使用说明文档中的{baseDir}占位符在运行时自动替换为技能目录路径——所以 Agent 不需要你额外教它就能自己拼出完整命令去搜索和提取内容。你在对话里直接说帮我查一下 XXX 的最新用法Agent 就会调用search.js检索再用--content或content.js读取正文后总结给你。整个过程中全程无需打开任何浏览器。常见问题Q搜索报错 HTTP 401 / 403检查BRAVE_API_KEY是否已导出、是否拼写完整确认订阅类型是 Free AI 以上档位。Q结果太少或地区不对加上-n 10扩大数量或用--country指定国家代码默认 US。Q--content太慢正文抓取是逐条请求网页的结果越多越慢建议配合-n 3左右控制数量或先搜链接再用content.js精准抓取。Q和 browser-tools 怎么选静态搜索、抓正文选 brave-search需要点击、填表、看页面截图等交互操作才用 browser-tools。总结pi-skills 的 brave-search 用最小的成本给了 AI 编程助手一双看网页的眼睛一个免费 API Key、一条npm install即可获得无浏览器网页搜索和网页内容转 Markdown两项能力。把它装进你的 Agent 工具箱让查资料这件事交给命令把精力留给写代码吧。【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考