substack-post

用途：将本地 Markdown 博客文件自动发布到 Substack，使用 Playwright MCP 浏览器工具完成登录、编辑与保存草稿。默认保存为草稿，发布前需用户确认。\n\n主要能力：支持草稿或发布两种操作；从文件中解析标题与副标题，支持去除 YAML/TOML frontmatter；标题解析顺序为显式输入、frontmatter title、正文首个 H1、文件名（通用文件名如 index、README、post 则用父目录名）；副标题取自 frontmatter 的 subtitle、description、summary、excerpt 或留空；登录时点击"Sign in with password"链接后填入邮箱与密码。\n\n必要条件与安装：需安装并配置 Playwright MCP 服务器，执行 npx playwright install 安装浏览器；在 Codex MCP 配置中加入 playwright 服务器，命令为 npx、参数为 @playwright/mcp@latest。凭据通过环境变量提供：SUBSTACK_EMAIL、SUBSTACK_PASSWORD（仅显式密码有效，仅用魔法链接的账号会失败）、可选 SUBSTACK_PUBLICATION（发布子域名）。可在项目根目录创建 .socials 文件并加入 .gitignore，或直接导出环境变量；凭据不得硬编码。\n\n使用方式：提供必填的本地 Markdown 文件路径；可选标题、副标题和操作（draft 或 publish）。流程包括读取凭据、解析文件、登录、打开编辑器、填写内容、保存草稿与发布确认。填写正文时应按标题行拆分粘贴，因为 Substack 只在行首输入 #、##、### 并按下空格时才自动转标题。\n\n限制：Markdown 自动转换不完整，代码块、图片和表格粘贴后无法正常渲染；草稿发布前为私有，默认停在草稿；仅魔法链接账号无法使用；遇到验证码、设备检查或双重验证需用户在同一浏览器会话完成；密码登录失败时需用户在账号设置中设置密码；登录限流需等待几分钟。