custom-grok-search

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

• - web_search：网页搜索
• INLINECODE1：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

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

• - INLINECODE3

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

• - INLINECODE4

运行方式

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

搜索

• - 网页搜索：

• - X / Twitter 搜索：

对话

• - 文本对话：

• - 图像对话：

其他

• - 列出可用模型：

• - 运行轻量自检：

常用参数

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

输出控制

• - --links-only：只输出引用链接
• INLINECODE13：输出精简文本，不展示 citations 段
• INLINECODE14：把原始 Responses API 返回写到 stderr，便于排错

通用参数

• - --max <n>：限制结果数，默认 8
• INLINECODE16：本次调用临时指定模型

X / Twitter 搜索过滤

• - --days <n>：限制最近 N 天
• INLINECODE18
• INLINECODE19
• INLINECODE20：只看这些账号
• INLINECODE21：排除这些账号

输出格式

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

CODEBLOCK0

使用建议

• - 一般网页研究优先用 INLINECODE22
• 查推文、帖子、线程时优先用 INLINECODE23
• 如果你是通过公益站或第三方代理使用 Grok，先看 references/config.md 再调用脚本
• 如果模型偶发没有严格返回 JSON，脚本会尽量透传文本结果，而不是直接硬失败