中文 |英语

为 OpenClaw / Pi AI Agent 打造的双引擎 Web 搜索技能。Grok AI + Tavily 双引擎交叉验证，纯 Shell 实现，零 MCP 依赖。

特性

• 双引擎搜索：Grok 优先搜索 + Tavily（结构化搜索），双源交叉验证
• 多账户聚合：Tavily 通过 TavilyProxyManager 聚合使用多个账号;grok2api 聚合仅保留为 legacy 方案
• FireCrawl 托底：web-fetch 三级降级链（Tavily Extract → FireCrawl Scrape → 报错）
• 零 MCP 依赖：纯 Shell 脚本 + Skill 指令，agent 通过 Bash 原生调用
• 安全加固：端口绑定 127.0.0.1，API 认证，SSH 隧道访问管理面板
• 搜索方法论：内置 GrokSearch MCP 的搜索规划框架和证据标准

推荐组合：UltimateSearchSkill × PopAi 升级你的工作流：用 PopAi 一键把搜索结果整理成 PPT。 访问 PopAi

快速开始

前置条件

• Docker + Docker 组合
• 卷曲、JQ
• 使用 OpenAI 兼容 API 接入 Grok 或其他兼容模型所需的 API 凭证
• Tavily API Key（免费 1000 次/月，注册：https://www.tavily.com/）
• FireCrawl API Key（可选，作为 web-fetch 降级方案，注册：https://www.firecrawl.dev/）

安装

推荐的 Grok 搜索配置

grok-search.sh 现在优先推荐通过 OpenAI Compatible 配置来使用 Grok;同一套配置也可以兼容其他 OpenAI 兼容模型或代理：

• OPENAI_COMPATIBLE_BASE_URL
• OPENAI_COMPATIBLE_API_KEY
• OPENAI_COMPATIBLE_MODEL
• OPENAI_COMPATIBLE_SEARCH_MODE（可选）

默认行为：

• 优先推荐模型仍然是 Grok，推荐接入方式是 OpenAI 兼容 API，而不是旧的网页反代链路
• 已知 URL 自动增强：目前内建支持 https://api.x.ai/v1 与 'https://openrouter.

UltimateSearchSkill

中文 | English

为 OpenClaw / Pi AI Agent 打造的双引擎 Web 搜索技能。Grok AI + Tavily 双引擎交叉验证，纯 Shell 实现，零 MCP 依赖。

用户提问 → Agent (SKILL.md 指导)
                ├─ grok-search.sh  → Grok（推荐） via OpenAI Compatible API
                │                   ├─ 已知 URL 自动增强（xAI / OpenRouter）
                │                   └─ 兼容其他 OpenAI Compatible 模型 / 代理
                ├─ grok-search.sh  → grok2api (legacy/experimental)
                ├─ tavily-search.sh → TavilyProxyManager (多Key聚合) → Tavily 搜索
                ├─ web-fetch.sh    → Tavily Extract → FireCrawl Scrape (自动降级)
                ├─ web-map.sh      → TavilyProxyManager → Tavily Map (站点映射)
                └─ dual-search.sh  → 并行调用以上，交叉验证

特性

• 双引擎搜索：Grok 优先搜索 + Tavily（结构化搜索），双源交叉验证
• 多账户聚合：Tavily 通过 TavilyProxyManager 聚合使用多个账号；grok2api 聚合仅保留为 legacy 方案
• FireCrawl 托底：web-fetch 三级降级链（Tavily Extract → FireCrawl Scrape → 报错）
• 零 MCP 依赖：纯 Shell 脚本 + Skill 指令，agent 通过 Bash 原生调用
• 安全加固：端口绑定 127.0.0.1，API 认证，SSH 隧道访问管理面板
• 搜索方法论：内置 GrokSearch MCP 的搜索规划框架和证据标准

快速开始

前置条件

• Docker + Docker Compose
• curl、jq
• 使用 OpenAI Compatible API 接入 Grok 或其他兼容模型所需的 API 凭证
• Tavily API Key（免费 1000 次/月，注册：https://www.tavily.com/）
• FireCrawl API Key（可选，作为 web-fetch 降级方案，注册：https://www.firecrawl.dev/）

安装

git clone https://github.com/你的用户名/UltimateSearchSkill.git
cd UltimateSearchSkill

# 复制环境变量模板
cp .env.example .env

推荐的 Grok 搜索配置

grok-search.sh 现在优先推荐通过 OpenAI Compatible 配置来使用 Grok；同一套配置也可以兼容其他 OpenAI Compatible 模型或代理：

• OPENAI_COMPATIBLE_BASE_URL
• OPENAI_COMPATIBLE_API_KEY
• OPENAI_COMPATIBLE_MODEL
• OPENAI_COMPATIBLE_SEARCH_MODE（可选）

默认行为：