@liuchen64/pi-web-tools

Pi 扩展 - Web 搜索/抓取工具

Packages

Package details

extension

Install @liuchen64/pi-web-tools from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@liuchen64/pi-web-tools
Package
@liuchen64/pi-web-tools
Version
0.3.0
Published
Nov 6, 2026
Downloads
242/mo · 176/wk
Author
liuchen64
License
MIT
Types
extension
Size
47.2 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@liuchen64/pi-web-tools

Pi 扩展 - Web 搜索/抓取工具，支持 Exa / DeepSeek 搜索提供商。

功能

  • web_search - 注册搜索工具，让 AI 模型可以搜索网络获取最新信息
  • web_fetch - 注册抓取工具，让 AI 模型可以获取指定 URL 的内容
  • 支持 Exa、DeepSeek 搜索 API
  • 通过 /web-search 命令配置文件保存 API key

安装

pi install npm:@liuchen64/pi-web-tools

配置

使用 /web-search 命令

在 Pi 中运行：

/web-search

然后按提示选择 Provider（Exa / DeepSeek）并输入 API Key。

查看当前配置：

/web-search --show

API Key 获取地址：Exa 见 exa.ai，DeepSeek 见 platform.deepseek.com （与 DeepSeek 模型 API 同一个 Key）。同一 Provider 的 Key 可以复用，切换 Provider 后可随时切回。

在 Pi 中使用

重启 Pi 后，AI 模型可以使用以下工具：

搜索网络：

web_search("最新的 JavaScript 框架")

获取网页内容：

web_fetch("https://example.com")

开发

# 安装依赖
pnpm install

# 运行测试
pnpm test

# 类型检查
pnpm check

架构

src/
├── index.ts              # 扩展入口，注册工具
├── types.ts              # 共享类型定义
├── config.ts             # 配置文件读写与 Provider 解析
├── search/               # 搜索模块
│   ├── index.ts          # 搜索模块入口
│   ├── tool.ts           # web_search 工具注册
│   ├── command.ts        # /web-search 配置命令
│   ├── factory.ts        # Provider 工厂（按配置创建实例）
│   └── providers/        # 各提供商独立目录（index.ts + index.test.ts）
│       ├── exa/          # Exa 搜索提供商
│       └── deepseek/     # DeepSeek 搜索提供商
└── fetch/                # 抓取模块
    ├── index.ts          # 抓取模块入口
    ├── tool.ts           # web_fetch 工具注册
    └── *.ts              # 请求、正文提取、截断、URL 安全校验

许可证

MIT