twitterlisted

# Twitter/X — Dual-Mode Integration Three tools for different operations. Choose by task: | Mode | Tool | Auth | Cost | Use For | |------|------|------|------|---------| | **Official API** | `x-search` | Bearer token | $0.005/read, $0.01/user | Search, research, profiles, threads, monitoring | | **Official API** | `x-search post/reply` | OAuth 1.0a | $0.01/post | Posting, replying via official API | | **Session** | `bird` | Browser cookies | Free | Posting, replying, bookmarks, mentions, media | | **Archival** | `smaug` | Via bird | Free | Bookmark/likes processing, AI-powered filing | > **Alternative**: `opencli twitter` provides 25 free session-based commands (post, reply, search, bookmarks, follow, block, etc.) via Chrome session reuse. Prefer opencli for routine Twitter operations. Use x-search for deep research with cost tracking. bird CLI remains available as fallback. ## Setup ### x-search (Official API v2) Requires an X API Bearer token from [console.x.com](https://console.x.com). Pay-per-use — no monthly commitment. ```bash # Store token (pick one) echo 'X_BEARER_TOKEN=your_token_here' >> ~/.claude/skills/twitter/.env # OR export X_BEARER_TOKEN=your_token_here # OR mkdir -p ~/.config/env && echo 'X_BEARER_TOKEN=your_token_here' >> ~/.config/env/global.env ``` #### OAuth 1.0a (for posting) Posting requires OAuth 1.0a credentials in addition to the Bearer token. 1. Go to [console.x.com](https://console.x.com) → your project → Keys and tokens 2. Under "Consume