指南
如何将任何网站转化为变更检测 API
您关注的大多数网页永远不会提供官方 API。竞品定价、供应商服务条款 PDF、监管机构通告、合作伙伴更新日志：数据就在 HTML 代码中，却没有任何可调用的接口。您有三个现实选择：自建爬虫并承担无穷无尽的维护崩溃；向爬虫 API 付费以按需提取整个网页；或者将网页转化为变更订阅源——由监控器替您值守，并在确实发生重要变更时向您推送 JSON。本文将介绍如何使用 Page Deltas 端到端实现这第三种方案。
免费套餐 · 10 个监控 URL 或站点地图 · 无限次检查（尽力而为） · AI 过滤与摘要 · 所有套餐均支持 REST API、MCP 和签名 Webhook · 无需信用卡
{
"event": "sitemap.new_urls",
"monitor": "https://www.hubspot.com/sitemap.xml",
"detected_at": "2026-06-15T19:30:00Z",
"new_urls": [
"https://www.hubspot.com/case-studies/workleap",
"https://www.hubspot.com/products/artificial-intelligence/use-cases/sales-meeting-prep-and-follow-up",
"https://www.hubspot.com/email-signature-generator/create-rules-gmail"
]
}自建爬虫 vs 爬虫 API vs 变更订阅源
中肯的经验法则：如果您需要采集数千个页面作为数据集，请使用爬虫 API。如果您需要知道某个公开页面何时发生了符合特定要求的变更，变更订阅源的代码量更少，日常维护也轻松得多。
自建爬虫
您获得的内容：需要自行解析的原始 HTML。最适合对特殊网站进行全量控制。开发与维护成本极高（选择器、代理、渲染、重试）。一旦目标网站改版，解析器便会静默失效。数据时效性取决于定时任务（cron）的执行频率。典型成本：服务器基础设施加您宝贵的时间。
爬虫 API
您获得的内容：按次请求返回的结构化数据。最适合批量抓取大量页面。开发成本低至中等。服务商会替您承担大部分页面结构变动引发的故障。数据时效性取决于您何时发起请求。典型成本：按请求次数购买的点数。
变更订阅源（本指南）
您获得的内容：发生实质性变更时附带 AI 摘要的 JSON 事件。最适合“当此页面发生变更时通知我的系统”。开发成本极低：只需创建一次监控器，然后配置 Webhook 或进行轮询。内容提取与大模型（LLM）指令共同判定何为关键变更。自适应检查频率，匹配成功时直接推送到您的接口。按套餐内监控 URL 数量计费（Page Deltas 不对检查次数单独计费）。
您将构建的内容
基础 URL：https://api.pagedeltas.com。所有端点均位于 /api 路径下。成功的响应返回 JSON 格式。
账户与 API 密钥
创建免费的 Page Deltas 组织并生成 API 密钥。
带指令（Brief）的监控器
针对公开 URL 创建监控器，并附带自然语言指令（即过滤条件）。
轮询或 Webhook
轮询 GET /api/monitors/{id}/changes，或绑定通用 Webhook 渠道，以便在发生匹配时通过 POST 向您的应用发送签名 JSON。
可选的 MCP 协议集成
通过 MCP 将同一密钥连接到 Claude、Cursor 或 VS Code。
配置步骤：将页面转化为变更订阅源
从 API 密钥到签名 Webhook 仅需五步。若希望被动接收推送而非主动拉取，建议优先选用 Webhook。
创建账户与 API 密钥
在 pagedeltas.com/register 注册。无需信用卡。免费套餐：10 个监控 URL 或站点地图，无限次检查（尽力而为频率），AI 过滤与摘要，无团队成员人数限制，支持 Slack / Discord / Teams / 邮件 / 签名 Webhook，14 天历史记录，包含 REST API 和 MCP。在应用中：Settings → API keys（editor 或 admin 权限）。创建密钥并立即妥善复制；密钥仅展示一次。export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"。密钥归属于组织范围，并在该组织内具备管理员级别权限。密钥不与具体个人绑定，因此移除团队成员不会导致密钥失效。如需撤销权限，请直接删除该密钥。请将密钥视为密码妥善保管：存储于环境变量或保密管理服务中，切勿提交至代码仓库配置文件中。
创建监控器（cURL）
发起 POST 请求至 https://api.pagedeltas.com/api/monitors，携带请求头 Authorization: Bearer $PAGEDELTAS_TOKEN，请求体为 JSON：url、nl_description（指令）、可选的 filter_prompt 以及 channel_ids: []。指令示例：“竞品定价页面。当任何套餐价格发生变动、新增或移除套餐、或配额与限额调整时发送告警。忽略 Cookie 弹窗、A/B 测试布局以及轮播客户评价。”系统无需设置检查频率字段。检查节奏为自适应模式（活跃页面检查更频繁，静态页面检查间隔更长；付费套餐享有优先检查）。使用 POST /api/monitors/{id}/check-now 可按需立即触发单次检查（限流为每分钟每个监控器 1 次）。nl_description 是大语言模型判断变更是否关键的判定标准。如果指令过于宽泛，您的 Webhook 将沦为无休止的视觉差异信息洪流。可选参数：filter_prompt、css_selector、xpath_selector、is_pdf 和 channel_ids（单个监控器覆盖渠道；留空则继承组织默认配置）。仅支持公开网页。目前尚不支持需要登录的页面。若需求是“是否出现了全新 URL”而非“现有页面是否被重写”，请使用独立的站点地图监控资源（/api/sitemap-monitors）。
轮询变更订阅源
携带 Bearer 令牌请求 GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50。结果按最新变更在前排序（默认 50 条，上限 100 条）。无分页游标（cursor）。请在本地记录已处理过的最新 detected_at 时间戳。每条变更数据均包含 id、detected_at 和 summary：即由 AI 生成的符合指令要求的清晰语言描述，而非晦涩难懂的原始 HTML diff。您可以将 summary 直接对接到 Slack、工单系统或下游智能体。
使用 Python 创建与轮询
使用 requests 库，添加 Authorization Bearer 和 Content-Type application/json 请求头。通过 POST /api/monitors 提交 url、nl_description 和 channel_ids: []。从返回中读取 monitor["id"]。随后通过 GET /api/monitors/{monitor_id}/changes（limit=50）查询，并打印每条变更的 detected_at 与 summary。如需轮询，请通过定时任务执行。如果希望通过事件推送获取数据，建议优先使用 Webhook。
免去轮询，接收主动推送的 JSON（HMAC 签名 Webhook）
在应用中：Channels → Add a channel → Generic webhook。粘贴您的 HTTPS 接收端 URL。当密钥显示时（仅展示一次），立即复制渠道密钥（Channel Secret）。点击 Send test。或者通过 API 创建渠道（POST /api/alert-channels），然后通过 PUT /api/monitors/{id}/alert-channels 进行关联；也可以将 channel_ids 留空以沿用组织默认配置。每次发生符合条件的变更时，系统都会向您的 URL 发送 POST 请求，传输扁平结构的 JSON 数据，请求头包含 Content-Type application/json 和 X-Signature: sha256=<hex>。字段包含 event (change.detected)、monitor_id、monitor_url、monitor_name、change_id、detected_at、summary、before_screenshot_url、after_screenshot_url 以及 dashboard_url。使用您的渠道密钥计算原始请求体数据的 HMAC-SHA256，即可验证 X-Signature（请求头格式为 sha256=<hex>）。必须在解析 JSON 之前针对原始请求字节进行哈希计算，否则验证将失败。后续可能会增加新字段：代码中请忽略未知键。推送说明：目前针对每个渠道每次告警仅尝试投递一次（无自动重试机制），请确保快速响应并在接口端实现幂等处理。非 2xx 响应或网络故障将标记该次投递失败；监控器本身不会因推送失败而暂停。所有推送尝试都会在服务端留存审计日志。如需向团队成员而非系统推送，可按相同逻辑配置 Slack、Discord、Teams 或邮件渠道。Slack 配置步骤详见《如何在 Slack 中接收网站变更提醒》。
可选：通过 Claude、Cursor 或 VS Code 控制监控器（MCP）
使用相同的 API 密钥。支持流式传输的 HTTP MCP 端点：https://api.pagedeltas.com/mcp。智能体可调用 create_monitor、list_monitor_changes、create_alert_channel 和站点地图辅助工具。MCP 协议不支持 Cookie 会话认证。对于无需频繁轮询的事件驱动型系统，建议首选 Webhook 渠道。
Cursor mcp.json
在 ~/.cursor/mcp.json 中将 mcpServers.pagedeltas.url 设置为 https://api.pagedeltas.com/mcp，并将 headers.Authorization 设置为 Bearer pdt_xxxxxxxx。重启 Cursor 即可加载相关工具。
您的自然语言指令就是查询语言
在传统 REST API 中，您通过查询参数（query params）进行过滤。而在变更订阅源中，过滤条件就是您在监控器上配置的自然语言指令。Page Deltas 提取网页内容，与上次检查进行对比，并让大模型判定该差异是否符合您的指令要求。符合条件的提醒将附带文字摘要和修改前后的截图。编写指令时，就像向同事交代工作任务一样清晰明确即可。
价格调整
某个套餐价格变动，或推出了新的套餐档位。
招标采购 / RFP
在我们业务范围内发布了新的招标项目。
API 文档更新
API 文档新增、下线或标记废弃了某个接口。
招聘动态
发布了资深工程师职位招聘；忽略非技术类岗位。
真正重要的配额（以及无需在意的配额）
在 Page Deltas，您需要规划的核心限制是监控的 URL（或站点地图）数量，而非每月的检查次数配额。在合理使用范围内，API 的读写端点目前没有基于请求频次的额外计费卡点。唯一的例外是 check-now：每个监控器每分钟限流 1 次请求（超限返回 429 和 Retry-After 请求头）。达到套餐的 URL 数量上限时将返回 422 状态码，并附带当前数量与限制值。按检查次数收费的传统工具强迫您费心计算（“单页面每小时检查一次 ≈ 每月 720 次检查”）。在这里，您只需选定页面并撰写指令，检查节奏由系统自适应调节。
Free
10 个监控 URL · 14 天历史 · 无限次检查（尽力而为）、AI、API、MCP、全部 5 种告警渠道 · $0
Starter
150 个监控 URL · 30 天历史 · $29/月 · 优先检查通道
Pro
1,000 个监控 URL · 90 天历史 · $79/月
Business
5,000 个监控 URL · 365 天历史 · $199/月
Scale
20,000 个监控 URL · 730 天历史 · $499/月
Enterprise
定制 URL 数量与历史保留时长 · 支持 SSO / SCIM
与 Visualping 类变更 API 的核心差异
Visualping 面向开发者的方案重度依赖固定轮询间隔、可选的 CSS/XPath 范围定位、按月限制的检查配额，以及包含大量像素差异与重要性标记的复杂 Webhook 载荷。如果需求是“当页面像素移动时触发，后续完全交给我的代码判断”，这种方式是适用的。而 Page Deltas 则专为“仅当变更符合此项指令时才唤醒我的系统”而生。本文是技术接入指南；两款产品的逐项套餐对比详见《Page Deltas vs Visualping》。
自然语言指令优先
首要过滤条件是自然语言指令。选择器仅为可选辅助项，非必填。
自适应检查节奏
无需手动填写时间间隔。更新频繁的页面检查更密，稳定的页面检查间隔更长。
扁平易用的 Webhook 载荷
以文字摘要（summary）、截图 URL 及 HMAC X-Signature 签名校验为核心。
无限次检查；仅按 URL 数量付费
所有套餐均包含无限次检查。您只需根据所监控的 URL 数量付费。
通用 API 密钥直连 MCP
MCP 与 REST 接口共用同一组 API 密钥。
坦诚相告的产品边界
在将生产环境接入之前，请明确了解该变更订阅源适用的与不适用的边界场景。
仅支持公开网页
营销网站、公开 PDF、公开招聘主页、公开站点地图。需要登录验证的门户已在路线图中，但目前尚未支持。
并非视觉回归或页面防篡改监控工具
如果任务是“这个像素是否向右偏移了 20px”，专用的视觉差异对比工具仍然是更好的选择。
不支持 LinkedIn 或 X 社交动态监控
Page Deltas 监控的是开放网络。针对个人的 LinkedIn/X 动态监控请使用 MultiFollow；针对跨平台社交媒体的关键词提及监控请使用 KWatch。
Webhook 目前采用单次推送机制
请将您的接收端设计为幂等处理。
相关指南与文档
适用于团队的 Slack 深度配置、免代码快速入门以及实时 API 规范。
常见问题
- 如何从没有 API 的网站获取数据？
- 有三种途径：自行编写爬虫、使用第三方爬虫 API 进行批量提取，或者使用变更监控 API 对准目标页面并消费其返回的 JSON 变更订阅源。针对“当此页面发生变动时通知我的系统”这一需求，变更订阅源通常所需代码量最少：创建监控器，然后配置 Webhook 或进行轮询即可。
- 无需编写代码可以完成配置吗？
- 完全可以。在控制台中创建监控器，在“Channels”中添加通用 Webhook（或 Slack / Teams / Discord / 邮件），填写指令后点击“Send test”。快速入门指南详细介绍了这一免代码流程。
- 爬虫 API 与变更监控 API 有什么区别？
- 爬虫 API 在您每次发起调用时提取整个网页的内容。变更监控 API 则持续追踪页面并仅输出发生的具体变化，且已预先计算好 AI 摘要。大体量数据抓取适合爬虫；而解答“是否发生了符合我要求的变动”则应选用变更订阅源。
- 使用 API 或 Webhook 需要额外付费吗？
- 不需要。包含 Free 免费版在内的所有套餐均内置 REST API、MCP 和签名 Webhook。使用额度完全取决于您套餐中的监控 URL 上限，不存在单独的 API 调用点数计费。
- AI 智能体可以帮我创建监控器吗？
- 可以。只需配置 MCP 客户端连接至 https://api.pagedeltas.com/mcp 并传入 Bearer API 密钥即可。详情请参阅 MCP 文档。
作者
Julien，Page Deltas 产品经理。挑选一个您平常经常需要手动刷新查看的公开 URL。注册一个免费账户，生成 API 密钥，用一句话指令创建监控器，绑定通用 Webhook，验证一次 HMAC 签名，然后静候第一次真实的变更推送即可。在收到首次可能带有杂音的提醒后微调忽略规则。这就是变更 API 部署的全部过程。
立即将第一个页面转化为变更订阅源
免费套餐，无需信用卡。创建账户，生成 API 密钥，填入您已在留意的网页 URL，参考过滤器指南输入一条指令，便可开始轮询 /changes 或向您自己的服务端接收签名 JSON 推送。