Substack Publisher MCP

substack-publisher-mcp

Substack 官方 Publisher API 的 MCP 服务

**注意：**这是一个非官方的社区开发工具，与 Substack, Inc. 无关，未获其认可或支持。

一个用于 Substack 官方 Publisher API 的 MCP 服务。通过 Claude、Cursor 或任何 MCP 客户端搜索和阅读文章、获取文章分析数据和订阅者数量，以及查询订阅者。所有工具均为只读。

为什么选择此服务？

先决条件

• Node.js 22+。 使用 node --version 检查；如果尚未安装，请从 nodejs.org 安装。
• Substack Publisher API 密钥。 在你的出版物 Substack 控制面板中生成。如果那里没有 Publisher API 选项，可能是你的出版物尚未启用该功能；请查看 Publisher API 文档了解是否可用。

快速开始

1. 安装

git clone https://github.com/dkships/substack-publisher-mcp.git
cd substack-publisher-mcp
npm install && npm run build

2. 配置 MCP 客户端

将以下内容添加到客户端的 MCP 配置文件中（如果文件不存在，请创建该文件）：

{
  "mcpServers": {
    "substack": {
      "command": "node",
      "args": ["/path/to/substack-publisher-mcp/dist/index.js"],
      "env": {
        "SUBSTACK_API_KEY": "your-api-key-here"
      }
    }
  }
}

**Claude Code 用户：**在服务配置中添加 "type": "stdio"。

编辑配置后，重启 MCP 客户端——服务会在启动时加载。

3. 开始使用

向 Claude（或你的 MCP 客户端）提问：

• “我配置了哪些 Substack 出版物？”
• “显示我上个月的文章”
• “查找我关于定价的文章”
• “打开 slug 为 my-latest-post 的文章”
• “我最新的文章有多少次打开和点击？”
• “过去 30 天的订阅者数量是多少？”
• “查询订阅者 [email protected]”

通过 AI Agent 或注册表安装？请查看 llms-install.md，了解精简的机器可读设置指南。

工具

除 list_publications 外，如果配置了多个出版物，所有工具都接受可选的 publication 参数。

默认情况下，get_post 以 Markdown 格式返回文章正文。Substack 会将正文作为 JSON 编码的 ProseMirror 文档发送，通常大小约为 Markdown 的两倍。传入 bodyFormat: "prosemirror" 可获取原始文档，传入 "none" 则仅获取元数据。

日期筛选条件使用 YYYY-MM-DD 格式。在 list_posts 中，endDate 不包含在内；在 get_subscriber_counts 中则包含在内。

示例响应

[
  {
    "date": "2025-01-15",
    "total_email_subscribers": 25000,
    "paid_subscribers": 500,
    "free_trial_subscribers": 10,
    "comp_subscribers": 50,
    "gift_subscribers": 15,
    "lifetime_subscribers": 0,
    "founding_subscribers": 25
  }
]

{
  "clicks": 320,
  "opens": 5400,
  "post_id": 12345678,
  "recipients": 10000,
  "views": 6100,
  "new_free_subscriptions": 80,
  "new_paid_subscriptions": 5,
  "estimated_revenue_increase": 400
}

{
  "posts": [
    {
      "post_id": 12345678,
      "title": "My Latest Post",
      "audience": "only_paid",
      "subtitle": "A deep dive into the topic",
      "postDate": "2025-01-15T12:00:00.000Z",
      "urlSlug": "my-latest-post",
      "coverImage": "https://substackcdn.com/image/..."
    }
  ],
  "next": "abc123cursor"
}

多个出版物

如果你管理多个 Substack 出版物，请使用 SUBSTACK_API_KEY_<NAME> 模式为每个出版物配置单独的 API 密钥：

{
  "mcpServers": {
    "substack": {
      "command": "node",
      "args": ["/path/to/substack-publisher-mcp/dist/index.js"],
      "env": {
        "SUBSTACK_API_KEY_MAIN": "your-main-blog-key",
        "SUBSTACK_API_KEY_TECH": "your-tech-newsletter-key",
        "SUBSTACK_API_KEY_COMPANY": "your-company-updates-key"
      }
    }
  }
}

然后指定要查询的出版物：

“显示 main 的订阅者数量” “列出 tech 出版物的近期帖子”

使用 list_publications 查看所有已配置的出版物名称。

故障排除

API 参考

此服务封装了 Substack Publisher API。有关可用数据和速率限制的详情，请参阅 Substack 文档。

贡献

请参阅 CONTRIBUTING.md 了解相关指南。

许可证

MIT 许可证。详情请参阅 LICENSE。

Substack 是 Substack, Inc. 的商标。本项目与 Substack, Inc. 无关。使用 Substack 名称仅用于描述目的。