子堆栈发行商mcp
Substack官方发行商API的MCP服务器
注： 这是一个非官方的、社区开发的工具，不隶属于、认可或支持Substack，股份有限公司。
Substack官方的第一台MCP服务器 发布商API.直接从Claude、Cursor或任何MCP客户端查询帖子分析、订阅者计数和发布数据。
为什么是这个服务器？
| substack发布者mcp | 其他substack mcp服务器 | |
|---|---|---|
| API | 官方发行商API | 非官方内部API |
| 认证 | API密钥（稳定） | 浏览器cookie（脆弱） |
| 稳定性 | API官方文件 | 当Substack改变内部结构时中断 |
| 多出版物 | 内置支持 | 不可用 |
先决条件
- Node.js 18+
- Substack Publisher API密钥 --可从 发布者API文档
快速开始
1.安装
git clone https://github.com/dkships/substack-publisher-mcp.git
cd substack-publisher-mcp
npm install && npm run build2.配置您的MCP客户端
添加到客户的MCP配置文件中：
| 客户端 | 配置文件 |
|---|---|
| 克劳德桌面（macOS） | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 克劳德桌面（Windows） | %APPDATA%\Claude\claude_desktop_config.json |
| 克劳德代码 | .mcp.json 在您的项目目录中 |
| 光标 | .cursor/mcp.json |
{
"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" 到服务器配置。3.开始使用它
问克劳德： *“显示我最近的帖子”* 或 *“过去30天我的订阅人数是多少？”*
工具
| 工具 | 说明 | 关键参数 |
|---|---|---|
list_publications | 列出已配置的发布 | 无 |
list_posts | 列出已发布的帖子 | startDate, endDate, sortBy, type, maxResults, next |
get_post | 通过URL slug获取特定帖子 | urlSlug （必填） |
get_post_stats | 获取帖子的参与度统计数据 | urlSlug （必填） |
get_subscriber_counts | 按类型获取每日订阅人数 | startDate, endDate |
get_subscriber | 通过电子邮件查找订阅者 | email （必填） |
所有工具都接受可选 publication 配置多个发布时的参数。
示例响应
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
}
]get_post_stats
{
"clicks": 320,
"opens": 5400,
"post_id": 12345678,
"recipients": 10000,
"views": 6100,
"new_free_subscriptions": 80,
"new_paid_subscriptions": 5,
"estimated_revenue_increase": 400
}list_posts
{
"posts": [
{
"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_ 图案：
{
"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的订阅者数量”* *“列出科技出版物的最新帖子”*
使用 list_publications 查看所有已配置的发布名称。
故障排除
| 问题 | 解决方案 |
|---|---|
Unauthorized error | 验证您的API密钥是否正确。钥匙直接插入 authorization 无标题 Bearer 前缀。 |
Missing environment variables 警告 | 仅为您有密钥的发布配置环境变量。移除其余部分 |
| 服务器无法启动 | 请确保您已运行 npm run build 克隆后。服务器从运行 dist/，不 src/. |
No API keys configured | 设置 SUBSTACK_API_KEY 或 SUBSTACK_API_KEY_ 在您的MCP客户端配置中。 |
API 参考
此服务器包装 Substack发布商API有关可用数据和速率限制的详细信息，请参阅Substack的文档。
贡献
看 贡献.md 作为指导方针。
许可证
MIT许可证。看 许可证 了解详情。
______________________________________________________________________
Substack是Substack，股份有限公司的商标。本项目不隶属于Substack（股份有限公司）。Substack名称的使用仅用于说明目的。