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

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

Installation

skills install search-x

Or manually:

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

Setup

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

bot 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 Bot:

"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

1.9 KiB Raw Permalink Blame History