Substack Newsletter 出版物洞察
输入若干 Substack newsletter,每个返回一条出版物洞察记录:订阅数、付费开关、作者档案与基于近期文章的互动分析
概览
给一批 Substack newsletter 的地址,就每个返回一条「体检报告」:订阅数、是否开通付费订阅、作者是谁、更新勤不勤、读者爱不爱看——一眼看清一本 newsletter 的体量和活跃度。适合投放前的选号评估、同类刊物的竞品对比,或者从一批候选里筛出最值得合作的 KOL。
数据来自 Substack 的公开信息与公开文章归档,每次运行实时抓取,不需要任何登录或密钥。互动指标(平均点赞、评论、转发、发文频率、付费比例)基于「分析样本篇数」指定窗口内的近期文章计算,并给出样本的时间范围,方便判断指标的时效性。
数据说明
每个 newsletter 返回一条记录,「站点标识」是去 www. 的域名,跨多次运行稳定,可按它去重和追踪。「订阅数」来自平台公开的量级展示(如 1.2M+),换算为下限数字;约一半出版物不公开订阅数,此时「订阅数」为 0、「订阅数原文」为空——0 代表「未知」而不是「没人订阅」。「付费比例」和各类平均值只反映样本窗口(见「样本起始日」「样本截止日」),不是全量历史。所有时间是 UTC。不覆盖的内容:文章正文清单、评论具体内容、作者邮箱电话等联系方式、订阅数的历史变化。
结果长什么样
每条记录是一本 newsletter 的洞察。
| 出版物名称 | 订阅数原文 | 付费订阅 | 作者 | 平均点赞 | 周发文频率 |
|---|---|---|---|---|---|
| Lenny's Newsletter | 1.2M+ | 是 | Lenny Rachitsky | 442.5 | 0.81 |
| Astral Codex Ten | 是 | Scott Alexander | 335.6 | 3.05 |
另有简介、语言、自定义域名、创建时间、畅销标识、播客标记、样本时间范围、付费比例、最热文章等其他字段。
应用场景
- 投放选号:把候选 newsletter 一起跑一遍,用「订阅数原文」「平均点赞」「付费订阅」比体量与影响力,筛出值得投放的刊物。
- 竞品对比:对比同类刊物的「周发文频率」「付费比例」「平均评论」,看清对手的内容节奏和商业化打法。
- KOL 档案建设:用「站点标识」「作者」「作者 X 账号」「简介」沉淀一份可持续更新的媒体主档案库。
适用边界
单次最多 20 个 newsletter;互动分析基于最近的文章样本而非全量历史;订阅数约一半出版物不公开(隐藏时数字为 0、文案为空);不提供文章正文清单、评论内容、联系方式与跨运行历史快照
- 适合用于
- 需要评估一批 Substack newsletter 的体量与活跃度,做竞品分析、投放选号或 KOL 发现
- 需要订阅数、付费开关、作者档案等出版物级信息,而不是单篇文章清单
- 不要用于
- 要采集某本 newsletter 的逐篇文章清单或正文:应使用文章采集类应用
- 需要文章评论内容、作者邮箱电话等联系方式或订阅数的历史变化趋势
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1单个 newsletter 失败不影响其余结果;无法识别的输入会被跳过并在运行日志中说明
- 2临时网络失败或被限流时,稍后原样重试即可
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- Newsletter 列表
handles必填array<string>要洞察的 Substack newsletter,每个元素可填站点域名(如 www.lennysnewsletter.com)、任意链接或裸 handle(如 noahpinion),最多 20 个,自动去重数量最多 20 项示例["www.lennysnewsletter.com","www.astralcodexten.com"] - 分析样本篇数
max_posts_for_analytics选填integer从最新文章往前取多少篇来计算互动分析(平均点赞、发文频率等);默认 50范围1–200默认值50
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 站点标识
handlestringnewsletter 的站点域名标识(去掉 www.),同一出版物保持不变,可用来去重示例lennysnewsletter.com - 出版物名称
namestringnewsletter 的显示名称示例Lenny's Newsletter - 出版物链接
publication_urlstringnewsletter 的站点主页地址示例https://www.lennysnewsletter.com - 自定义域名
custom_domainstringnewsletter 绑定的自定义域名,未绑定则为空示例www.lennysnewsletter.com
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"handle": "lennysnewsletter.com",
"name": "Lenny's Newsletter",
"publication_url": "https://www.lennysnewsletter.com",
"custom_domain": "www.lennysnewsletter.com",
"description": "Deeply researched product, growth, and career advice for product leaders, founders, and ambitious builders.",
"language": "en",
"logo_url": "https://substackcdn.com/image/fetch/f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F441213db-4824-4e48-9d28-a3a18952cbfc_592x592.png",
"created_at": "2019-06-01T15:35:37.885Z",
"subscriber_count": 1200000,
"subscriber_count_text": "1.2M+",
"payments_enabled": true,
"is_bestseller": true,
"has_podcast": true,
"author_name": "Lenny Rachitsky",
"author_handle": "lenny",
"author_bio": "Writing • Angel investing • Advising",
"author_twitter": "lennysan",
"posts_sampled": 50,
"sample_from": "2025-09-02",
"sample_to": "2026-11-10",
"avg_reactions_per_post": 442.5,
"avg_comments_per_post": 14.6,
"avg_restacks_per_post": 29.4,
"avg_word_count": 3280,
"publish_cadence_per_week": 0.81,
"paid_post_ratio": 0.8,
"top_post_title": "How to turn your AI into a world-class designer",
"top_post_reactions": 1369,
"scraped_at": "2026-11-17T03:45:00.000Z"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderNexus/substack-insights-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。