关于 mcp-substack-scraper
mcp-substack-scraper 是通过 Apify Actor 获取 Substack 刊物资料和文章数据的 MCP 服务,适用于研究人员和新闻简报分析者,可查询订阅数据、文章详情并按关键词搜索。
主要功能
- 01刊物资料与订阅人数
- 02文章元数据及可选正文
- 03按关键词搜索文章
- 04按时间和数量筛选文章
适用场景
- 01比较订阅人数与套餐价格
- 02按主题查找新闻简报
- 03查看近期文章及访问级别
MCP 相关
它向 MCP 客户端提供 `scrape_substack` 工具,负责启动 Apify Actor、等待任务完成并返回数据集行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
1收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| proxy_mode | enum | 否 | 页面的获取方式。默认值为 auto。auto | direct |
| since_days | string | 否 | 可选。超过指定天数的文章将被跳过。0 或留空表示保留所有文章,直至达到上限。默认值为 0。 |
| include_body | string | 否 | 设为 true 可在所列出版物的每篇文章行中添加文章正文(最多 20,000 个字符)。付费文章会提供免费预览。每篇文章多读取一页;不额外收费。默认值为 false。 |
| publications | array | 否 | Substack 出版物,每行一个,最多 100 个:URL(https://www.lennysnewsletter.com)、域名(lenny.substack.com)、个人资料(substack.com/@lenny)或 Substack 名称(lenny)。每项都会返回一条出版物记录及其最新文章。 |
| search_output | enum | 否 | 搜索查询返回的内容。默认为文章。posts | publications |
| max_charge_usd | string | 否 | 可选。运行将在费用超过此金额前停止。 |
| search_queries | array | 否 | 用于搜索 Substack 文章的关键词,每行一个,最多 20 个。每个查询都会返回匹配的文章;如果 Search output 为 publications,则返回这些文章所属的出版物。 |
| max_search_results | string | 否 | 每个搜索查询返回的记录数,范围为 1 至 1000。默认值为 50。 |
| include_publication_row | string | 否 | true 表示为每个列出的出版物返回一条出版物记录(名称、著者、订阅者、付费方案价格),并按出版物记录计费。false 表示仅返回文章记录。默认值为 true。 |
| max_posts_per_publication | string | 否 | 每个出版物返回的最新文章数,范围为 0 至 1000。0 表示仅返回出版物记录。默认值为 20。 |
详细介绍
Substack 爬取 MCP 服务
这是一个 MCP 服务,用于调用 Mamba Labs 在 Apify 上的 Substack Newsletter and Posts Scraper Actor。输入 Substack 出版物或关键词,即可获取出版物档案和文章的扁平化数据行。
内容概览
功能介绍
- 出版物:名称、作者、标语、Substack 显示的订阅者数量(
subscriber_count_text,以及数值形式的subscriber_count_min)、订阅层级文本,以及月度、年度和创始会员方案的价格。 - 文章:标题、URL、日期、
audience(免费、付费或创始会员)、点赞数、评论数、转发数、字数、署名和标签。可通过include_body选择是否包含文章正文。 - 搜索:按关键词搜索 Substack 文章,结果可按文章返回,也可按文章所属的出版物返回。
所有任务都在 Apify 上运行。此软件包是一个轻量客户端,用于启动 Actor 运行、等待运行完成并返回数据集行。
快速开始
你需要 Node.js 18 或更高版本,以及带有 API 令牌的 Apify 账号。
将以下内容添加到 Claude Desktop 配置(claude_desktop_config.json)、Cursor 或任意 MCP 客户端中:
{
"mcpServers": {
"mamba-substack-scraper": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-substack-scraper"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
重启客户端后,就会看到 scrape_substack 工具。
前提条件
- Node.js 18 或更高版本。
- 从 console.apify.com/account/integrations 获取 Apify API 令牌,并将其设置为
APIFY_TOKEN。服务无需令牌即可列出工具,但调用工具时需要令牌。
示例提示词
- “Lenny's Newsletter 有多少订阅者?付费方案多少钱?”
- “查找有关冷邮件的 Substack 新闻简报,并列出它们的订阅者数量。”
- “notboring.co 在过去 30 天发布了什么?哪些文章仅限付费用户阅读?”
工具
scrape_substack。共一个工具。示例参数:
{
"publications": [
"lenny.substack.com"
],
"search_queries": [
"cold email"
],
"max_posts_per_publication": "5",
"max_search_results": "5"
}
输入
Actor 面向买家的所有输入,均保持不变。省略的输入将使用 Actor 自身的默认值。数字和布尔值均以字符串形式发送。
| 输入 | 类型 | 描述 |
|---|---|---|
publications | array | Substack 出版物,每行一个,最多 100 个:URL(https://www.lennysnewsletter.com)、域名(lenny.substack.com)、个人资料(substack.com/@lenny)或裸 Substack 名称(lenny)。每个条目都会返回一行出版物信息及其最新文章 |
search_queries | array | 用于搜索 Substack 文章的关键词,每行一个,最多 20 个。每个查询都会返回匹配的文章;如果搜索输出为出版物,则返回这些文章所属的出版物 |
search_output | string | 搜索查询返回的内容,默认:文章 |
max_posts_per_publication | string | 每个出版物返回的最新文章数,范围为 0 到 1000。0 表示只返回出版物信息行,默认:20 |
max_search_results | string | 每个搜索查询返回的行数,范围为 1 到 1000,默认:50 |
since_days | string | 可选。跳过早于指定天数的文章。0 或留空表示保留所有文章,直到达到上限,默认:0 |
include_publication_row | string | true 表示每个列出的出版物返回一行出版物信息(名称、作者、订阅者、付费套餐价格),按出版物信息行计费。false 表示仅返回文章行,默认:true |
include_body | string | true 表示在每个列出的出版物的文章行中添加文章正文(最多 20,000 个字符)。付费文章会提供免费预览。每篇文章会多读取一页;不额外收费,默认:false |
max_charge_usd | string | 可选。如果费用将超过此金额,则运行会在此之前停止 |
proxy_mode | string | 获取页面的方式,默认:auto |
定价
在 Apify 上按事件付费,费用计入你的 Apify 账户。价格以 USD 计。
| 事件 | 免费套餐 | Bronze | Silver | Gold |
|---|---|---|---|---|
post-row,一篇 Substack 文章作为一行返回:来自已列出的出版物或搜索结果 | $0.00115 | $0.001093 | $0.001035 | $0.000977 |
publication-row,一个 Substack 出版物资料作为一行返回:名称、作者、显示的订阅者数量及付费套餐价格 | $0.002 | $0.0019 | $0.0018 | $0.0017 |
apify-actor-start,每次运行启动 | $0.001057 | $0.001057 | $0.001057 | $0.001057 |
no_results 和 error 行免费,包括因输入被拒绝而返回的那一行。
你的密钥
此 Actor 无需密钥。它会读取 Substack 的公开页面和公开 JSON 路由,不持有任何密钥。代理流量不会增加费用:Mamba Labs 承担运行的平台成本。
Actor 完整文档
apify.com/mambalabs/substack-scraper
许可证
MIT。请参阅 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。