Coding

X Post Search by Gecho

Try it

Search public X (Twitter) posts by keyword with the official Gecho Bridge MCP tool and return post text, authors, engagement data, and links. Use for keyword-level X research and monitoring.

What it does

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

The skill document

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

Related skills

opentwitter

Query Twitter/X profiles, tweets, follower events, and KOL data through the 6551 REST API.

by infra403840 installs27 stars

Upload-Post

Post videos, photos, text, and documents to 10 social platforms through a single REST API call.

by victorcavero14375 installs50 stars

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

minara

Trade crypto, manage a multi-chain wallet, and query an AI analyst from one CLI.

by lowesyang162 installs109 stars

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai21 installs8 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from gecho-ai

Browse all skills

tiktok-search

Search TikTok from chat, collect creator videos, and run async product/trend insight jobs via Gecho Bridge MCP.

by gecho-ai23 installs4 stars

tiktok-video-search

Search TikTok videos by keyword with Gecho Bridge MCP and return video metadata, creators, engagement metrics, and links. Requires the Gecho Chrome extension, an active TikTok session, and the Gecho Bridge MCP server.

by gecho-ai7 installs1 stars

tiktok-insight

Run async TikTok product, trend, competitor, and content insight jobs with Gecho Bridge MCP, and check job status. Requires the Gecho Chrome extension, an active TikTok session, and the Gecho Bridge MCP server.

by gecho-ai6 installs