Agent-Skills.md

Agent Skills: 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.

UncategorizedID: b-open-io/prompts/x-tweet-search

Repository

b-open-io/prompts
b-open-io
114

Install this agent skill to your local

pnpm dlx add-skill https://github.com/b-open-io/prompts/tree/HEAD/skills/x-tweet-search

Skill Files

Browse the full folder contents for x-tweet-search.

Download Skill

Loading file tree…

skills/x-tweet-search/SKILL.md

Skill Metadata

Name
x-tweet-search
Description
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.

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