Agent skill · marketing growth · sundial-org
x-api
Post to X (Twitter) using the official API with OAuth 1.0a. Use when you need to tweet, post updates, or publish content. Bypasses rate limits and bot detection that affect cookie-based approaches like bird CLI.
Why this skill is useful
Provides specific commands and setup instructions for using the X API that the AI wouldn't generate reliably on its own.
What it needs
Requires twitter-api-v2 installed locally. Requires x account access. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
x-api 🐦 Post to X using the official API (OAuth 1.0a). When to Use Posting tweets (cookie-based bird tweet gets blocked by bot detection) Official API access is needed for reliability For reading (timeline, search, mentions), use bird CLI instead — it's free and works well for reads. Setup 1. Get API Credentials 1. Go to https://developer.x.com/en/portal/dashboard 2. Create a Project and App 3. Set App permissions to Read and Write 4. Get your keys from "Keys and tokens" tab: API Key (Consumer Key) API Key Secret (Consumer Secret) Access Token Access Token Secret 2. Configure Credentials Option A: Environment variables Option B: Config file at ~/.clawdbot/secrets/x-api.json 3. Install Dependency Post a Tweet Or with full path: Supports multi-line tweets: Returns the tweet URL on success. Limits Free tier: 1,500 posts/month (requires credits in X Developer Portal) Basic tier ($100/mo): Higher limits Reading (use bird) For reading, searching, and monitoring — use the bird CLI: Troubleshooting 402 Credits Depleted: Add credits in X Developer Portal → Dashboard 401 Unauthorized: Regenerate Access Token (ensure Read+Write permissions are set first) No credentials found: Set env vars or create config file (see Setup above)
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/x-api