x-tweet-search

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_SKILL_DIR}/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_SKILL_DIR}/scripts/search.sh "bitcoin"

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

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

Pricing and Rate Limits

X API access is pay-per-use. Read the endpoint's rate-limit response headers and consult the current X API pricing and rate-limit documentation instead of assuming a fixed free-tier quota.

References

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