Leitfaden

So verwandeln Sie jede Webseite in eine Änderungs-API

Die meisten Seiten, die für Sie wichtig sind, werden niemals eine API anbieten. Preise von Wettbewerbern, AGB-PDFs von Dienstleistern, behördliche Verzeichnisse, Changelogs von Partnern: Die Daten liegen direkt im HTML, aber es gibt keinen Endpunkt zum Abrufen. Es gibt drei realistische Optionen: Einen eigenen Scraper bauen und ständige Wartungsabbrüche hinnehmen; eine Scraping-API bezahlen, um die gesamte Seite bei Bedarf auszulesen; oder die Seite in einen Änderungs-Feed verwandeln — ein Monitor, der die Seite für Sie beobachtet und JSON nur dann pusht, wenn sich wirklich etwas Relevantes geändert hat. Dieser Artikel beschreibt diesen dritten Weg von Anfang bis Ende mit Page Deltas.

Kostenlos mit dem Überwachen beginnen Preise ansehen

Kostenloser Tarif · 10 überwachte URLs oder Sitemaps · unbegrenzte Prüfungen (Best-Effort) · KI-Filterung und -Zusammenfassungen · REST-API, MCP und signierte Webhooks in jedem Tarif · keine Kreditkarte

3 neue Seiten in sitemap.xml erkannt

POST https://hooks.your-app.com/page-deltas200

{
  "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"
  ]
}

Eigener Scraper vs. Scraping-API vs. Änderungs-Feed

Pragmatische Faustregel: Wenn Sie Tausende Seiten als Datensatz benötigen, nutzen Sie eine Scraping-API. Wenn Sie wissen müssen, wann sich eine öffentliche Seite gemäß einem Briefing verändert hat, erfordert ein Änderungs-Feed deutlich weniger Code und Wartungsaufwand.

Eigener Scraper (DIY)

Was Sie erhalten: Rohes HTML, das Sie selbst parsen müssen. Ideal für maximale Kontrolle bei unkonventionellen Websites. Der Aufwand ist hoch (Selektoren, Proxies, Rendering, Wiederholungsversuche). Bei einem Redesign bricht Ihr Parser geräuschlos ab. Die Aktualität hängt davon ab, wann Ihr Cronjob läuft. Typische Kosten: Infrastruktur plus Ihre Entwicklungszeit.

Scraping-API

Was Sie erhalten: Strukturierte Extraktion pro Anfrage. Ideal für die Massenextraktion vieler Seiten. Der Aufwand ist gering bis mäßig. Der Anbieter fängt die meisten Layoutänderungen ab. Die Aktualität hängt davon ab, wann Sie die API aufrufen. Typische Kosten: Abrechnung pro Anfrage-Credit.

Änderungs-Feed (dieser Leitfaden)

Was Sie erhalten: Ein JSON-Ereignis, sobald sich etwas Wesentliches geändert hat, ergänzt um eine KI-Zusammenfassung. Ideal für „Benachrichtige mein System, wenn sich diese Seite ändert“. Der Aufwand ist minimal: Einmal Monitor anlegen, danach Webhook empfangen oder abfragen. Inhaltsextraktion und das LLM-Briefing entscheiden, was wichtig ist. Adaptive Prüfungen; Push an Ihren Endpunkt bei Übereinstimmung. Abrechnung pro überwachter URL in Ihrem Tarif (Prüfungen sind bei Page Deltas unbegrenzt).

Was Sie aufbauen werden

Basis-URL: https://api.pagedeltas.com. Alle Endpunkte liegen unter /api. Erfolgreiche Antworten erfolgen in JSON.

Konto und API-Schlüssel

Erstellen Sie eine kostenlose Page Deltas-Organisation und generieren Sie einen API-Schlüssel.

Monitor mit Briefing

Erstellen Sie einen Monitor auf einer öffentlichen URL mit einem Briefing in natürlicher Sprache (dem Filter).

Polling oder Webhook

Fragen Sie GET /api/monitors/{id}/changes ab oder verknüpfen Sie einen generischen Webhook-Kanal, damit jeder Treffer ein signiertes JSON per POST an Ihre Anwendung sendet.

