grok-search

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>"

• -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.