---
name: x-tweet-search
version: 1.0.0
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.
allowed-tools: Bash(curl:*), Bash(jq:*), Bash(${CLAUDE_PLUGIN_ROOT}:*)
---

# X Tweet Search

Search recent tweets (last 7 days) by query.

## Setup

```bash
export X_BEARER_TOKEN="your-token"  # https://developer.x.com/en/portal/dashboard
```

## Usage

```bash
${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

```bash
# 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

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