aydencook03

xAI Search

Knowledgev1.0.4
By aydencook03Updated 2026-05-115 versions · latest released 2026-01-28xai-search@clawhub_aydencook03/xai-search
Knowledge Base Q&AInformation Retrieval#Agentic#Twitter

According to AlphaMoat, as of 2026-09, xAI Search has 3,866 downloads and 1 stars — ranked #2,693 of 5,078 AI skills overall, and #246 of 442 in Knowledge.

Installs
240
Downloads
3.9K
Stars
1
Overall Rank
#2,693
Top 54% overall · Top 56% in Knowledge
PlatformInstallsDownloadsStarsComments
ClawHub ↗1283.7K1-
SkillHub ↗2403.9K1—

Platforms count differently and update at different times.

What this skill does

This skill searches X/Twitter and the web in real time through xAI's Grok API, leveraging the web_search and x_search agentic tools on models like grok-3-fast. Calls can be made via curl or the scripts/xai-search.py helper; X searches support handle, date-range, and image/video-understanding filters, web searches support domain filters. Use X search for breaking news and sentiment, web search (or both) for factual and research queries.

Profile published 2026-10-27

What you can do with it

  • Use x_search for real-time sentiment and discussion on X about any topic
  • Use web_search for factual or research queries, optionally restricted by allowed_domains
  • Limit or exclude specific accounts with allowed_x_handles/excluded_x_handles
  • Enable enable_image_understanding/enable_video_understanding to analyze post media
  • Switch to the grok-4-1-fast reasoning model for complex queries

When to use it

  • When real-time information, breaking news, or X sentiment is needed — prefer X search
  • When factual, research-style answers are needed — use web search or both
  • When XAI_API_KEY is configured and the xai-sdk package is installed

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Use x_search to find what people on X are saying about AI agents right now
Search the web for the latest news, restricting allowed_domains to major tech outlets
Route this research query to grok-4-1-fast with both web_search and x_search enabled

Monthly Trend

Downloads3.9K
2.9K3.4K3.9K2026-03 · Downloads 3.0K2026-05 · Downloads 3.3K2026-06 · Downloads 3.4K2026-07 · Downloads 3.6K2026-08 · Downloads 3.6K2026-09 · Downloads 3.9K26-0326-09
Stars1
0122026-03 · Stars 12026-05 · Stars 12026-06 · Stars 12026-07 · Stars 12026-08 · Stars 12026-09 · Stars 126-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.9K—1
2026-083.6K+1.8%1
2026-073.6K+5.3%1
2026-063.4K+2.8%1
2026-053.3K—1
2026-033.0K—1

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.9 KB · ClawHub v1.0.4
---
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.
Show all (98 lines)
**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
```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.py` script in the `scripts/` folder:

```bash
# Web search (adjust path to your skill location)
python ~/.clawdbot/skills/xai-search/scripts/xai-search.py web "latest news about AI"

# X/Twitter search  
python ~/.clawdbot/skills/xai-search/scripts/xai-search.py x "what are people saying about Clawdbot"

# Both
python ~/.clawdbot/skills/xai-search/scripts/xai-search.py 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)

Popular in Knowledge

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.