xAI Search (Grok API)

Name: xai-search
Rating: 78
Author: moltbot

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/

Environment

Set XAI_API_KEY in your environment.

Quick Usage (curl)

Web Search

bash

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

bash

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 '.choices[0].message.content'

Combined (Web + X)

bash

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"}},
      {"type": "function", "function": {"name": "x_search"}}
    ]
  }' | jq -r '.choices[0].message.content'

Helper Script

For convenience, use the xai-search script in this skill folder:

bash

# Web search
xai-search web "latest news about AI"

# X/Twitter search  
xai-search x "what are people saying about Clawdbot"

# Both
xai-search both "current events today"

Models

•grok-3-fast — fast, good for quick searches
•grok-4-1-fast — reasoning model, better for complex queries

X Search Filters

You can filter X searches by:

•allowed_x_handles / excluded_x_handles — limit to specific accounts
•from_date / to_date — date range (ISO8601 format)
•enable_image_understanding — analyze images in posts
•enable_video_understanding — analyze videos in posts

Web Search Filters

•allowed_domains / excluded_domains — limit to specific sites
•enable_image_understanding — analyze images on pages

Tips

•For breaking news: use X search
•For factual/research queries: use web search or both
•For sentiment/opinions: use X search
•The model will make multiple search calls if needed (agentic)