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.
Resources
1Install
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/dashboardUsage
${CLAUDE_PLUGIN_ROOT}/scripts/search.sh "<query>" [max_results]Search Operators
from:username- From specific userto:username- Reply to user#hashtag- Contains hashtag-is:retweet- Exclude retweetshas:media- Contains mediahas: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" 20Rate Limits
Free tier: 10 requests per 15 minutes, 1,500 tweets/month