pi-web-access
零配置起步的 Pi 联网套件:多引擎搜索回退、页面结构化抽取、PDF 与视频理解。
安装命令
pi install npm:pi-web-access 临时试用 / 替代安装命令
pi -e npm:pi-web-access 挂接事件钩子与注册入口
session_startbefore_agent_startagent_startagent_settledmodel_selecttool_callsession_treesession_shutdown
pi.registerTool()(注册搜索、抓页与视频工具)pi.registerCommand("websearch" / "search" / "curator" / "google-account")ctx.ui.setWidget()ctx.ui.select()ctx.ui.notify() 1. 是什么
pi-web-access 是 nicobailon 维护的 Pi 联网搜索与内容提取扩展。
除了作为 Pi 扩展(./dist)运行,它还附带 pi-web-access-mcp 可执行入口,可以当作独立 MCP Server 给其他宿主调用。
2. 解决什么问题
单一搜索 API 经常在特定站点返回空结果或遇到反爬拦截,把整张网页 HTML/Markdown 原封不动塞进对话又会浪费大量 token。
pi-web-access 把搜索回退链、浏览器模拟抓取、页内精确字段抽取、GitHub 仓库克隆、PDF 文本提取以及 YouTube/本地录屏理解整合为一套开箱即用的工具面。
3. 作用原理(事件钩子与工具注册层)
注册联网检索与多模态抓取工具,利用智能回退链调度不同检索/抽取后端,并在返回前做片段提取。
- 扩展在 session_start 与 model_select 时检查当前登录的模型凭证(例如 OpenAI ChatGPT 订阅或 Kimi Code Plan),决定默认可用的搜索通道。
- 当模型调用搜索工具时,扩展按优先级依次执行回退链:本地 SearXNG(若配置)→ 订阅态原生搜索或免 Key 的 Exa MCP → Brave / Tavily / Perplexity / Gemini 等已配置后端。
- 抓取网页时优先直连与模拟浏览器特征请求,被拒后再回退至配置好的 Firecrawl / Crawl4AI 等后端;对目标页面可按指定字段精确抽取值并附带行号,避免整页灌入上下文。
- 遇到 GitHub URL 时支持直接浅克隆分析,遇到 YouTube 或本地视频则提取字幕、时间戳关键帧与画面说明。
4. 怎么装与基本配置
- 直接安装后即可通过内置免 Key 的 Exa MCP 或无 Key 搜索引擎跑通基础搜索。
- 如已登录 Codex/ChatGPT 或 Kimi Code Plan(/login kimi-coding),可自动复用对应搜索通路;需要更高控制力时可填入 Brave、Tavily、Firecrawl 或自托管 SearXNG 地址。
- 通过 /curator 与 /google-account 等斜杠命令可调整精选源或绑定 Google 账号选项。
5. 和同类怎么选
相比单一搜索扩展,pi-web-access 功能覆盖面最全;若只需要模型自带的原生联网参数,可选更轻的 pi-web-search。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
pi-web-search | 只对接 Gemini / xAI / OpenAI / Anthropic / DeepSeek 等模型厂商原生搜索接口,不内置网页爬虫、PDF 或视频解析流水线。 | 只依赖当前模型原生搜索能力、追求极简依赖时选 pi-web-search。 |
webfox | 定位为独立 CLI + TypeScript 库 + Pi 扩展三合一工具,强调统一多 API 路由而非视频/仓库克隆整合。 | 同时要在外部 shell 脚本和 Pi 内部复用同一套 web API 路由配置时选 webfox。 |
看完「pi-web-access」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。