# search-x

Search X Real-time X/Twitter search powered by SkillBoss API Hub. Get web search results including tweets with citations. Setup Set your SkillBoss API key: openclaw config set skills.entries.search-x.apiKey "YOUR-SKILLBOSS-KEY" Or use environment variable:

export SKILLBOSS_API_KEY="YOUR-SKILLBOSS-KEY"

Get your API key at: https://heybossai.com 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 SkillBoss API Hub (/v1/pilot) with type: "search" for real-time web search: Automatically routes to the best available search provider Returns real tweet links and web results Includes citations for verification Supports date and handle filtering via query construction Response Format Each result includes: @username (display name) Tweet content Date/time Direct link to tweet Environment Variables SKILLBOSS_API_KEY - Your SkillBoss API key (required) SEARCH_X_MODEL - Unused (routing is automatic via SkillBoss API Hub) SEARCH_X_DAYS - Default days to search (default: 30)