lev-os Grok Research
Use Grok (xAI) for real-time research when:
- Brave search is down or rate-limited
- You need X/Twitter search
- Current events or real-time data
- Social sentiment analysis
Quick Usage
# Via curl (env: XAI_API_KEY)
curl -s https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-3",
"messages": [{"role": "user", "content": "What are people saying about X topic on Twitter right now?"}]
}' | jq -r '.choices[0].message.content'
Models
| Model | Use Case | Speed |
|---|---|---|
grok-3 |
Deep research, complex queries | Slower |
grok-3-mini |
Quick lookups, simple facts | Fast |
When to Use vs Brave
| Scenario | Use |
|---|---|
| Documentation lookup | Brave |
| API references | Brave |
| Current events | Grok |
| Twitter/X sentiment | Grok |
| Real-time data | Grok |
| Brave 429/down | Grok |
Script
For complex research, use the helper:
~/.claude/skills/grok-research/scripts/grok-search.sh "your query"
Integration
The skill exposes:
grok_search(query)- Returns research resultsgrok_sentiment(topic)- Returns X/Twitter sentimentgrok_facts(question)- Quick fact lookup
API Handoff Pattern (Fabric-style)
{
"command": "research",
"query": "...",
"callback": "https://...",
"runId": "uuid"
}
Returns:
{
"runId": "uuid",
"status": "ok",
"output": "...",
"sources": ["x.com/...", "..."]
}
Related Search Tools
grok-research specializes in real-time X/Twitter and current events. For other needs:
| Tool | Specialty | Use When |
|---|---|---|
| grok-research (this) | Real-time X/Twitter, current events | Social sentiment, trending topics, breaking news |
| valyu | Recursive turn-based research | valyu research "query" --turns 5 |
| deep-research | Multi-query Tavily synthesis | deep-research "query" --deep |
| lev-research | Multi-perspective orchestration | lev-research "query" |
| lev-find | Unified local + external | lev find "query" --scope=research |
| brave-search | Quick web search | brave-search "query" |
| tavily-search | AI-optimized snippets | tavily-search "query" |
| exa-plus | Neural search, LinkedIn, papers | exa search "query" |
| firecrawl | Web scraping | firecrawl scrape <url> |
| qmd | Local session search | qmd query "query" |
Grok's unique capabilities:
- ✅ Real-time X/Twitter search
- ✅ Social sentiment analysis
- ✅ Current events (fresher than other tools)
- ✅ Breaking news
- ✅ Fallback when Brave is down/rate-limited
- ❌ Academic research (use exa-plus)
- ❌ Documentation (use brave-search)
- ❌ Multi-query synthesis (use deep-research)
Integration pattern:
# 1. Check social sentiment with Grok
grok-research "what are people saying about X on Twitter"
# 2. Deep dive with other tools
valyu research "X trends and analysis" --turns 5
See skill://lev-research for comprehensive research workflows.