x-twitter-apiX (Twitter) API client for searching tweets, retrieving article content, and fetching trending topics. Supports both Bearer Token (app-only) and OAuth 2.0 authentication.
Install via ClawdBot CLI:
clawdbot install Zaaachary/x-twitter-apiSearch tweets, retrieve article content, and fetch trending topics from X (Twitter).
# Set environment variable
export X_BEARER_TOKEN="your_bearer_token_here"
# Or temporarily for this session
X_BEARER_TOKEN="your_token" python3 scripts/search_tweets.pyGet API Token:
# Basic search
python3 scripts/search_tweets.py --query "AI OR δΊΊε·₯ζΊθ½"
# Advanced search (Chinese original tweets only)
python3 scripts/search_tweets.py --query "AI -is:retweet lang:zh" --count 10
# Search by user
python3 scripts/search_tweets.py --query "from:elonmusk" --count 5
# Search hashtags
python3 scripts/search_tweets.py --query "#Crypto OR #Blockchain"Query Operators:
-is:retweet - Original tweets onlylang:zh - Chinese languagefrom:username - Tweets from specific userhas:links - Tweets with linksis:verified - Verified users only# By URL (article or tweet)
python3 scripts/get_article.py --url "https://x.com/username/article/123456789"
# By Tweet ID
python3 scripts/get_article.py --id "123456789"# Global trends
python3 scripts/get_trends.py
# Trends by WOEID (Yahoo Where On Earth ID)
python3 scripts/get_trends.py --woeid 1 # Global
python3 scripts/get_trends.py --woeid 23424977 # USA| Tier | Cost | Tweets/Month | Notes |
|------|------|--------------|-------|
| Free | $0 | 500 | 1 request/day, testing only |
| Basic | $200 | 500,000 | Minimum production tier |
| Pro | $5,000 | 2,000,000+ | Real-time streaming |
Free tier restrictions:
The scripts automatically handle:
python3 scripts/search_tweets.py --query "AI OR δΊΊε·₯ζΊθ½ -is:retweet" --count 5 --output prettypython3 scripts/search_tweets.py --query "from:username" --count 10 --save output.jsonpython3 scripts/get_article.py --url "https://x.com/user/article/id" --output markdown --save article.mdGenerated Mar 1, 2026
Companies can use this skill to track brand mentions, customer feedback, and competitor activity on X (Twitter). By searching tweets with specific hashtags or keywords, businesses gain real-time insights into public perception and emerging trends, enabling proactive reputation management and targeted marketing campaigns.
News platforms and content creators can leverage the skill to fetch trending topics and search for tweets on current events. This allows for automated discovery of viral stories, user-generated content, and expert commentary, which can be aggregated into curated news feeds or reports for audiences.
Financial firms and analysts can utilize tweet searches to gauge public sentiment around stocks, cryptocurrencies, or economic policies. By analyzing tweet volumes and content, they identify emerging market trends, investor opinions, and potential risks, supporting data-driven investment decisions.
Researchers and academics can employ this skill to collect tweet data for studies on social behavior, language use, or political discourse. By filtering tweets with advanced operators like language or verification status, they gather structured datasets for quantitative analysis and trend tracking over time.
Service-oriented businesses can monitor tweets from specific users or containing support-related keywords to identify customer issues and feedback. This enables timely responses, improves service quality, and helps track engagement metrics, enhancing overall customer satisfaction and loyalty.
Develop a subscription-based software service that integrates this skill to provide businesses with dashboards for social media analytics, sentiment reports, and trend alerts. Revenue is generated through monthly or annual fees, with tiered pricing based on data volume and features like real-time monitoring.
Offer this skill as part of a larger API service or develop custom integrations for clients needing specialized X (Twitter) data access. Revenue comes from one-time development fees, ongoing maintenance contracts, or usage-based billing for API calls beyond free limits.
Curate and license tweet data or trend reports to media companies, researchers, or marketers. By aggregating and anonymizing data from this skill, create premium data feeds or reports sold as one-time purchases or recurring subscriptions, targeting industries needing reliable social insights.
π¬ Integration Tip
Start by setting the X_BEARER_TOKEN environment variable and test with simple queries to avoid API rate limits, then scale up based on tier needs.
Fetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it.
Fetch and summarize YouTube video transcripts. Use when asked to summarize, transcribe, or extract content from YouTube videos. Handles transcript fetching via residential IP proxy to bypass YouTube's cloud IP blocks.
Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.
Interact with Twitter/X β read tweets, search, post, like, retweet, and manage your timeline.
LinkedIn automation via browser relay or cookies for messaging, profile viewing, and network actions.
Search YouTube videos, get channel info, fetch video details and transcripts using YouTube Data API v3 via MCP server or yt-dlp fallback.