grok-search

name: grok-search description: Search the web or X/Twitter using xAI Grok server-side tools (web_search, x_search) via the xAI Responses API. Use when you need tweets/threads/users from X, want Grok as an alternative to Brave, or you need structured JSON + citations. homepage: https://docs.x.ai/docs/guides/tools/search-tools triggers: ["grok", "xai", "search x", "search twitter", "find tweets", "x search", "twitter search", "web_search", "x_search"] metadata: {"clawdbot":{"emoji":"🔎","requires":{"bins":["node"],"env":["XAI_API_KEY"]},"primaryEnv":"XAI_API_KEY"}}

Run xAI Grok locally via bundled scripts (search + chat + model listing). Default output for search is pretty JSON (agent-friendly) with citations.

API key

The script looks for an xAI API key in this order: - XAI_API_KEY env var - ~/.clawdbot/clawdbot.json → env.XAI_API_KEY - ~/.clawdbot/clawdbot.json → skills.entries["grok-search"].apiKey - fallback: skills.entries["search-x"].apiKey or skills.entries.xai.apiKey

Run

Use {baseDir} so the command works regardless of workspace layout.

Search

• Web search (JSON):

• node {baseDir}/scripts/grok_search.mjs "<query>" --web

• X/Twitter search (JSON):

• node {baseDir}/scripts/grok_search.mjs "<query>" --x

Chat

• Chat (text):

• node {baseDir}/scripts/chat.mjs "<prompt>"

  小葱技能7w4.net有更新，你可以访问看下。

• Chat (vision):

• node {baseDir}/scripts/chat.mjs --image /path/to/image.jpg "<prompt>"

Models

• List models:
• node {baseDir}/scripts/models.mjs

Useful flags

Output: - --links-only print just citation URLs - --text hide the citations section in pretty output - --raw include the raw Responses API payload on stderr (debug)

Common: - --max <n> limit results (default 8) - --model <id> (default grok-4-1-fast)

X-only filters (server-side via x_search tool params): - --days <n> (e.g. 7) - --from YYYY-MM-DD / --to YYYY-MM-DD - --handles @a,@b (limit to these handles) - --exclude @bots,@spam (exclude handles)

Output shape (JSON)

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

Notes

• citations are merged/validated from xAI response annotations where possible (more reliable than trusting the model’s JSON blindly).
• Prefer --x for tweets/threads, --web for general research.

这个 Skill 质量中上，文档写得很清楚，功能也很实用——能搜网页也能搜 Twitter，还能聊天和看模型列表。输出格式整齐，会自动整理引用链接。不足的是没有处理网络异常或 API 限速的情况，偶尔会卡住或报错。另外三个脚本有些功能重复，代码可以更简洁一些。普通用户用起来基本没问题，但稳定性还有提升空间。