X Article Publisher
Publish Markdown content into X (Twitter) Articles as a draft, preserving formatting via rich text paste and deterministic image insertion.
Hard Rules (Safety)
- Never auto-publish (draft only; user publishes manually).
- User must be logged in before automation starts.
- First image = cover image (if any).
Prerequisites
- Browser automation available (Playwright MCP or equivalent)
- X account can access Articles (Premium / Premium Plus)
- macOS recommended (clipboard helper uses Cocoa)
- Python 3.9+ with:
pip install Pillow pyobjc-framework-Cocoa
Inputs / Outputs (Recommended)
Inputs (paths only):
article_md_path: Markdown file to publish- Optional:
run_dirfor artifacts (otherwise use/tmp/)
Outputs (recommended artifacts):
/tmp/x_article.json(parsed structure)/tmp/x_article.html(HTML body for paste)- Optional:
run_dir/05-final/x-article-draft.md(what was done + links)
Bundled Scripts
Installed path (typical):
~/.claude/skills/publish-x-article/scripts/parse_markdown.py~/.claude/skills/publish-x-article/scripts/copy_to_clipboard.py
Runbook (Step-by-step)
Follow: references/runbook.md