🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

K test

by @dtkien1802

Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social med...

Versionv1.0.0
Downloads562
TERMINAL
clawhub install k-test

πŸ“– About This Skill


name: x-search description: Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social media posts about a topic. homepage: https://docs.x.ai/developers/tools/x-search metadata: { "openclaw": { "emoji": "𝕏", "requires": { "bins": ["python3"], "env": ["XAI_API_KEY"] }, "primaryEnv": "XAI_API_KEY", "install": [ { "id": "python-brew", "kind": "brew", "formula": "python", "bins": ["python3"], "label": "Install Python (brew)", }, ], }, }

X Search

Search X (Twitter) posts using the xAI Grok API with real-time access to X content.

Setup

1. Get your API key: https://console.x.ai 2. Set environment variable:

   export XAI_API_KEY="xai-your-key-here"
   
3. Or set skills."x-search".apiKey / skills."x-search".env.XAI_API_KEY in ~/.openclaw/openclaw.json

Usage

python3 {baseDir}/scripts/search.py "what is trending in AI right now"

Useful flags:

# Filter by handles (max 10)
python3 {baseDir}/scripts/search.py --handles jaaneek,OpenClaw "latest posts"

Exclude handles (max 10)

python3 {baseDir}/scripts/search.py --exclude spambot,crypto_shill "trending AI"

Date range (YYYY-MM-DD)

python3 {baseDir}/scripts/search.py --from 2026-03-01 --to 2026-03-20 "xAI grok updates"

Enable image/video understanding in posts

python3 {baseDir}/scripts/search.py --images --video "product demos"

Notes

  • Uses the xAI Responses API with x_search tool (Grok performs the search and summarizes results)
  • Cannot use --handles and --exclude at the same time
  • Results include citations with links to original X posts
  • Present results in a readable format with post content, authors, and citations
  • πŸ’‘ Examples

    python3 {baseDir}/scripts/search.py "what is trending in AI right now"
    

    Useful flags:

    # Filter by handles (max 10)
    python3 {baseDir}/scripts/search.py --handles jaaneek,OpenClaw "latest posts"

    Exclude handles (max 10)

    python3 {baseDir}/scripts/search.py --exclude spambot,crypto_shill "trending AI"

    Date range (YYYY-MM-DD)

    python3 {baseDir}/scripts/search.py --from 2026-03-01 --to 2026-03-20 "xAI grok updates"

    Enable image/video understanding in posts

    python3 {baseDir}/scripts/search.py --images --video "product demos"

    βš™οΈ Configuration

    1. Get your API key: https://console.x.ai 2. Set environment variable:

       export XAI_API_KEY="xai-your-key-here"
       
    3. Or set skills."x-search".apiKey / skills."x-search".env.XAI_API_KEY in ~/.openclaw/openclaw.json

    πŸ“‹ Tips & Best Practices

  • Uses the xAI Responses API with x_search tool (Grok performs the search and summarizes results)
  • Cannot use --handles and --exclude at the same time
  • Results include citations with links to original X posts
  • Present results in a readable format with post content, authors, and citations