x-oauth-apiPost to X (Twitter) using the official OAuth 1.0a API. Free tier compatible.
Install via ClawdBot CLI:
clawdbot install ngmeyer/x-oauth-apiPost to X (formerly Twitter) using the official X API with OAuth 1.0a authentication.
This skill provides direct access to X API v2 for posting tweets, managing threads, and monitoring mentions. No proxy or third-party service required — uses your X API credentials directly.
Use when:
Store these environment variables (from your X Developer Account):
X_API_KEY # Consumer Key (API Key)
X_API_SECRET # Consumer Secret
X_ACCESS_TOKEN # Access Token
X_ACCESS_TOKEN_SECRET # Access Token Secret
X_USER_ID # Optional: Your numeric user ID (speeds up mentions)Free tier supports:
x me)Requires Basic+ tier:
# Post a simple tweet
x post "Hello from X API"
# Post a thread
x thread "First tweet" "Second tweet" "Third tweet"
# Check mentions
x mentions --limit 10
# Search recent tweets
x search "AI agents" --limit 5x post Post a single tweet.
Options:
--reply-to - Reply to a specific tweet--quote - Quote tweet--media - Attach image/videoExample:
x post "Check this out" --media image.jpgx thread ... Post a tweet thread.
Example:
x thread \
"Thread about AI" \
"Here's what I learned" \
"Most important takeaway"x mentions [options]Get recent mentions of your account.
Options:
--limit - Number of mentions (default: 10, max: 100)--since - Only mentions after this ID--format json - Output as JSONNote: Requires X_USER_ID env var OR will fetch it automatically (slower).
x search [options] Search recent tweets.
Options:
--limit - Number of results (default: 10, max: 100)--format json - Output as JSONx delete Delete a tweet.
x meShow current account info (name, username, follower counts, user ID).
X API v2 has rate limits per endpoint:
| Endpoint | Limit | Window |
|----------|-------|--------|
| POST /2/tweets | 200 | 15 min (Free tier) |
| GET /2/tweets/search/recent | 100 | 15 min (Free tier) |
| GET /2/users/:id/mentions | 100 | 15 min (Free tier) |
Rate limits vary by access tier. See X API documentation for details.
OAuth 1.0a is handled transparently. Just provide your credentials via environment variables. The skill will sign all requests automatically.
x post "Check out this screenshot" --media screenshot.pngx post "Great point!" --reply-to 1234567890123456789x thread \
"Just launched x-oauth-api skill" \
"It lets you post to X directly from your agent" \
"No proxies, direct OAuth 1.0a authentication"# Find interesting tweets
x search "agent framework"
# Reply to one
x post "Have you tried this?" --reply-to 1234567890123456789"Unauthorized" error
"Rate limit exceeded"
"This endpoint requires a paid X API tier"
Tweet not posting
Free. X API is free for basic usage. Check your app's rate limits in X Developer Portal.
For X API issues, see: https://developer.twitter.com/en/docs/twitter-api
Generated Mar 1, 2026
Small businesses can use this skill to automate posting updates, promotions, and engaging content directly to their X account. It helps maintain an active online presence without manual intervention, supporting threads for detailed announcements and media attachments for visual appeal.
Influencers and bloggers can leverage this skill to schedule and post tweets or threads about their latest content, such as articles or videos. It enables direct engagement with followers by replying to mentions and searching for relevant discussions to join, enhancing audience interaction.
Tech companies can integrate this skill to monitor mentions on X for customer inquiries or feedback, allowing quick responses via automated or manual replies. It streamlines support by fetching recent mentions and posting updates, improving response times and customer satisfaction.
Non-profits can use this skill to post announcements and updates about events, campaigns, or fundraising efforts on X. By creating threads for detailed information and attaching media like images, they can effectively reach a wider audience and drive engagement without additional costs.
Media outlets can employ this skill to post breaking news or updates directly to X as events unfold. It supports quick posting of tweets and threads, with options to quote or reply to other tweets, ensuring timely dissemination of information to followers.
Offer a basic social media management tool for free that uses this skill for posting and simple engagement, then charge for advanced features like analytics, scheduling, or multi-account support. Revenue comes from subscription tiers targeting small businesses and individual creators.
Provide managed social media services to clients, using this skill to automate posting and monitoring on X as part of a broader marketing package. Revenue is generated through monthly retainer fees or project-based pricing for businesses lacking in-house expertise.
Sell this skill as part of a larger toolkit for developers building AI agents or automation platforms, with additional paid add-ons like enhanced rate limits or custom integrations. Revenue streams include one-time purchases, licensing fees, or usage-based pricing for enterprise clients.
💬 Integration Tip
Ensure all required environment variables are correctly set and test with simple commands like 'x post' before scaling to avoid authentication or rate limit issues.
Drift detection + baseline integrity guard for agent workspace files with automatic alerting support
Guardian Angel gives AI agents a moral conscience rooted in Thomistic virtue ethics. Rather than relying solely on rule lists, it cultivates stable virtuous...
Core identity and personality for Molt, the transformative AI assistant
Gentle reminders to stay human while using AI. Reflection, not restriction.
Build secure authentication with sessions, JWT, OAuth, passwordless, MFA, and SSO for web and mobile apps.
Implement OAuth 2.0 and OpenID Connect flows securely.