Custom Grok Search

---

name: custom-grok-search description: 使用 xAI Grok 的 Responses API 进行网页搜索与 X/Twitter 搜索；支持官方 xAI 接口，也支持通过公益站或其他第三方 Grok 兼容代理来使用 web_search / x_search。

---

custom-grok-search

这个 Skill 用来调用 Grok 的服务端搜索工具：

web_search：网页搜索

x_search：X / Twitter 搜索

适用场景：

用户想搜索网页信息，但希望走 Grok / xAI 能力

用户想搜 X / Twitter 上的帖子、账号、讨论串

运行环境没有直接使用官方 xAI 接口，而是改走公益站或其他第三方 Grok 兼容代理

支持的两种模式

1. 官方 xAI 模式

如果环境里提供的是官方 xAI 凭证，脚本会直接请求官方接口。

适合：

你自己有官方 xAI Key

不需要第三方代理

2. 公益站 / 第三方代理模式

如果检测到 CUSTOM_GROK_APIKEY，脚本会自动切换到第三方 Grok 兼容代理模式。

适合：

通过公益站使用 Grok Search

使用自建或第三方兼容 OpenAI / xAI Responses API 的代理

需要自定义 base URL、模型名、User-Agent

如果你需要配置代理相关变量，请读取：

references/config.md

如果你需要官方文档入口，请读取：

references/xai-tools-links.md

运行方式

使用 {baseDir} 来引用 Skill 目录，避免因为工作目录不同导致路径失效。

搜索

网页搜索：

- node {baseDir}/scripts/grok_search.mjs "" --web

X / Twitter 搜索：

- node {baseDir}/scripts/grok_search.mjs "" --x

对话

文本对话：

- node {baseDir}/scripts/chat.mjs ""

图像对话：

- node {baseDir}/scripts/chat.mjs --image /path/to/image.jpg ""

其他

列出可用模型：

- node {baseDir}/scripts/models.mjs

运行轻量自检：

- node {baseDir}/scripts/selftest.mjs

常用参数

搜索脚本支持这些常用参数：

输出控制

--links-only：只输出引用链接

--text：输出精简文本，不展示 citations 段

--raw：把原始 Responses API 返回写到 stderr，便于排错

通用参数

--max ：限制结果数，默认 8

--model ：本次调用临时指定模型

X / Twitter 搜索过滤

--days ：限制最近 N 天

--from YYYY-MM-DD

--to YYYY-MM-DD

--handles @a,@b：只看这些账号

--exclude @bots,@spam：排除这些账号

输出格式

默认输出为便于 agent 消费的 JSON，大致结构如下：

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

使用建议

一般网页研究优先用 --web

查推文、帖子、线程时优先用 --x

如果你是通过公益站或第三方代理使用 Grok，先看 references/config.md 再调用脚本

如果模型偶发没有严格返回 JSON，脚本会尽量透传文本结果，而不是直接硬失败