X Composer
Post to X.com via browser automation. No API key required.
Mode Priority
- Playwright MCP (recommended) — Headless, most reliable, supports image upload
- CDP mode — Auto-scans ports 9222-9230 for Chrome CDP
- Clipboard fallback — Copies to clipboard and pastes via AppleScript
Playwright MCP Mode (Recommended)
Use Playwright MCP tools directly. Handles text, images, and posting without visible browser.
Post with text only
1. browser_navigate → https://x.com/compose/post
2. browser_snapshot → find textbox ref
3. browser_run_code → force click textbox, keyboard.type(content, {delay: 10})
4. browser_take_screenshot → verify draft
5. Ask user confirmation
6. browser_run_code → page.locator('[data-testid="tweetButton"]').dispatchEvent('click')Post with image
1. Type content (same as above)
2. browser_run_code → page.locator('input[type="file"][accept*="image"]').first().setInputFiles('/path/to/image.png')
3. browser_take_screenshot → verify image attached
4. Post after confirmationKey notes
- X.com has an overlay that blocks normal clicks — always use
{force: true}ordispatchEvent('click') - To clear text:
Cmd+AthenBackspaceviapage.keyboard - Login persists in Playwright session — if not logged in, user must log in once manually
fill()can cause duplicate text — preferkeyboard.type()with delay
CDP Mode (Fallback)
Quick Post
bash scripts/x-post.sh "Your post content here"CDP Auto Port Detection
- Scans ports 9222-9230 for existing Chrome CDP (verifies it's Chrome, not Electron apps)
- Finds first available port to launch new Chrome instance
- Saves active port to
~/.chrome-cdp-port
Individual Scripts
# Open compose page
NODE_PATH=$(npm root -g) node scripts/cdp-launch.js [URL]
# Type text
echo '[{"text":"Hello"},{"enter":true},{"text":"World"}]' | NODE_PATH=$(npm root -g) node scripts/cdp-type.jsClipboard Fallback
If CDP is unavailable (Chrome already running without debugging):
- Copies text to clipboard via
pbcopy - Focuses Chrome via AppleScript
- Pastes via Cmd+V
Prerequisites
- Playwright MCP:
playwrightMCP server configured - CDP mode:
npm install -g chrome-remote-interface
Rules
- NEVER auto-post — always show draft and ask user for confirmation
- If X.com requires login, inform user to log in manually
- Take screenshot to verify content before posting
- For image posts, verify image is attached before posting
Troubleshooting
| Issue | Fix |
|---|---|
| Overlay blocks clicks | Use {force: true} or dispatchEvent('click') |
fill() duplicates text | Use keyboard.type() with {delay: 10} instead |
| Port 9222 occupied | Auto-handled — scans 9222-9230 |
| Not logged in | User must log in manually once, session persists |