Optionales MCP

Verbinden Sie denselben API-Schlüssel über MCP mit Claude, Cursor oder VS Code.

Einrichtung: Eine Seite in einen Änderungs-Feed verwandeln

Fünf Schritte vom API-Schlüssel bis zum signierten Webhook. Bevorzugen Sie Webhooks, wenn Sie Push statt Pull wünschen.

Konto und API-Schlüssel erstellen

Registrieren Sie sich unter pagedeltas.com/register. Keine Kreditkarte erforderlich. Kostenloser Tarif: 10 überwachte URLs oder Sitemaps, unbegrenzte Prüfungen (Best-Effort-Frequenz), KI-Filterung und -Zusammenfassungen, unbegrenzte Teammitglieder, Slack / Discord / Teams / E-Mail / signierte Webhooks, 14 Tage Verlauf, REST-API und MCP. In der App: Einstellungen → API-Schlüssel (Editor oder Administrator). Erstellen Sie einen Schlüssel und kopieren Sie ihn sofort; er wird nur einmal angezeigt. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". Schlüssel gelten für die gesamte Organisation und besitzen dort Administratorrechte. Sie sind nicht an einzelne Personen gebunden; das Entfernen eines Teammitglieds widerruft den Schlüssel nicht. Löschen Sie den Schlüssel, um den Zugriff zu sperren. Behandeln Sie ihn wie ein Passwort: Umgebungsvariable oder Secret-Store, niemals in einer committeten Konfigurationsdatei.

Monitor erstellen (cURL)

POST https://api.pagedeltas.com/api/monitors mit dem Header Authorization: Bearer $PAGEDELTAS_TOKEN und JSON-Body: url, nl_description (das Briefing), optional filter_prompt und channel_ids: []. Beispiel-Briefing: „Preisseite des Wettbewerbers. Benachrichtige mich, wenn sich der Preis eines Tarifs ändert, ein Tarif hinzugefügt oder entfernt wird oder sich Limits ändern. Ignoriere Cookie-Banner, A/B-Layouts und wechselnde Testimonials.“ Es gibt kein Frequenzfeld. Die Überprüfungstaktung ist adaptiv (aktive Seiten häufiger, ruhige seltener; bezahlte Tarife werden priorisiert geprüft). Verwenden Sie POST /api/monitors/{id}/check-now für eine sofortige Prüfung bei Bedarf (begrenzt auf 1/Minute/Monitor). nl_description ist das Briefing, mit dem das LLM entscheidet, ob eine Änderung relevant ist. Unpräzise Briefings führen zu einer Flut unnötiger Diff-Meldungen in Ihrem Webhook. Optional: filter_prompt, css_selector, xpath_selector, is_pdf und channel_ids (monitorspezifische Kanäle; weglassen für Organisationsstandards). Nur öffentliches Web; Seiten hinter einem Login werden derzeit nicht unterstützt. Sitemap-Monitore sind eine eigene Ressource (/api/sitemap-monitors), wenn die Frage lautet „Ist eine komplett neue URL erschienen?“ statt „Wurde diese Seite umgeschrieben?“.

Änderungs-Feed per Polling abfragen

GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 mit dem Bearer-Token. Die neuesten Änderungen stehen an erster Stelle (Standard 50, maximal 100). Es gibt keinen Cursor. Speichern Sie den neuesten detected_at-Wert, den Sie bereits verarbeitet haben. Jede Änderung enthält id, detected_at und summary: Eine verständliche KI-Beschreibung dessen, was zum Briefing passte, kein rohes HTML-Diff. Leiten Sie summary direkt an Slack, ein Ticket-System oder einen anderen Agenten weiter.

Erstellung und Abfrage in Python

Nutzen Sie requests mit Authorization Bearer und Content-Type application/json. Senden Sie einen POST an /api/monitors mit url, nl_description und channel_ids: []. Lesen Sie monitor["id"] aus der Antwort aus. Rufen Sie danach GET /api/monitors/{monitor_id}/changes mit limit=50 auf und geben Sie detected_at und summary jeder Änderung aus. Führen Sie dieses Skript nach Zeitplan aus, falls Sie Polling nutzen müssen. Bevorzugen Sie einen Webhook für sofortige Push-Zustellungen.

