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