mcpField
X
x-tweet-search

x-tweet-search

github.com/b-open-ioProductivity1681 installsUpdated 4w ago
Repository

About x-tweet-search

x-tweet-search is a skill for searching X posts from the past seven days using a query. It uses an X bearer token and supports search operators for filtering by account, hashtag, replies, media, links, and retweets.

Key features

  1. 01Search posts from the last seven days
  2. 02Filter by account and hashtag
  3. 03Include or exclude replies and retweets
  4. 04Filter posts by media or links
  5. 05Set a maximum result count

Use cases

  1. 01Find recent posts about a topic
  2. 02Review posts from a specific account
  3. 03Locate recent posts containing media or links

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/b-open-io/prompts --skill x-tweet-search

After installing, type/x-tweet-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.clawnet/
unsigned-skill.json
scripts/
search.sh
setup.sh

Details

From the project README

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

Comments

Markdown supported