Polling überspringen, JSON per Push empfangen (HMAC-signierte Webhooks)

In der App: Kanäle → Kanal hinzufügen → Generischer Webhook. Fügen Sie Ihre HTTPS-Empfänger-URL ein. Kopieren Sie das Kanalgeheimnis (Channel Secret), wenn es angezeigt wird (nur einmalig). Klicken Sie auf Test senden. Alternativ erstellen Sie den Kanal per API (POST /api/alert-channels) und verknüpfen ihn mit PUT /api/monitors/{id}/alert-channels, oder lassen channel_ids leer, damit der Monitor die Standardkanäle der Organisation nutzt. Jede passende Änderung sendet einen POST-Request mit flachem JSON an Ihre URL mit Content-Type application/json und X-Signature: sha256=<hex>. Die Felder umfassen event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url und dashboard_url. Überprüfen Sie X-Signature, indem Sie den HMAC-SHA256 über den unveränderten Byte-Body der Anfrage mit Ihrem Kanalgeheimnis berechnen (Format sha256=<hex>). Berechnen Sie den Hash über die exakten Bytes vor dem JSON-Parsing, da die Überprüfung sonst fehlschlägt. Im Laufe der Zeit können neue Felder hinzukommen: Ignorieren Sie unbekannte Schlüssel. Hinweise zur Zustellung: Aktuell gibt es einen Zustellversuch pro Kanal und Alert (keine automatischen Retries); antworten Sie daher zügig und fangen Sie Duplikate defensiv ab. Nicht-2xx-Status oder Netzwerkfehler markieren die Zustellung als fehlgeschlagen, der Monitor selbst läuft jedoch weiter. Jeder Versuch wird serverseitig protokolliert. Für menschliche Benachrichtigungen nutzen Sie Slack, Discord, Teams oder E-Mail auf dieselbe Weise. Die Anleitung für Slack finden Sie unter So erhalten Sie Webseiten-Änderungsbenachrichtigungen in Slack.

Optional: Monitore über Claude, Cursor oder VS Code steuern (MCP)

Derselbe API-Schlüssel. Streamingfähiger HTTP-MCP-Endpunkt: https://api.pagedeltas.com/mcp. Agenten erhalten Werkzeuge wie create_monitor, list_monitor_changes, create_alert_channel und Sitemap-Hilfsfunktionen. Cookie-Sitzungen werden auf MCP nicht akzeptiert. Verwenden Sie für ereignisgesteuerte Systeme, die nicht pollen sollen, einen Webhook-Kanal.

mcp.json in Cursor

Tragen Sie in ~/.cursor/mcp.json unter mcpServers.pagedeltas.url https://api.pagedeltas.com/mcp ein und setzen Sie headers.Authorization auf Bearer pdt_xxxxxxxx. Starten Sie Cursor neu, damit die Tools geladen werden.

Vollständige Client-Konfigurationen

Snippets für Claude Code, VS Code und Claude Desktop via mcp-remote finden Sie in der MCP-Dokumentation.

MCP-Dokumentation →

Ihr Briefing ist Ihre Abfragesprache

Bei einer REST-API filtern Sie mit Abfrageparametern. Bei einem Änderungs-Feed fungiert das in natürlicher Sprache verfasste Briefing am Monitor als Filter. Page Deltas extrahiert die Seite, vergleicht sie mit der letzten Prüfung und fragt ein LLM, ob die Abweichung Ihrem Briefing entspricht. Treffer werden mit einer formulierten Zusammenfassung und Vorher-Nachher-Screenshots zugestellt. Verfassen Sie das Briefing genau so, wie Sie es einem Kollegen erklären würden.

Preise

Der Preis eines Tarifs ändert sich oder ein neues Tarifmodell wird eingeführt.

Ausschreibungen / RFPs

Eine neue Ausschreibung in unserem NAICS-Tätigkeitsbereich wird veröffentlicht.

API-Dokumentation

In der API-Dokumentation wird ein Endpunkt hinzugefügt, entfernt oder als veraltet gekennzeichnet (deprecated).

