Interacting with X

Enables agents to operate on X (Twitter) with full interaction capabilities.

Setup

Add to .env:

X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
X_BEARER_TOKEN=your_bearer_token

Get credentials from https://developer.x.com/en/portal/dashboard

Operations

Post a Tweet

# Simple tweet
uv run python .skills/interacting-with-x/scripts/post.py "Hello from Central"

# Thread (multiple tweets chained)
uv run python .skills/interacting-with-x/scripts/post.py --thread "First tweet" "Second tweet" "Third tweet"

# With media
uv run python .skills/interacting-with-x/scripts/post.py --media image.png "Tweet with image"

# Reply to existing tweet
uv run python .skills/interacting-with-x/scripts/post.py --reply-to 1234567890 "Reply text"

Read Timeline/Mentions

# Home timeline
uv run python .skills/interacting-with-x/scripts/read.py timeline

# Mentions
uv run python .skills/interacting-with-x/scripts/read.py mentions

# User's tweets
uv run python .skills/interacting-with-x/scripts/read.py user elonmusk

# Search
uv run python .skills/interacting-with-x/scripts/read.py search "AI agents"

Engage

# Like
uv run python .skills/interacting-with-x/scripts/engage.py like 1234567890

# Retweet
uv run python .skills/interacting-with-x/scripts/engage.py retweet 1234567890

# Follow/unfollow
uv run python .skills/interacting-with-x/scripts/engage.py follow username
uv run python .skills/interacting-with-x/scripts/engage.py unfollow username

Rate Limits

X API has strict rate limits. Pro tier helps but still:

• Posts: 100/24h (Pro: 500/24h)
• Reads: 100 requests/15min
• Likes: 50/24h

Scripts handle rate limiting automatically. See references/api-reference.md for details.

Character Limits

• Standard: 280 characters
• Pro: 25,000 characters

Scripts auto-detect account type and handle accordingly.

Cross-posting from ATProto

For mirroring Bluesky content to X:

# In your code
from .skills.interacting_with_x.scripts import post

# After posting to Bluesky, cross-post to X
post.create_tweet(text)  # or post.create_thread(texts) for threads

Facets (mentions, links) are automatically converted to X format.