X Api

Covers the full X API surface: OAuth 1.0a for posting tweets and threads, OAuth 2.0 bearer tokens for search and timeline reads, media uploads, and rate limit handling. The source is explicit about drift risk since X changes endpoints and quotas often, so it emphasizes reading headers at runtime instead of hardcoding limits. Includes patterns for voice modeling by pulling recent original posts, thread construction with reply chaining, and a security checklist that actually matters (no hardcoded tokens, .env in .gitignore, read-only tokens when possible). Pairs well with brand-voice and content-engine if you're generating posts programmatically. The error handling examples are production ready, not toys.

skills.sh installs: 4.5K
GitHub stars: 229.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/everything-claude-code --skill x-api --agent claude-code

Installs into .claude/skills of the current project.

Files

X API

Drift-prone skill. X API endpoints, access tiers, quotas, and write permissions change frequently. Verify current developer docs and account access before quoting rate limits or implementing a posting/search flow.

Programmatic interaction with X (Twitter) for posting, reading, searching, and analytics.

When to Activate

User wants to post tweets or threads programmatically
Reading timeline, mentions, or user data from X
Searching X for content, trends, or conversations
Building X integrations or bots
Analytics and engagement tracking
User says "post to X", "tweet", "X API", or "Twitter API"

Authentication

OAuth 2.0 Bearer Token (App-Only)

Best for: read-heavy operations, search, public data.

# Environment setup
export X_BEARER_TOKEN="your-bearer-token"

import os
import requests

bearer = os.environ["X_BEARER_TOKEN"]
headers = {"Authorization": f"Bearer {bearer}"}

# Search recent tweets
resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={"query": "claude code", "max_results": 10}
)
tweets = resp.json()