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) ```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.