b-open-io

x-tweet-search

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.

b-open-io 12 4 Updated 4mo ago

Resources

1
GitHub

Install

npx skillscat add b-open-io/prompts/x-tweet-search

Install via the SkillsCat registry.

SKILL.md

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