How do I install the X Twitter skill?

Run npx skillmds@latest add modbender/x-twitter-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is X Twitter safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Twitter?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X Twitter free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X Twitter?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Twitter by modbender — Agent Skill

Name: X Twitter
Author: modbender

File contents

X (Twitter) API

Search tweets, retrieve article content, and fetch trending topics from X (Twitter).

Features

Search Tweets: Search recent tweets (last 7 days) with advanced query operators
Get Article Content: Retrieve tweet and article details by URL or ID
Trending Topics: Fetch trending topics (requires Basic tier or higher)
User Info: Get user profile and tweet history

Setup

# 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.py

Get API Token:

Visit https://developer.x.com
Create a project and app
Generate Bearer Token in "Keys and Tokens" tab
Set the environment variable

Usage

Search Tweets

# 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 only
lang:zh - Chinese language
from:username - Tweets from specific user
has:links - Tweets with links
is:verified - Verified users only

Get Article/Tweet Content

# 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"

Get Trending Topics

# 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

API Limits

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:

500 tweets/month (~16-17/day)
1 request/day per endpoint
No publishing/liking
Suitable for development testing only

Output Formats

JSON: Structured data with all fields
Pretty: Human-readable formatted text
Save: Optional file export (JSON/Markdown)

Error Handling

The scripts automatically handle:

Rate limiting (429 errors)
Invalid tokens (401 errors)
Network errors with retry logic
Missing required parameters

Examples

Example 1: Search AI tweets

python3 scripts/search_tweets.py --query "AI OR 人工智能 -is:retweet" --count 5 --output pretty

Example 2: Monitor specific user

python3 scripts/search_tweets.py --query "from:username" --count 10 --save output.json

Example 3: Get article and analyze

python3 scripts/get_article.py --url "https://x.com/user/article/id" --output markdown --save article.md

---name: x-twitter-2description: X (Twitter) API client for searching tweets, retrieving article content, and fetching trending topics. Supports both Bearer Token (app-only) and OAuth 2.0 authentication.---# X (Twitter) APISearch tweets, retrieve article content, and fetch trending topics from X (Twitter).## Features- **Search Tweets**: Search recent tweets (last 7 days) with advanced query operators- **Get Article Content**: Retrieve tweet and article details by URL or ID- **Trending Topics**: Fetch trending topics (requires Basic tier or higher)- **User Info**: Get user profile and tweet history## Setup```bash# Set environment variableexport X_BEARER_TOKEN="your_bearer_token_here"# Or temporarily for this sessionX_BEARER_TOKEN="your_token" python3 scripts/search_tweets.py```**Get API Token:**1. Visit https://developer.x.com2. Create a project and app3. Generate Bearer Token in "Keys and Tokens" tab4. Set the environment variable## Usage### Search Tweets```bash# Basic searchpython3 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 userpython3 scripts/search_tweets.py --query "from:elonmusk" --count 5# Search hashtagspython3 scripts/search_tweets.py --query "#Crypto OR #Blockchain"```**Query Operators:**- `-is:retweet` - Original tweets only- `lang:zh` - Chinese language- `from:username` - Tweets from specific user- `has:links` - Tweets with links- `is:verified` - Verified users only### Get Article/Tweet Content```bash# By URL (article or tweet)python3 scripts/get_article.py --url "https://x.com/username/article/123456789"# By Tweet IDpython3 scripts/get_article.py --id "123456789"```### Get Trending Topics```bash# Global trendspython3 scripts/get_trends.py# Trends by WOEID (Yahoo Where On Earth ID)python3 scripts/get_trends.py --woeid 1 # Globalpython3 scripts/get_trends.py --woeid 23424977 # USA```## API Limits| 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:**- 500 tweets/month (~16-17/day)- 1 request/day per endpoint- No publishing/liking- Suitable for development testing only## Output Formats- **JSON**: Structured data with all fields- **Pretty**: Human-readable formatted text- **Save**: Optional file export (JSON/Markdown)## Error HandlingThe scripts automatically handle:- Rate limiting (429 errors)- Invalid tokens (401 errors)- Network errors with retry logic- Missing required parameters## Examples### Example 1: Search AI tweets```bashpython3 scripts/search_tweets.py --query "AI OR 人工智能 -is:retweet" --count 5 --output pretty```### Example 2: Monitor specific user```bashpython3 scripts/search_tweets.py --query "from:username" --count 10 --save output.json```### Example 3: Get article and analyze```bashpython3 scripts/get_article.py --url "https://x.com/user/article/id" --output markdown --save article.md```

Frequently asked questions

X Twitter