Neura Market Logo

X Search

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...

Jaaneek

@jaaneek

What This Skill Does

Searches X (Twitter) posts in real time using the xAI Grok API. Supports filtering by handles, excluding handles, date ranges, and media understanding.

Replaces manually browsing X or using Twitter’s native search by providing a scriptable, API-driven way to retrieve and summarize posts with citations.

When to Use It

  • Find recent tweets about a trending topic or event
  • Search posts from specific X handles for updates or announcements
  • Exclude spam or irrelevant accounts when searching for genuine discussions
  • Retrieve posts within a custom date range for research or analysis
  • Look up what people are saying about a product, brand, or news story
  • Enable image or video understanding to find posts with visual content

Install

$ openclaw skills install @jaaneek/x-search

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

Top skills in this category

Multi Search Engine

@gpyangyoujun

Multi search engine integration with 16 engines (7 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and Wolfra...

758158k

Agent Browser

@matrixy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

453152k

Openai Whisper

@steipete

Local speech-to-text with the Whisper CLI (no API key).

33787k

Tavily 搜索

@jacky1n7

Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable...

266103k

Baidu web search

@ide-rea

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

21992k