search-x – OpenClaw Skill

---

name: search-x description: Search X/Twitter in real-time using Grok. Find tweets, trends, and discussions with citations. homepage: https://docs.x.ai triggers:

• search x
• search twitter
• find tweets
• what's on x about
• x search
• twitter search metadata: clawdbot: emoji: "🔍"

---

Search X

Real-time X/Twitter search powered by Grok's x_search tool. Get actual tweets with citations.

Setup

Set your xAI API key:

clawdbot config set skills.entries.search-x.apiKey "xai-YOUR-KEY"

Or use environment variable:

export XAI_API_KEY="xai-YOUR-KEY"

Get your API key at: https://console.x.ai

Commands

Basic Search

node {baseDir}/scripts/search.js "AI video editing"

Filter by Time

node {baseDir}/scripts/search.js --days 7 "breaking news"
node {baseDir}/scripts/search.js --days 1 "trending today"

Filter by Handles

node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements"
node {baseDir}/scripts/search.js --exclude @bots "real discussions"

Output Options

node {baseDir}/scripts/search.js --json "topic"        # Full JSON response
node {baseDir}/scripts/search.js --compact "topic"     # Just tweets, no fluff
node {baseDir}/scripts/search.js --links-only "topic"  # Just X links

Example Usage in Chat

User: "Search X for what people are saying about Claude Code" Action: Run search with query "Claude Code"

User: "Find tweets from @remotion_dev in the last week" Action: Run search with --handles @remotion_dev --days 7

User: "What's trending about AI on Twitter today?" Action: Run search with --days 1 "AI trending"

User: "Search X for Remotion best practices, last 30 days" Action: Run search with --days 30 "Remotion best practices"

How It Works

Uses xAI's Responses API (/v1/responses) with the x_search tool:

• Model: grok-4-1-fast (optimized for agentic search)
• Returns real tweets with URLs
• Includes citations for verification
• Supports date and handle filtering

Response Format

Each result includes:

• @username (display name)
• Tweet content
• Date/time
• Direct link to tweet

Environment Variables

• XAI_API_KEY - Your xAI API key (required)
• SEARCH_X_MODEL - Model override (default: grok-4-1-fast)
• SEARCH_X_DAYS - Default days to search (default: 30)

Search X — Real-time Twitter/X Search for Clawdbot

Search X/Twitter in real-time using Grok's x_search tool. Get actual tweets with citations.

Installation

clawdhub install search-x

Or manually:

cd ~/clawd/skills && git clone https://github.com/mvanhorn/clawdbot-skill-search-x search-x

Setup

Get your API key from console.x.ai, then:

clawdbot config set skills.entries.search-x.apiKey "xai-YOUR-KEY"

Or set environment variable:

export XAI_API_KEY="xai-YOUR-KEY"

Usage

Basic Search

node scripts/search.js "AI video editing"

Time Filter

node scripts/search.js --days 7 "breaking news"    # Last 7 days
node scripts/search.js --days 1 "trending today"   # Last 24 hours

Handle Filters

node scripts/search.js --handles @elonmusk,@OpenAI "AI"
node scripts/search.js --exclude @bots "real discussions"

Output Formats

node scripts/search.js --compact "topic"      # Just tweets
node scripts/search.js --links-only "topic"   # Just URLs
node scripts/search.js --json "topic"         # Full JSON

Chat Examples

Just tell your Clawdbot:

• "Search X for what people are saying about Claude"
• "Find tweets about Remotion in the last week"
• "What's trending on Twitter about AI today?"

How It Works

Uses xAI's Responses API with the x_search tool:

• Endpoint: /v1/responses
• Model: grok-4-1-fast (optimized for search)
• Features: Date filtering, handle filtering, real citations

Output Example

🔍 Searching X: "Remotion Claude Code" (last 30 days)...

**@rknkhanna** (Rahul K)
"made a launch video using remotion. the remotion team published a skill
that teaches claude their best practices. fed it my design system.
described 6 scenes. got working animation code."
https://x.com/rknkhanna/status/2014504411981295928

📎 Citations (5):
   https://x.com/i/status/2014504411981295928
   ...

License

MIT