@arcadia64/pi-ddgs

本地Docker驱动的无API限制网页搜索与抓取工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@arcadia64/pi-ddgs。
它的用途是:本地Docker驱动的无API限制网页搜索与抓取工具
完整的 Skill 内容见:https://321skill.com/skills/arcadia64-pi-ddgs/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'搜索最新的AI Agent发展趋势,并抓取前三条结果页面的正文内容',它会先调用web_search获取搜索结果,再对每个结果调用fetch_url抓取页面,最终返回结构化摘要。

介绍

这个Skill解决了AI编码代理无法高效、稳定地获取实时网页内容的问题。在实际开发中,开发者经常需要让AI助手搜索最新文档、抓取竞品页面或分析网络信息,但公共API有速率限制、需要付费密钥,且容易被反爬机制拦截。

使用方式很简单,你只需要在本地运行Docker后端(docker compose up -d —build),然后通过Pi安装该扩展即可。之后就可以通过自然语言指令来执行网页搜索、新闻搜索、获取搜索结果列表以及抓取任意URL的内容。系统会自动选择最优的抓取策略:先尝试快速静态HTTP客户端,失败则切换至无头Chrome,最后使用Camoufox(Firefox改版)绕过更复杂的反爬检测。

它非常适合需要频繁进行网络调研的AI编码助手用户,特别是那些已经使用Pi作为编程代理的开发者。无论是技术调研、竞品分析、数据采集还是文档抓取,这个工具都能在本地零成本运行,无需担心API密钥泄露或外部服务中断。

建议在首次使用前预留5-10分钟构建Docker镜像(约3GB),并确保机器有足够内存(建议2GB以上)。需要注意的是,它主要针对静态页面和常规反爬设计,无法处理Cloudflare Turnstile等交互式挑战,且不适用于需要登录认证的页面。

常见问题

如何配置后端地址?

默认后端地址为http://localhost:8091,可通过~/.pi/ddgs.json中的ddgsApiUrl字段修改,支持远程部署。

抓取超时如何调整?

在配置文件中设置fetchTimeoutMs(静态抓取超时,默认20000ms),渲染路径会乘以3(Chrome)或5(Camoufox)。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/arcadia64-pi-ddgs/raw/index.md 读取 @arcadia64/pi-ddgs 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。