substack-mcp：让智能体起草 Substack 文章、看订阅数据

写 Newsletter 的人，除了写，还要不停回头翻数据：哪篇打开率高，新订阅从哪来，上次聊过类似话题没有。substack-mcp 把 Substack 的后台搬进对话：智能体能搜你的文章存档、读数据、帮你起草，但长文永远停在草稿，发不发由你决定。截至 2026-10-06 约 40 star，是个小而用心的项目。

能做什么

• 存档和草稿：search_posts 搜存档，create_draft 用 Markdown 建草稿，preflight_draft 检查标题、受众、图片和付费墙设置，plan_draft_update 先给出改动方案，确认后 update_draft 才写入。
• 数据分析：get_post_analytics 看单篇的阅读、打开、订阅转化，rank_posts 按指标排序，get_publication_stats 和 get_growth_sources 看整体趋势和新订阅来源。
• Notes：create_note 和 create_note_with_link 发布短内容。Substack 的 Notes 没有草稿状态，这两个工具会立即公开发布。
• 订阅者：查订阅数和订阅者记录；add_free_subscriber 添加已同意订阅的读者，默认只做演练（dry run），实际添加要附上同意记录。

适合谁

• 定期更新 Substack 的作者，想让智能体先查自己写过什么、哪类选题表现好，再起草下一期。
• 管多个 Publication 的团队，用一个服务器按 publication 参数切换。
• 想把文章数据定期汇总成复盘报告的内容运营。

接入方式

需要 Node.js 22+。可以用浏览器登录自动保存会话（需额外装 Playwright），也可以手动从浏览器复制会话令牌，写进客户端配置：

{
  "mcpServers": {
    "substack": {
      "command": "npx",
      "args": ["-y", "@conorbronsdon/substack-mcp"],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
        "SUBSTACK_SESSION_TOKEN": "your-session-token",
        "SUBSTACK_USER_ID": "your-user-id"
      }
    }
  }
}

编辑点评

值得关注的原因是它对“智能体能做什么”想得很清楚：长文只能存草稿，删除和定时发布故意不做，唯一会立即公开的 Notes 在文档里写得醒目，添加订阅者默认演练。这种安全边界在内容类 MCP 里不多见。要清楚风险：Substack 没有公开 API，它用的是非官方接口，Substack 一改接口就可能失效；认证靠浏览器会话 Cookie，等同于把账号登录态交给它，令牌要妥善保管，这类用法是否符合 Substack 的服务条款也要你自己判断。这是作者个人项目，许可证为 MIT。