publish-substack-article

Publish Substack Article

Publish Markdown content to Substack post editor, converting Markdown to HTML and pasting as rich text. Saves as draft for user review before publishing.

Prerequisites

• Browser automation MCP (either one):
  • Chrome DevTools MCP (mcp__chrome-devtools__*)
  • Playwright MCP (mcp__playwright__*)
• User logged into Substack
• Python 3 with markdown package (pip install markdown)
• copy_to_clipboard.py script (shared from publish-zsxq-article skill)

Browser MCP Tool Mapping

This skill works with both Chrome DevTools MCP and Playwright MCP:

Action	Chrome DevTools MCP	Playwright MCP
Navigate	navigate_page	browser_navigate
Take snapshot	take_snapshot	browser_snapshot
Take screenshot	take_screenshot	browser_take_screenshot
Click element	click	browser_click
Fill text	fill	browser_type
Upload file	upload_file	browser_file_upload
Press key	press_key	browser_press_key
Evaluate JS	evaluate_script	browser_evaluate

Priority: Default to Playwright MCP. Use Chrome DevTools MCP only when Playwright MCP is unavailable.

Detection: At runtime, prefer mcp__playwright__browser_navigate. Fall back to mcp__chrome-devtools__navigate_page only if Playwright tools are not available.

Key URLs

• Substack dashboard: https://{publication}.substack.com/publish
• Post editor: https://{publication}.substack.com/publish/post/{postId}

Publication Resolution

The Substack publication subdomain (e.g., verysmallwoods in verysmallwoods.substack.com) is required to navigate to the dashboard. Do not hardcode a default.

Before any navigation, resolve the publication in this order:

1. Skill argument — if the user invoked the skill with a publication subdomain, use it.
2. Environment variable — check SUBSTACK_PUBLICATION (optional, for users who publish repeatedly to the same publication).
3. Prompt the user if neither is available:

   请提供 Substack publication subdomain（例如 verysmallwoods.substack.com 里的 verysmallwoods）。