搜索与研究
Grok Search
A lightweight Node.js agent skill package providing Grok-powered web search, fetch, and site mapping via CLI scripts with SKILL.md integration for agent runtimes.
BlueOcean223 · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add BlueOcean223/grok-search技能说明
grok-search
简体中文 | English
grok-search 是一个通用 AI agent skill / 脚本包,用轻量 Node.js 脚本提供三类网络访问能力:
- Search:通过 Responses API 调用 Grok / OpenRouter / Responses-compatible 接口,并行返回 Tavily / Firecrawl 独立信源。
- Fetch:抓取指定 URL 的可读内容,优先使用 Tavily / Firecrawl,最后 fallback 到无 key 的 Direct Fetch。
- Map:发现站点内的候选页面 URL,优先使用 Tavily Map,最后 fallback 到轻量 Direct Map。
要求
- Node.js
>=18.17 - 需要先运行一次
npm install安装undici传输依赖 search.js需要配置GROK_API_URL和GROK_API_KEY
快速开始
先安装依赖一次,然后从项目根目录运行脚本:
npm install
./scripts/search.js "latest Node.js LTS"
./scripts/fetch.js https://example.com
./scripts/map.js https://docs.example.com --limit 20
在 pi 中使用(示例)
把本目录 clone 或复制到你的 pi skills 位置,然后通过 SKILL.md 启用这个 skill。
示例命令仍然是直接运行脚本:
./scripts/search.js "latest Node.js LTS"
./scripts/fetch.js https://example.com
./scripts/map.js https://docs.example.com --limit 20
其他 agent harness 也可以采用同样方式:读取 SKILL.md,再按需运行 scripts/search.js、scripts/fetch.js、scripts/map.js。
文档
- 架构说明
- 功能说明
- Responses 搜索协议
- Smoke Tests
- 公开 Benchmark
- 评测方法研究
配置
推荐把长期使用的 key 放到:
~/.config/grok-search/config.json
可以从示例文件复制:
mkdir -p ~/.config/grok-search
cp config.example.json ~/.config/grok-search/config.json
chmod 600 ~/.config/grok-search/config.json
完整配置示例:
{
"apiUrl": "https://api.x.ai/v1",
"apiKey": "your-grok-api-key",
"apiProvider": "xai",
"model": "grok-4.3",
"responsesMaxTurns": 3,
"responsesReasoningEffort": "low",
"responsesAllowedDomains": [],
"responsesExcludedDomains": [],
"responsesIncludeXSearch": false,
"responsesAllowedXHandles": [],
"responsesExcludedXHandles": [],
"responsesOpenRouterEngine": "auto",
"defaultExtra": 6,
"sourceChars": 400,
"tavilyApiKey": "",
"tavilyApiUrl": "https://ap