logo

Substack 文章关键词搜索

输入若干关键词,搜索 Substack 文章并返回每篇文章的标题、出版物、作者、互动数与播客信息;可指定出版物范围,也可全网搜索

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

概览

输入若干关键词,搜索 Substack 上的文章:每个搜索结果是一条记录,包含文章标题、副标题、链接、发布时间、所属出版物、作者、互动数据(点赞/评论/转发)、字数、标签,以及播客单集信息(时长、音频地址,仅播客类型有值)。同一篇文章命中多个关键词时只返回一条记录,「命中关键词」列合并列出全部命中词。

怎么用

  1. 搜索关键词(必填):1~10 个词,支持多词短语(如 product market fit)
  2. 出版物范围(可选):填 newsletter 域名或链接(最多 20 个)则只在这些出版物内搜索;留空则在全网 Substack 搜索
  3. 每个关键词的结果上限:默认 50,最大 200
  4. 包含文章正文:默认关。开启后逐篇请求详情接口补正文纯文本,运行时间约增加一倍

数据说明

数据来自 Substack 公开接口,无需登录、仅公开内容。文章按搜索匹配返回(不保证严格按时间排序);「文章 ID」跨关键词去重后作为主键,跨多次运行可按它去重。「点赞数」是文章收到的全部表情反应总数;所有时间是 UTC 时间。「是否付费帖」按受众判定;付费帖的正文可用性不保证,缺失时「正文纯文本」列为空、以「内容摘要」兜底。播客字段(时长、音频地址)只对播客类型的文章有值。

两种搜索路径的差异:指定出版物范围的搜索走该出版物的公开归档接口(已实测稳定);全网搜索走 substack.com 的公开搜索接口,结果排序与覆盖度以源站为准,且可能比出版物内搜索更慢。全网搜索结果里「出版物名称」可能识别不到(该列为空),但「出版物域名」「文章链接」始终可用。

不覆盖的内容

付费墙内保证完整的正文、评论的具体内容、Notes 流、出版物订阅人数、用户隐私数据。需要单个 newsletter 的完整文章列表请用「Substack Newsletter 文章批量采集」(substack-scraper);需要出版物的订阅数、作者档案、互动分析请用「Substack Newsletter 出版物洞察」(substack-insights-scraper)。

使用建议

  • 首跑建议用少量关键词 + 小上限验证输出符合预期,再放大批量
  • 竞品监测:把你关注的 newsletter 填进「出版物范围」,定期跑同一组关键词
  • 话题研究:留空出版物范围做全网发现,再用「出版物域名」列聚合看哪些 newsletter 在写这个话题

适用边界

每次最多 10 个关键词、每个关键词最多 200 条结果;只返回公开文章的元数据与可选正文,不采集评论内容、Notes 流或订阅者隐私数据;出版物内搜索为精确实测路径,全网搜索依赖 substack.com 公开搜索接口

  • 适合用于
  • 按主题关键词发现 Substack 上正在写什么的文章(如竞品监测、内容研究、话题趋势)
  • 跟踪特定关键词在指定一批 newsletter 里的出现情况
  • 查找某主题的播客单集(含时长与音频地址)
  • 不要用于
  • 需要拉取某个 newsletter 的完整文章列表(用 substack-scraper 更合适)
  • 需要出版物级别的订阅数、作者档案等洞察数据(用 substack-insights-scraper 更合适)
  • 需要付费墙内保证完整的正文、评论具体内容或用户隐私数据

失败处理

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

  1. 1全部搜索均无法访问时报 upstream-unreachable(网络类错误,可重试)
  2. 2部分出版物或关键词失败时跳过并在日志中说明原因,成功部分照常返回
  3. 3同一篇文章命中多个关键词时只推一条记录,matched_keywords 合并列出

输入参数

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

  • 搜索关键词keywords必填array<string>
    要搜索的 Substack 文章关键词,1~10 个,自动去重
    数量最多 10 项示例["product market fit","hiring"]
  • 出版物范围(可选)publications选填array<string>
    限定在这些 Substack newsletter(域名或链接,最多 20 个)内搜索;留空则在全网 Substack 搜索
    数量最多 20 项示例[]
  • 每个关键词的结果上限max_items_per_keyword选填integer
    每个关键词最多返回的文章条数;0 表示不限制(有平台保护上限)
    范围1–200默认值50示例50
  • 包含文章正文include_content选填boolean
    开启后逐篇请求详情接口补充正文纯文本(运行时间约增加一倍);关闭则只返回元数据和摘要
    默认值false示例false

输出数据

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

  • 文章 IDpost_idstring
    Substack 文章的唯一数字 ID,跨关键词去重后的主键
    示例224206488
  • 命中关键词matched_keywordsstring
    这篇文章命中的所有搜索关键词,逗号分隔
    示例hiring
  • 文章标题titlestring
    文章的完整标题
    示例Winning at early-stage hiring
  • 副标题subtitlestring
    文章副标题,可能为空

示例数据

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

output.example
{
  "post_id": "224206488",
  "matched_keywords": "hiring",
  "title": "Winning at early-stage hiring",
  "subtitle": "<subtitle>",
  "url": "https://www.lennysnewsletter.com/p/winning-at-early-stage-hiring",
  "published_at": "2026-03-01T12:00:00.000Z",
  "post_type": "newsletter",
  "audience": "everyone",
  "is_paid": false,
  "is_podcast": false,
  "podcast_duration_seconds": 0,
  "podcast_url": "<podcast_url>",
  "publication_name": "Lenny's Newsletter",
  "publication_domain": "www.lennysnewsletter.com",
  "author_name": "Lenny Rachitsky",
  "author_handle": "lennysan",
  "snippet": "<snippet>",
  "wordcount": 1500,
  "reaction_count": 120,
  "comment_count": 8,
  "restacks": 3,
  "tags": "[\"Career\"]",
  "cover_image": "<cover_image>",
  "body_text": "<body_text>",
  "scraped_at": "2026-11-17T04: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-posts-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 / 条