OpenSkillIndex← back to search
claude-codeopenclaw

Awesome-openclaw-skills search-x

Search X/Twitter in real-time using Grok. Find tweets, trends, and discussions with citations.

install
source · Clone the upstream repo
git clone https://github.com/sundial-org/awesome-openclaw-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/search-x" ~/.claude/skills/sundial-org-awesome-openclaw-skills-search-x && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/search-x" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-search-x && rm -rf "$T"
manifest: skills/search-x/SKILL.md
source content

Search X

Real-time X/Twitter search powered by Grok's x_search tool. Get actual tweets with citations.

Setup

Set your xAI API key:

clawdbot config set skills.entries.search-x.apiKey "xai-YOUR-KEY"

Or use environment variable:

export XAI_API_KEY="xai-YOUR-KEY"

Get your API key at: https://console.x.ai

Commands

Basic Search

node {baseDir}/scripts/search.js "AI video editing"

Filter by Time

node {baseDir}/scripts/search.js --days 7 "breaking news"
node {baseDir}/scripts/search.js --days 1 "trending today"

Filter by Handles

node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements"
node {baseDir}/scripts/search.js --exclude @bots "real discussions"

Output Options

node {baseDir}/scripts/search.js --json "topic"        # Full JSON response
node {baseDir}/scripts/search.js --compact "topic"     # Just tweets, no fluff
node {baseDir}/scripts/search.js --links-only "topic"  # Just X links

Example Usage in Chat

User: "Search X for what people are saying about Claude Code" Action: Run search with query "Claude Code"

User: "Find tweets from @remotion_dev in the last week" Action: Run search with --handles @remotion_dev --days 7

User: "What's trending about AI on Twitter today?" Action: Run search with --days 1 "AI trending"

User: "Search X for Remotion best practices, last 30 days" Action: Run search with --days 30 "Remotion best practices"

How It Works

Uses xAI's Responses API (

/v1/responses
) with the 
x_search
tool:

  • Model: 
    grok-4-1-fast
    (optimized for agentic search)
  • Returns real tweets with URLs
  • Includes citations for verification
  • Supports date and handle filtering

Response Format

Each result includes:

  • @username (display name)
  • Tweet content
  • Date/time
  • Direct link to tweet

Environment Variables

  • XAI_API_KEY
    - Your xAI API key (required)
  • SEARCH_X_MODEL
    - Model override (default: grok-4-1-fast)
  • SEARCH_X_DAYS
    - Default days to search (default: 30)