grok_search (xAI Grok Live Search)

When to use

• Real-time/current-event lookup where you need fresh sources (X + web + news) and citations.
• Social sentiment / “what are people saying on X” for a market or entity.

Don’t use

• When free sources suffice (try gdelt_news first for background headlines).
• When you don’t need citations and want zero cost.

Cost + keys

• Paid. Cost scales mainly with maxResults (~$0.025/source per src/agents/grok.ts).
• Requires XAI_API_KEY or GROK_API_KEY in env.

Parameters