pi-grok-search

English | 简体中文

通过 Grok API + Tavily + Firecrawl 为 pi 提供完整的网络访问能力。

参考: GrokSearch MCP

双引擎架构

pi ──Extension──► pi-grok-search
                    ├─ grok_search     ───► Grok API（AI 深度搜索）
                    ├─ grok_sources    ───► 信源缓存（按 session_id）
                    ├─ web_fetch       ───► Tavily Extract → Firecrawl Scrape（自动降级）
                    ├─ web_map         ───► Tavily Map（站点映射）
                    └─ search_planning ──► 6 阶段结构化搜索规划

功能特性

• 🔍 AI 深度搜索 — Grok 驱动，自动时间注入，支持平台聚焦
• 📄 网页抓取 — Tavily Extract → Firecrawl Scrape 自动降级
• 🗺️ 站点映射 — Tavily Map 遍历网站结构
• 📋 搜索规划 — 6 阶段结构化规划
• 💾 信源缓存 — session_id 索引，按需获取
• 🔄 智能重试 — Retry-After 头解析 + 指数退避
• ⚙️ 交互式配置 — CLI 菜单配置 Grok/Tavily/Firecrawl API
• 🔍 连接诊断 — 一键测试所有 API 连通性

安装

方式一：pi install（推荐）

# 从 GitHub 安装
pi install git:github.com/justhiL/pi-grok-search

# 或指定版本
pi install git:github.com/justhiL/pi-grok-search@v2.0.0

方式二：手动安装

# 全局
git clone https://github.com/justhiL/pi-grok-search.git ~/.pi/agent/extensions/pi-grok-search/

# 项目本地
git clone https://github.com/justhiL/pi-grok-search.git .pi/extensions/pi-grok-search/

方式三：测试运行

pi -e git:github.com/justhiL/pi-grok-search

配置

安装后在 pi 中运行 /grok-config 进入交互式配置菜单，或直接设置环境变量：

环境变量

# Grok（必填）
export GROK_API_URL="https://api.x.ai/v1"
export GROK_API_KEY="xai-your-key"
export GROK_MODEL="grok-4-fast"        # 可选

# Tavily（可选，提供 web_fetch / web_map）
export TAVILY_API_KEY="tvly-your-key"

# Firecrawl（可选，Tavily 失败时托底）
export FIRECRAWL_API_KEY="fc-your-key"

交互式配置

在 pi 中输入：

/grok-config

支持：查看配置、设置 Grok/Tavily/Firecrawl API、切换模型、测试连接。

配置文件

持久化到 ~/.config/pi-grok-search/config.json：

{
  "apiUrl": "https://api.x.ai/v1",
  "apiKey": "xai-your-key",
  "model": "grok-4-fast",
  "tavilyApiKey": "tvly-your-key",
  "firecrawlApiKey": "fc-your-key"
}

使用

命令

命令	说明
/grok-search <query>	搜索网络信息
/grok-config	交互式配置管理
/grok-model [model-id]	切换 Grok 模型
/pi-ext-docs [topic]	搜索 pi Extension 开发文档

工具（LLM 自动调用）

工具	说明
grok_search	AI 深度搜索，返回结果 + session_id
grok_sources	通过 session_id 获取信源列表
web_fetch	抓取网页内容（Tavily → Firecrawl 自动降级）
web_map	遍历网站结构，生成站点地图
grok_config	查看/修改/测试配置
search_planning	6 阶段结构化搜索规划

安装后 LLM 会自动识别这些工具，根据用户问题自主决定调用。

信源质量准则

本扩展内置了严格的搜索行为规范（通过 promptGuidelines 注入系统提示）：

• 搜索用英文，输出用中文
• 即使有内部知识也必须搜索验证
• 关键事实需 ≥2 个独立来源支持
• 冲突来源需呈现双方证据
• 不确定时先说明局限性

相关链接

• linux do
• 本项目 GitHub
• pi 官方文档
• pi Extension 文档
• Grok API
• Tavily API
• Firecrawl API
• GrokSearch MCP 参考

License

MIT