Twitter/X Poster Skill
Automated Twitter posting via Twitter API v2.
Quick Start
bash
# Post a tweet python scripts/run.py --post "Your tweet here" # Create a thread python scripts/run.py --thread "Tweet 1" "Tweet 2" "Tweet 3" # Reply to tweet python scripts/run.py --post "Reply text" --reply-to TWEET_ID # Search mentions python scripts/run.py --search "@yourusername" # Get insights python scripts/run.py --insights --days 7 # Verify setup python scripts/verify.py
Setup
1. Get Twitter API Credentials
- •Go to Twitter Developer Portal
- •Create an App
- •Generate API keys and tokens:
- •API Key & Secret
- •Access Token & Secret
- •Bearer Token
- •Enable OAuth 2.0
2. Configure Environment
Add to .env (use your Twitter credentials):
code
TWITTER_API_KEY=your_consumer_key_here TWITTER_API_SECRET=your_consumer_secret_here TWITTER_ACCESS_TOKEN=your_access_token_here TWITTER_ACCESS_SECRET=your_access_token_secret_here TWITTER_BEARER_TOKEN=your_bearer_token_here
Note: Twitter calls it "Consumer Key" - that's your API Key.
Features
Posting
- •Single tweets (280 characters)
- •Threads (multiple connected tweets)
- •Replies to other tweets
- •Approval workflow (default)
- •Rate limiting (50 tweets/day, 10/hour)
Analytics
- •Tweet performance
- •Engagement metrics
- •Timeline insights
- •Mentions tracking
Thread Creation
- •Automatically chains tweets
- •Each tweet links to previous
- •Up to 25 tweets per thread
Twitter Best Practices
- •Length: Max 280 characters
- •Hashtags: 1-3 focused hashtags
- •Threads: Break long content into 3-5 tweets
- •Timing: Post during peak engagement hours
Approval Workflow
Posts/threads create files in Vault/Pending_Approval/:
- •Review all tweets in thread
- •Edit as needed
- •Move to
Vault/Approved/to publish
Rate Limits
- •Daily: 50 tweets
- •Hourly: 10 tweets
Automatically enforced by MCP server.
Verification
Run: python scripts/verify.py
Expected: ✓ posting-twitter valid