search-x
Medium · 75 Score: 75/100
by mvanhorn | Audited: 2026-02-05T09:47:58.400Z | Ruleset: 0.1.0
About This Skill
Search X/Twitter in real-time using Grok. Find tweets, trends, and discussions with citations.
✨ Model:
grok-4-1-fast (optimized for agentic search) ✨ Returns real tweets with URLs
✨ Supports date and handle filtering
✨ @username (display name)
✨ Direct link to tweet
✨
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) Use Cases
1 Research topics
2 Find information
3 Answer questions
Documentation (Original)
Source: README.md The following is the author's original documentation (often English). For installation, follow “Quick Install” above.
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
Security Audit
Medium · 75
Summary
Search X/Twitter in real-time using Grok. Find tweets, trends, and discussions with citations.
Risk Profile
Key Risks 0 items
No LLM risk bullets (LLM disabled or not cached).
Deterministic Findings (Evidence)
| Rule | Severity | File | Snippet |
|---|---|---|---|
| SENSITIVE_ENV | medium | skills/mvanhorn/search-x/scripts/search.js Line 13 | const DEFAULT_MODEL = process.env.SEARCH_X_MODEL || 'grok-4-1-fast'; |
| SENSITIVE_ENV | medium | skills/mvanhorn/search-x/scripts/search.js Line 14 | const DEFAULT_DAYS = parseInt(process.env.SEARCH_X_DAYS, 10) || 30; |
| SENSITIVE_ENV | medium | skills/mvanhorn/search-x/scripts/search.js Line 18 | if (process.env.XAI_API_KEY) { |
| SENSITIVE_ENV | medium | skills/mvanhorn/search-x/scripts/search.js Line 19 | return process.env.XAI_API_KEY; |
| SENSITIVE_ENV | medium | skills/mvanhorn/search-x/scripts/search.js Line 23 | const configPath = path.join(process.env.HOME, '.clawdbot', 'clawdbot.json'); |
| NET_HTTP_REQUEST | medium | skills/mvanhorn/search-x/scripts/search.js Line 167 | const req = https.request({ |
| QUALITY_README_PRESENT | low | README Line n/a | README detected |