用途:从 CLI 管理 Substack 出版物,基于浏览器会话 cookie 调用 Substack 内部 JSON API;用纯 Markdown 写作,技能会将其转换为 Substack 的 ProseMirror 编辑器格式,并可在获取草稿时转回。
主要能力:账户相关命令可验证登录、列出板块;读取命令可列出已发布/草稿/定时帖子、取回草稿或已发布文章;写作命令可创建、更新草稿(本地图片自动上传到 Substack CDN)、单独上传图片;发布命令支持发布并群发邮件、仅发布到网页、定时与取消定时、删除草稿。所有命令输出 JSON,出错时非零退出。
使用方式:首次需在浏览器登录 Substack,从 DevTools 复制 substack.sid cookie,然后运行 python3 ~/.claude/skills/substack-skill/substack_skill.py setup,输入账号标签、出版物 URL 和 cookie,保存到 config.json。多账号通过 -a ACCOUNT 覆盖默认账号。会话约三个月,出现 auth_failed 时重新获取 cookie 并以同一标签重跑 setup。
限制:发布或定时前必须向用户展示标题与正文摘要、说明是否群发邮件并等待明确同意,群发不可撤回;create-draft / update-draft 无需确认。update-draft --body-md 会整体覆盖正文,破坏原有编辑器控件(按钮、投票、付费墙)。Markdown 支持标题、段落、粗体、斜体、代码、删除线、链接、列表(一层嵌套)、引用、围栏代码块、水平线和图片;不支持表格、LaTeX,多段列表项也不支持。使用的为非官方 API,端点可能变更,无官方文档说明速率限制,技能会对 429/5xx 退避重试。需 Python 3.9+,仅标准库。cookie 等同于登录会话,存于本地并被 gitignore,可通过登出该浏览器会话或改密码撤销。