logo

Substack 文章评论与回复采集

输入若干篇 Substack 文章链接,采集公开评论区:每条评论/回复一行,含作者、正文、时间、点赞数与回复线程关系(父/根/层级)

发布者
价格
¥0.001 / 条
最近更新
2026-11-17

概览

输入若干篇 Substack 文章链接,采集公开评论区:每条评论/回复一行记录,包含作者(名称/handle/ID)、正文、发布时间、点赞数、转引数,以及完整的回复线程结构(父评论/根评论/层级深度)。一次运行支持 1~50 篇文章。

怎么用

  1. 文章链接(必填):1~50 个,格式为 https://<出版物域名>/p/<slug>(如 https://www.astralcodexten.com/p/ai-company-employees-should-unionize),自动去重。substack.com 域的帖子链接也能解析(该路径依赖 substack.com 全局接口,可靠性以实际运行为准)
  2. 包含回复:默认开启——展开整棵回复树,每条回复单独一行(「记录类型」= reply);关闭则只返回顶层评论,跑得最快
  3. 每篇文章评论上限:默认 200,最大 1000(含回复,按讨论顺序截断)

数据说明

数据来自 Substack 公开评论接口,无需登录、仅公开可见的评论。每条记录的「记录类型」区分顶层评论(comment)与回复(reply);「父评论 ID」是直接回复的那条评论,「根评论 ID」是所在讨论串最顶层的评论,「层级深度」顶层为 0、回复按嵌套递增——用这三个字段可以在结果里完整还原讨论串。「作者回复」= true 表示这条是文章作者本人的回复。

评论数口径:上游接口返回的是当前公开可见的评论树,与文章页面标注的评论数可能略有出入(被删除、审核隐藏的评论不会返回)。付费帖的评论公开接口拿不到(返回 0 条),这是上游限制,不是采集故障。

时间均为 UTC。「点赞数」是评论收到的全部表情反应总数。同一篇文章的「评论 ID」保持不变,跨多次运行可按它去重。

不覆盖的内容

文章正文与文章列表(用 substack-scraper)、按关键词搜索文章或出版物(用 substack-posts-scraper)、出版物的订阅数与定价洞察(用 substack-insights-scraper)、排行榜(用 substack-leaderboard-scraper)、Notes 流与评论者的隐私数据。

使用建议

  • 竞品口碑:采竞品热门文章的评论,看读者高频疑问与异议(「作者回复」列能看出官方是否下场)
  • 舆情/需求挖掘:配合「层级深度」聚合讨论串,顶层评论是话题、回复是讨论
  • 先用「包含回复 = false」的小批量试跑确认目标文章有公开评论,再开全量

适用边界

每次最多 50 篇文章、每篇最多 1000 条评论(含回复);仅公开评论区,付费帖评论上游不公开(返回 0 条);不包含评论者的私信或隐私数据,只返回评论者公开显示的名称与 handle

  • 适合用于
  • 收集某篇文章下的读者反馈、常见疑问与异议(竞品口碑分析)
  • 统计评论互动:谁在评论、多少人点赞、作者是否下场回复
  • 把评论区作为舆情/需求挖掘的数据源(含回复线程的完整结构)
  • 不要用于
  • 需要文章正文或文章列表(用 substack-scraper)
  • 需要按关键词搜文章或搜出版物(用 substack-posts-scraper)
  • 需要出版物的订阅数、定价等洞察档案(用 substack-insights-scraper)
  • 需要采集付费帖的评论(公开接口拿不到,会返回 0 条)

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1帖子链接先经 /api/v1/posts/{slug} 解析出数字 ID,再调公开评论接口拿整棵评论树(一次返回,无需翻页)
  2. 2单篇失败(链接无法识别、网络错误)跳过并在日志说明,其余文章照常返回
  3. 3全部文章都失败时:网络类报 upstream-unreachable(可重试),链接全部无效报 invalid-input

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 文章链接post_urls必填array<string>
    要采集评论的 Substack 文章链接,1~50 个;格式为 https://<出版物域名>/p/<slug>(如 https://www.astralcodexten.com/p/xxx),自动去重
    数量最多 50 项示例["https://www.astralcodexten.com/p/ai-company-employees-should-unionize"]
  • 包含回复include_replies选填boolean
    true(默认)展开整棵回复树,每条回复单独一行(comment_type=reply);false 只返回顶层评论
    默认值true示例true
  • 每篇文章评论上限max_comments_per_post选填integer
    每篇文章最多返回的评论+回复条数(按讨论顺序截断,1~1000)
    范围1–1000默认值200示例200

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 评论 IDcomment_idstring
    Substack 评论/回复的唯一数字 ID(字符串形式),本 App 的去重主键
    示例385948650
  • 文章 IDpost_idstring
    评论所属文章的 Substack 数字 ID(字符串形式)
    示例224550256
  • 文章标题post_titlestring
    评论所属文章的标题
    示例AI company employees should unionize
  • 文章链接post_urlstring
    评论所属文章的链接(出版物域名形式)
    示例https://www.astralcodexten.com/p/ai-company-employees-should-unionize

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "comment_id": "385948650",
  "post_id": "224550256",
  "post_title": "AI company employees should unionize",
  "post_url": "https://www.astralcodexten.com/p/ai-company-employees-should-unionize",
  "publication_domain": "www.astralcodexten.com",
  "comment_type": "comment",
  "parent_comment_id": "<parent_comment_id>",
  "root_comment_id": "385948650",
  "depth": 0,
  "author_name": "Olivia Horbowy",
  "author_handle": "oliviahorbowy",
  "author_id": "555638155",
  "body_text": "Great ideas here. One thing I'd add, from a legal perspective...",
  "published_at": "2026-11-12T23:22:48.899Z",
  "reaction_count": 18,
  "restacks": 0,
  "is_author_reply": false,
  "scraped_at": "2026-11-17T07:00: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 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=SpiderNexus/substack-comments-scraper",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

每次运行受理费

每提交一次任务计费一次,与返回条数无关。

¥0.1/ 次
每条评论/回复

按实际成功返回的数据条数计费,任务失败不计费。

¥0.001/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.001 / 条