mvanhorn 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)