Stellenangebote

Eine Senior-Entwicklerstelle wird ausgeschrieben; Stellen außerhalb der Softwareentwicklung ignorieren.

Allgemeiner Überwachungs-Leitfaden

Dieselbe Philosophie wie in unserem allgemeinen Leitfaden und der Anleitung für Filter und Beschreibungen.

Webseiten-Änderungen überwachen →

Filter-Leitfaden

Funktionierende Beispiele und typische Fehler beim Formulieren des Briefings.

Filter und Beschreibungen →

Kontingente, auf die es ankommt (und solche, die egal sind)

Bei Page Deltas richtet sich Ihre Planung nach der Anzahl der überwachten URLs (oder Sitemaps), nicht nach monatlichen Prüfkontingenten. Für Lese- und Schreib-Endpunkte der API gibt es derzeit abgesehen von vernünftiger Nutzung keine schlüsselbezogene Tarifstaffel. Die Ausnahme ist check-now: 1 Anfrage / Minute / Monitor (führt bei Überschreitung zu Status 429 samt Retry-After). Das Erreichen des URL-Limits Ihres Tarifs liefert Status 422 mit aktuellem Zählerstand und Limit. Klassische Tools zwingen Sie zu Rechenspielen („stündlich bei einer Seite ≈ 720 Prüfungen/Monat“). Hier wählen Sie die Seiten und schreiben das Briefing. Der Rhythmus passt sich selbstständig an.

Kostenlos

10 überwachte URLs · 14 Tage Verlauf · unbegrenzte Prüfungen (Best-Effort), KI, API, MCP, alle fünf Benachrichtigungskanäle · 0 $

Starter

150 überwachte URLs · 30 Tage Verlauf · 29 $/Monat · priorisierte Prüfungen

Pro

1.000 überwachte URLs · 90 Tage Verlauf · 79 $/Monat

Business

5.000 überwachte URLs · 365 Tage Verlauf · 199 $/Monat

Scale

20.000 überwachte URLs · 730 Tage Verlauf · 499 $/Monat

Enterprise

Individuelle URL-Anzahl und Historie · SSO / SCIM

Wie sich dies von einer Visualping-artigen Änderungs-API unterscheidet

Entwicklerartikel von Visualping stützen sich auf feste Intervalle, optionale CSS/XPath-Eingrenzungen, monatliche Abfragekontingente und umfangreiche Webhook-Payloads rund um Rohdiffs und Wichtigkeits-Flags. Das passt, wenn die Anforderung lautet: „Löse aus, wenn sich Pixel verschoben haben, und lass meinen Code entscheiden.“ Page Deltas wurde dafür gebaut, „mein System nur dann aufzuwecken, wenn die Änderung diesem Briefing entspricht“. Dieser Artikel ist der Integrationsleitfaden; den kompletten Tarifvergleich finden Sie auf Page Deltas vs. Visualping.

Natürlichsprachiges Briefing zuerst

Der primäre Filter ist das Briefing. Selektoren sind optional, nicht zwingend erforderlich.

Adaptive Frequenz

Kein manuelles Definieren von Intervallen. Aktive Seiten werden öfter geprüft, ruhige Seiten seltener.

Flache Webhook-Payload

Fokussiert auf Zusammenfassung (summary), Screenshot-URLs und HMAC-Signatur X-Signature.

Unbegrenzte Prüfungen; Zahlung nach URL-Anzahl

Jeder Tarif beinhaltet unbegrenzte Prüfungen. Sie zahlen ausschließlich für die Anzahl der überwachten URLs.

MCP mit denselben API-Schlüsseln

MCP nutzt dieselben API-Schlüssel wie die REST-Schnittstelle.

Vollständiger Produktvergleich

Tarif-für-Tarif-Vergleich zwischen Page Deltas und Visualping.

Page Deltas vs. Visualping →

Ehrliche Grenzen der Lösung

Verstehen Sie genau, was dieser Änderungs-Feed leistet und was nicht, bevor Sie Produktivsysteme anbinden.

Ausschließlich öffentliche Seiten

