grok-search：搜索网页内容或 X/Twitter 动态

名称： grok-search
描述： 通过 xAI Responses API，使用 xAI Grok 服务器端工具（web_search、x_search）进行网络或 X/Twitter 搜索。当你需要从 X 获取推文/主题/用户、希望将 Grok 作为 Brave 的替代品，或需要结构化 JSON 及引用时使用。
主页： https://docs.x.ai/docs/guides/tools/search-tools
触发器： ["grok", "xai", "search x", "search twitter", "find tweets", "x search", "twitter search", "web_search", "x_search"]
元数据： {"clawdbot":{"emoji":"🔎","requires":{"bins":["node"],"env":["XAI_API_KEY"]},"primaryEnv":"XAI_API_KEY"}}

通过捆绑的脚本（搜索 + 聊天 + 模型列表）在本地运行 xAI Grok。搜索的默认输出为格式美观的 JSON（适合智能体处理）并包含引用。

API 密钥

脚本按以下顺序查找 xAI API 密钥：
- XAI_API_KEY 环境变量
- ~/.clawdbot/clawdbot.json → env.XAI_API_KEY
- ~/.clawdbot/clawdbot.json → skills.entries["grok-search"].apiKey
- 备用：skills.entries["search-x"].apiKey 或 skills.entries.xai.apiKey

运行

使用 {baseDir} 确保命令在任何工作空间布局下都能正常工作。

搜索

• 网络搜索（JSON）：

• node {baseDir}/scripts/grok_search.mjs "<查询内容>" --web

• X/Twitter 搜索（JSON）：

• node {baseDir}/scripts/grok_search.mjs "<查询内容>" --x

聊天

• 聊天（文本）：

• node {baseDir}/scripts/chat.mjs "<提示词>"

• 聊天（视觉）：

• node {baseDir}/scripts/chat.mjs --image /路径/到/图片.jpg "<提示词>"

模型

• 列出模型：
• node {baseDir}/scripts/models.mjs

常用标志

输出控制：
- --links-only 仅打印引用 URL
- --text 在美化输出中隐藏引用部分
- --raw 在 stderr 中包含原始 Responses API 负载（用于调试）

通用选项：
- --max <n> 限制结果数量（默认 8）
- --model <id> 指定模型（默认 grok-4-1-fast）

X 专用筛选器（通过 x_search 工具参数在服务器端处理）：
- --days <n> 例如 --days 7
- --from YYYY-MM-DD / --to YYYY-MM-DD 日期范围
- --handles @a,@b 限制为指定账号
- --exclude @bots,@spam 排除指定账号

输出结构（JSON）

{
  "query": "...",
  "mode": "web" | "x",
  "results": [
    {
      "title": "...",
      "url": "...",
      "snippet": "...",
      "author": "...",
      "posted_at": "..."
    }
  ],
  "citations": ["https://..."]
}

注意事项

• citations 尽可能从 xAI 响应注解中合并/验证而来（比盲目信任模型的 JSON 更可靠）。
• 获取推文/主题时建议使用 --x，进行通用研究时建议使用 --web。