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 y

Join 0+ developers using this skill

skill

Search & Research

beginner

0 installs

View Source

Last updated: April 23, 2026

AI Skill Market Insights

Real data. Real impact.

Popularity

Rising

Emerging

Active Users

Developers

Quick Start

Manual Installation

No automatic installation available. Please visit the source repository for installation instructions.

View Installation Instructions

TEAR & SHARE

3-5hrs/WK

RISING

0.0K+ USING

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

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.

grok-search

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

Anysearch MCP Server

Be Part of the 0+ Developer Community

API key

Run

Search

Chat

Models

Useful flags

Output shape (JSON)

Notes

Bullshit Detector

arXiv MCP Server

Research Analyst

DuckDuckGo MCP Server

Channels

Learn

Compare

Company

Agents