X Api

Wraps the X API for posting tweets, threads, timeline reads, search, and analytics. Covers both OAuth 2.0 bearer tokens for read-heavy work and OAuth 1.0a for anything that writes or manages your account. The source is pragmatic about rate limits: it tells you to check headers at runtime instead of trusting static tables, which is the right call given how often X changes quotas and access tiers. Includes patterns for media uploads, thread construction, and voice-matched content when paired with brand-voice and content-engine. One warning: the skill flags itself as drift-prone because X's developer platform moves fast, so verify current docs before shipping anything that depends on specific endpoints or write permissions.

skills.sh installs: 5.4K
GitHub stars: 300.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/ecc --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()