Marketing-Websites, öffentliche PDFs, offene Karriereportale, frei zugängliche Sitemaps. Seiten hinter einem Login-Schutz stehen auf der Roadmap, sind aber aktuell nicht verfügbar.

Kein Tool für visuelle Regressionen oder Defacement

Wenn die Aufgabe lautet „Hat sich dieser Pixel um 20px verschoben?“, bleibt ein visuelles Diff-Produkt die bessere Wahl.

Keine Aktivitäten auf LinkedIn oder X

Page Deltas überwacht das offene Web. Aktivitäten einzelner Personen auf LinkedIn oder X gehören zu MultiFollow. Die Beobachtung von Keyword-Erwähnungen auf LinkedIn, X, Reddit und weiteren Plattformen übernimmt KWatch.

Webhook-Zustellung aktuell mit einem einzigen Versuch

Bauen Sie idempotente Empfänger.

Keine eigenen Feldnamen in Antworten erfinden

Übernehmen Sie Feldstrukturen aus der Live-API-Referenz und ignorieren Sie unbekannte JSON-Schlüssel.

API-Referenz →

Häufig gestellte Fragen (FAQ)

Wie erhalte ich Daten von einer Website, die keine API hat?: Drei Möglichkeiten: Einen Scraper bauen, eine Scraping-API für Massenextraktion nutzen, oder eine Änderungsüberwachungs-API auf die Seite ansetzen und den JSON-Änderungs-Feed verarbeiten. Für „Benachrichtige mein System, wenn sich diese Seite ändert“ erfordert der Änderungs-Feed meist den geringsten Codeaufwand: Monitor anlegen, danach Webhook empfangen oder abfragen.
Kann ich das ohne Programmieren umsetzen?: Ja. Erstellen Sie den Monitor im Dashboard, fügen Sie unter Kanäle einen generischen Webhook (oder Slack / Teams / Discord / E-Mail) hinzu, verfassen Sie das Briefing und klicken Sie auf Test senden. Der No-Code-Weg wird im Schnellstart erklärt.
Was ist der Unterschied zwischen einer Scraping-API und einer Änderungsüberwachungs-API?: Eine Scraping-API extrahiert den gesamten Seiteninhalt bei jedem Aufruf. Eine Änderungsüberwachungs-API beobachtet die Seite kontinuierlich und liefert nur die Änderungen aus, inklusive bereits berechneter KI-Zusammenfassung. Extraktionsprobleme erfordern Scraper; die Frage „Hat sich etwas gemäß meinem Briefing verändert?“ verlangt nach einem Änderungs-Feed.
Kostet der Zugriff auf die API oder Webhooks extra?: Nein. REST-API, MCP und signierte Webhooks sind in jedem Tarif enthalten, einschließlich des kostenlosen Plans. Die Nutzung wird durch Ihr Limit überwachter URLs beschränkt, nicht durch ein separates API-Credit-Kontingent.
Können KI-Agenten Monitore für mich anlegen?: Ja. Verbinden Sie einen MCP-Client mit https://api.pagedeltas.com/mcp unter Angabe Ihres Bearer-API-Schlüssels. Details finden Sie in der MCP-Dokumentation.

Autor

Julien, Produktmanager bei Page Deltas. Wählen Sie eine öffentliche URL, die Sie ohnehin regelmäßig manuell prüfen. Erstellen Sie ein kostenloses Konto, generieren Sie einen API-Schlüssel, legen Sie den Monitor mit einem einzeiligen Briefing an, binden Sie einen generischen Webhook an, überprüfen Sie die HMAC-Signatur einmalig und warten Sie auf den ersten echten Treffer. Passen Sie die Ausschlussliste nach der ersten ungenauen Benachrichtigung an. Mehr ist für die Änderungs-API meist nicht nötig.

Starten Sie mit einer ersten Seite als Änderungs-Feed

Kostenloser Tarif, keine Kreditkarte. Konto erstellen, API-Schlüssel generieren, die bisher manuell kontrollierte URL einfügen, ein Briefing aus dem Filter-Leitfaden übernehmen und entweder /changes abfragen oder signiertes JSON per POST an Ihren eigenen Endpunkt empfangen.

Kostenlos mit dem Monitoring starten