groksearch
Search X and the web using Grok (xAI) API, then summarise results with top sources.
How do I install this agent skill?
npx skills add https://github.com/connorads/dotfiles --skill groksearchIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill searches the web and X (Twitter) using the xAI API. It is susceptible to indirect prompt injection from untrusted search results and involves local command execution for its operations.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
groksearch
Search X and the web using Grok's server-side tools and return a concise summary with top sources.
This skill uses Grok's own x_search and web_search tools (not Claude WebSearch).
Usage
Run the script using absolute path (do NOT cd to the skill directory first):
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query"
Common options
# X + Web (default)
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources both
# X only
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources x
# Web only
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources web
# Last 14 days
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --days 14
# Explicit date range
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --from-date 2026-01-01 --to-date 2026-01-31
# No date filtering
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --no-date
API Key
Provide the xAI API key in one of these ways (highest priority first):
--api-keyargumentXAI_API_KEYenvironment variable~/.config/groksearch/.envfile
Example config file:
mkdir -p ~/.config/groksearch
cat > ~/.config/groksearch/.env << 'EOF'
XAI_API_KEY=
EOF
chmod 600 ~/.config/groksearch/.env
Output
The script prints:
- Query, sources, and date range
- A concise summary with key points
- A short list of top source URLs (from Grok citations)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/connorads/dotfiles/groksearch">View groksearch on skillZs</a>