How do I install the Grok Search skill?

Run npx skillmds@latest add modbender/grok-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Grok Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grok Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grok Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Grok Search?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grok Search by modbender — Agent Skill

Name: Grok Search
Rating: 4.2 (5 reviews)
Author: modbender

Grok Search

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.

modbender Updated Sep 9, 2026 12 repo stars

File contents

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.

---name: grok-searchdescription: 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.--- 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.

Frequently asked questions