- 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_KEYenv var~/.clawdbot/clawdbot.json→env.XAI_API_KEY~/.clawdbot/clawdbot.json→skills.entries["grok-search"].apiKey- fallback:
skills.entries["search-x"].apiKeyorskills.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-onlyprint just citation URLs--texthide the citations section in pretty output--rawinclude the raw Responses API payload on stderr (debug)
Common:
--max <n>limit results (default 8)--model <id>(defaultgrok-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
citationsare merged/validated from xAI response annotations where possible (more reliable than trusting the model’s JSON blindly).- Prefer
--xfor tweets/threads,--webfor general research.