pi-anysearch

把 AnySearch（一个实时搜索服务）内置为 Pi 的原生工具。安装后，LLM 可直接调用搜索/提取/批量搜索等工具，无需再加载 skill 文档，也无需 shell 调用。

AnySearch 本质是一个 HTTP JSON-RPC 2.0 服务（https://api.anysearch.com/mcp）。本扩展将其封装成 4 个工具。

安装

# 从 npm
pi install npm:@wizardwu/pi-anysearch

# 或从 GitHub
pi install git:github.com/FreeWizardWu/pi-anysearch@v1

重启 Pi 后生效（扩展在会话启动时加载）。

提供的工具

工具	功能
asearch	实时网络搜索（通用 web + 垂直域）
aextract	抓取并提取网页完整正文（Markdown）
abatch	并行批量搜索多个独立查询
asub_domains	查询垂直搜索的子域及必填参数

使用

通用搜索

直接给 asearch 一个 query 即可。

垂直优先规则（重要）

对于属于或重叠任一垂直域的查询（finance / social_media / academic / legal / health / business / security / ip / code / energy / environment / agriculture / travel / film / gaming），工具会引导：

1. 先调 asub_domains 发现正确的 sub_domain 和必填参数；
2. 再带 domain / sub_domain / sub_domain_params 做 asearch。

垂直搜索的结果显著优于通用 web 搜索。纯百科类零域重叠的查询（罕见例外）才直接做通用搜索。不确定是否垂直时，用 abatch 做「1 条通用 + N 条垂直」的混合批量。

示例

asearch(query="什么是 RET 崩溃")                       # 通用
asearch(query="AAPL", domain="finance",
        sub_domain="finance.quote",
        sub_domain_params="type=stock,symbol=AAPL,cn_code=")  # 垂直（先用 asub_domains）
aextract(url="https://example.com/docs/page")        # 提取正文
abatch(queries=["量子计算", "QBTS 股价"])               # 并行批量

认证配置（安全）

本扩展不内置任何密钥，也不会读取任何硬编码的本地路径。密钥仅通过以下方式提供（推荐用环境变量）：

export ANYSEARCH_API_KEY=你的_key

或在当前工作目录的 .env 文件中写入：

ANYSEARCH_API_KEY=你的_key

未配置密钥时，自动回退到匿名访问（较低速率限制）。

获取免费 API Key：https://anysearch.com/console/api-keys

开发与安全

• 扩展在会话启动时自动加载，无需编译（.ts 源文件直接由 Pi 运行）。
• 该扩展会把你的查询、URL 及 API Key 发送到 https://api.anysearch.com。请勿用于含敏感信息（密码、个人数据、商业机密）的查询，除非你信任该服务商。
• 安装第三方 Pi 包前请审阅源码——扩展拥有完整系统权限。

许可

MIT