核心用法
grok-search 是通过 Node.js 脚本本地调用 xAI Grok API 的搜索技能，封装了 web_search 和 x_search 两个服务端工具。核心操作模式包括：
- Web搜索：
node scripts/grok_search.mjs "query" --web—— 通用网络信息检索 - X搜索：
node scripts/grok_search.mjs "query" --x—— 专门抓取 X/Twitter 推文、线程、用户数据 - 对话模式：
node scripts/chat.mjs "prompt"支持文本与视觉输入 - 模型管理：
node scripts/models.mjs列出可用模型
输出默认为格式化JSON，包含 results 数组与 citations 引用列表，便于 Agent 直接消费。支持 --links-only 提取纯链接、--raw 调试原始响应、--max 限制结果数等实用 flag。X搜索特有 --days、--from/to 时间窗、--handles 指定用户、--exclude 过滤垃圾账号等服务器端过滤参数。
显著优点
1. 结构化输出：相比 Brave 等工具，原生返回带 citations 的 JSON，减少解析成本
2. X生态深度整合：唯一支持服务端 X 搜索的工具，可获取实时推文与线程
3. 灵活的 API Key 降级策略：支持环境变量 → 全局配置 → 技能级配置的 4 层回退
4. 本地执行：Node.js 脚本在本地运行，非远程服务依赖
5. 视觉能力：chat 脚本支持图片输入，扩展多模态场景
潜在缺点与局限
- Node.js 依赖：必须预装 Node 运行时，环境门槛高于纯 CLI 工具
- API 成本：xAI API 按 token 计费，高频搜索可能产生显著费用
- 区域可用性：xAI 服务在部分地区受限
- 模型锁死：默认
grok-4-1-fast，虽可--model覆盖但选择有限 - 无缓存机制：每次调用都走实时 API，无本地结果缓存
适合人群
- 需要实时X数据的研究者、记者、舆情分析师
- 偏好JSON结构化输出的自动化工作流开发者
- 希望替代 Brave/Google 并获得 Grok 独特信源的用户
- 已有 xAI API 访问权限的企业/个人开发者
常规风险
| 风险类别 | 说明 |
|---------|------|
| API密钥泄露 | 多层配置回退机制虽便利，但分散存储增加泄露面，建议统一用 `XAI_API_KEY` 环境变量 |
| 成本失控 | 未设置用量上限，高频调用可能导致账单激增 |
| 数据新鲜度幻觉 | X搜索虽标实时，但索引延迟未明确保证 |
| 引用可靠性 | 虽有 citations 验证，但模型生成内容仍需人工复核关键信息 |
| 合规风险 | X数据抓取需遵守平台 ToS 与各地数据法规 |