---

name: x-tweet-search version: 1.0.0 description: Search recent X/Twitter posts by query. Returns RAW TWEETS (last 7 days). Use when user asks "search X for", "find tweets about", "what are people saying about", "Twitter search", "raw tweets about". For AI summaries/sentiment, use x-research instead. Requires X_BEARER_TOKEN. allowed-tools: Bash(curl:), Bash(jq:), Bash(${CLAUDE_PLUGIN_ROOT}:*)

X Tweet Search

Search recent tweets (last 7 days) by query.

Setup

Copyexport X_BEARER_TOKEN="your-token"  # https://developer.x.com/en/portal/dashboard

Usage

Copy${CLAUDE_PLUGIN_ROOT}/scripts/search.sh "<query>" [max_results]

Search Operators

• from:username - From specific user
• to:username - Reply to user
• #hashtag - Contains hashtag
• -is:retweet - Exclude retweets
• has:media - Contains media
• has:links - Contains links

Examples

Copy# Simple search
${CLAUDE_PLUGIN_ROOT}/scripts/search.sh "bitcoin"

# From specific user
${CLAUDE_PLUGIN_ROOT}/scripts/search.sh "from:kurtwuckertjr"

# Combined query
${CLAUDE_PLUGIN_ROOT}/scripts/search.sh "BSV -is:retweet" 20

Rate Limits

Free tier: 10 requests per 15 minutes, 1,500 tweets/month

References

• https://docs.x.com/llms.txt
• https://developer.x.com/en/docs/x-api/tweets/search