X Tweet Search

Search recent tweets (last 7 days) by query.

Setup

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

Usage

${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

# 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