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/evidence/x-article-draft.md(what was done + links)
Bundled Scripts
Installed path (typical):
- •
~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py - •
~/.claude/skills/tool-x-article-publisher/scripts/copy_to_clipboard.py
Runbook (Step-by-step)
Follow: references/runbook.md