xai-search

name	xai-search
description	Search X/Twitter and the web in real-time using xAI's Grok API with agentic search tools.
metadata	{"clawdbot":{"emoji":"🔍"}}

xAI Search (Grok API)

Use xAI's agentic search to query X/Twitter and the web in real-time. This leverages Grok's web_search and x_search tools.

Docs: https://docs.x.ai/docs/

Requirements

• XAI_API_KEY environment variable
• Python 3 + xai-sdk: pip install xai-sdk

Quick Usage (curl)

Web Search

curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3-fast",
    "messages": [{"role": "user", "content": "YOUR QUERY HERE"}],
    "tools": [{"type": "function", "function": {"name": "web_search"}}]
  }' | jq -r '.choices[0].message.content'

X/Twitter Search

curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3-fast",
    "messages": [{"role": "user", "content": "YOUR QUERY HERE"}],
    "tools": [{"type": "function", "function": {"name": "x_search"}}]
  }' | jq -r