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。

同方向对比包与顺序阅读

@onkernel/browser-loop

Kernel 官方浏览器工具框架与 Pi 扩展,按模型能力编译 GUI 动作并在云端浏览器执行。

阅读该包机制详评

pi-mcp-adapter

用按需激活和结果裁剪接入外部 MCP 服务,避免工具定义撑爆上下文。

阅读该包机制详评

01 接外部世界

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「pi-web-access」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)