360 Secure SkillHub
360 安全技能中心

X Twitter

基于 X (Twitter) API 的 CLI 技能，通过三个 Python 脚本工作：search_tweets.py 按查询语法搜索近 7 天推文，get_article.py 按 URL 或 Tweet ID 获取推文/文章内容，get_trends.py 按 WOEID 获取趋势话题。需配置 X_BEARER_TOKEN，输出 JSON 或 pretty 文本，可选保存为 JSON/M…

zaaachary
zaaachary
热度 80.10
最近更新 2026-05-17 11:57:29
分类：搜索依赖：代码执行 / 第三方 API应用场景：社交媒体 / 研究 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add x-twitter-api
Metadata
name
x-twitter
description
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.
homepage
https://developer.x.com
metadata
{"openclaw":{"emoji":"𝕏","requires":{"bins":["python3"]},"env":["X_BEARER_TOKEN"],"primaryEnv":"X_BEARER_TOKEN"}}

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:

  1. Visit https://developer.x.com
  2. Create a project and app
  3. Generate Bearer Token in "Keys and Tokens" tab
  4. 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