Guida
Come trasformare qualsiasi sito web in un'API di rilevamento modifiche
La maggior parte delle pagine a cui siete interessati non offrirà mai un'API. Prezzi della concorrenza, PDF dei Termini di Servizio dei fornitori, indici delle autorità di regolamentazione, changelog dei partner: i dati sono lì nell'HTML, ma non esiste alcun endpoint da chiamare. Avete tre opzioni realistiche. Costruire uno scraper e gestire i continui malfunzionamenti. Pagare un'API di scraping per estrarre l'intera pagina su richiesta. Oppure trasformare la pagina in un feed di modifiche: un monitor che la osserva per voi e invia JSON solo quando cambia effettivamente qualcosa di rilevante. Questo articolo illustra questa terza via, da cima a fondo, con Page Deltas.
Piano gratuito · 10 URL o sitemap monitorati · verifiche illimitate (best-effort) · filtri e riepiloghi IA · API REST, MCP e webhook firmati su tutti i piani · nessuna carta di credito richiesta
{
"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"
]
}Scraper vs API di scraping vs feed di modifiche
Regola generale e trasparente: se vi servono migliaia di pagine come dataset, usate un'API di scraping. Se avete bisogno di sapere quando una pagina pubblica cambia in base a un'istruzione precisa, un feed di modifiche richiede meno codice e molta meno manutenzione.
Scraper fai-da-te
Cosa ottenete: HTML grezzo che dovete analizzare voi stessi. Ideale per il controllo totale su siti particolari. L'impegno è elevato (selettori, proxy, rendering, tentativi). Quando il sito cambia grafica, il parser si rompe silenziosamente. Aggiornamento in base alla frequenza del cron. Costo tipico: infrastruttura più il vostro tempo.
API di scraping
Cosa ottenete: estrazione strutturata per singola richiesta. Ideale per l'estrazione massiva di molte pagine. L'impegno è medio-basso. Il fornitore gestisce gran parte delle rotture. Aggiornamento solo quando chiamate l'endpoint. Costo tipico: crediti per richiesta.
Feed di modifiche (questa guida)
Cosa ottenete: un evento JSON con riassunto IA quando cambia qualcosa di significativo. Ideale per "avvisa il mio sistema quando questa pagina cambia". Impegno minimo: creazione di un monitor, poi webhook o polling. L'estrazione dei contenuti e il brief LLM decidono cosa è rilevante. Verifiche adattive; invio al vostro endpoint alla corrispondenza. Fatturazione per URL monitorato nel piano (le verifiche non sono conteggiate su Page Deltas).
Cosa costruirete
URL di base: https://api.pagedeltas.com. Tutti gli endpoint sono sotto /api. Le risposte andate a buon fine sono in formato JSON.
Account e chiave API
Create un'organizzazione Page Deltas gratuita e una chiave API.
Monitor con un brief
Create un monitor su un URL pubblico specificando un brief in linguaggio naturale (il filtro).
Polling o webhook
Eseguite il polling su GET /api/monitors/{id}/changes o collegate un canale webhook generico affinché ogni rilevamento invii una richiesta POST con JSON firmato alla vostra applicazione.
MCP opzionale
Collegate la stessa chiave a Claude, Cursor o VS Code tramite MCP.
Configurazione: trasformare una pagina in un feed di modifiche
Cinque passaggi dalla chiave API al webhook firmato. Preferite un webhook quando desiderate un approccio push anziché pull.
Creare un account e una chiave API
Registratevi su pagedeltas.com/register. Nessuna carta di credito richiesta. Piano gratuito: 10 URL o sitemap monitorati, verifiche illimitate (frequenza best-effort), filtri e riepiloghi IA, colleghi illimitati, Slack / Discord / Teams / email / webhook firmati, cronologia di 14 giorni, API REST e MCP. Nell'app: Impostazioni → Chiavi API (editor o admin). Create una chiave e copiatela immediatamente; viene mostrata una sola volta. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". Le chiavi sono associate all'organizzazione e operano con permessi di livello admin al suo interno. Non sono legate a un singolo utente, quindi la rimozione di un membro del team non revoca la chiave. Eliminate la chiave per revocare l'accesso. Trattatela come una password: via variabile d'ambiente o secret store, mai all'interno di file di configurazione nel repository.
Creare un monitor (cURL)
POST https://api.pagedeltas.com/api/monitors con Authorization: Bearer $PAGEDELTAS_TOKEN e corpo JSON: url, nl_description (il brief), filter_prompt opzionale e channel_ids: []. Esempio di brief: "Pagina prezzi della concorrenza. Avvisa quando cambia il prezzo di un piano, viene aggiunto o rimosso un piano, o cambiano quote e limiti. Ignora cookie banner, layout A/B e testimonianze a rotazione." Non esiste un campo frequenza. La cadenza è adattiva (pagine attive controllate più spesso, pagine tranquille meno spesso; i piani a pagamento ottengono priorità di controllo). Usate POST /api/monitors/{id}/check-now per una verifica istantanea on-demand (limite di frequenza: 1 richiesta/minuto/monitor). nl_description è il brief che l'LLM utilizza per decidere se una modifica è rilevante. Brief generici trasformeranno il vostro webhook in un flusso indiscriminato di differenze visive. Campi opzionali: filter_prompt, css_selector, xpath_selector, is_pdf e channel_ids (sovrascrittura dei canali per monitor; omettete per usare i predefiniti dell'organizzazione). Solo web pubblico. Le pagine protette da login non sono ancora supportate. I monitor di sitemap costituiscono una risorsa separata (/api/sitemap-monitors) quando l'obiettivo è rilevare se è comparsa una nuova pagina piuttosto che se una pagina esistente è stata riscritta.
Interrogare il feed di modifiche (polling)
GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 con il token Bearer. Le modifiche più recenti per prime (impostazione predefinita 50, massimo 100). Non esiste un cursore. Tracciate l'ultimo timestamp detected_at che avete già elaborato. Ciascuna modifica include id, detected_at e summary: una descrizione chiara elaborata dall'IA di ciò che corrisponde al brief, non un diff HTML grezzo. Inoltrate summary su Slack, in un ticket o a un altro agente.
Stessa creazione e polling in Python
Usate requests con Authorization Bearer e Content-Type application/json. POST /api/monitors con url, nl_description e channel_ids: []. Leggete monitor["id"] dalla risposta. Quindi eseguite GET /api/monitors/{monitor_id}/changes con limit=50 e stampate detected_at e summary di ciascuna modifica. Eseguitelo in modo pianificato se dovete necessariamente fare polling. Preferite un webhook quando desiderate un approccio push anziché pull.
Evitare il polling, ricevere JSON via push (webhook firmati HMAC)
Nell'app: Canali → Aggiungi un canale → Webhook generico. Incollate l'URL HTTPS del vostro ricevitore. Copiate il segreto del canale quando viene mostrato (una sola volta). Cliccate su Invia test. Oppure create il canale tramite API (POST /api/alert-channels), quindi collegatelo con PUT /api/monitors/{id}/alert-channels, oppure lasciate channel_ids vuoto affinché il monitor utilizzi le impostazioni predefinite dell'organizzazione. Ciascuna modifica rilevata invia un payload JSON piatto con richiesta POST al vostro URL con Content-Type application/json e header X-Signature: sha256=<hex>. I campi includono event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url e dashboard_url. Verificate X-Signature calcolando l'HMAC-SHA256 del corpo grezzo della richiesta con il segreto del vostro canale (formato dell'header sha256=<hex>). Calcolate l'hash sui byte esatti prima di analizzare il JSON, altrimenti la verifica fallirà. In futuro potrebbero essere aggiunti nuovi campi: ignorate le chiavi sconosciute. Note sull'invio: attualmente viene effettuato un solo tentativo per canale per ciascun avviso (nessun nuovo tentativo automatico), pertanto rispondete tempestivamente e gestite i duplicati in modo idempotente. Errori di rete o risposte diverse da 2xx contrassegnano la consegna come non riuscita; il monitor in sé non viene sospeso per errori di consegna. Ogni tentativo viene registrato a livello di server. Per gli avvisi a persone anziché a codice, usate i canali Slack, Discord, Teams o email con la stessa modalità. La guida dettagliata alla configurazione di Slack è Come ricevere avvisi di modifica del sito web su Slack.
Opzionale: gestire i monitor da Claude, Cursor o VS Code (MCP)
Stessa chiave API. Endpoint HTTP MCP con supporto per streaming: https://api.pagedeltas.com/mcp. Gli agenti ottengono strumenti come create_monitor, list_monitor_changes, create_alert_channel e helper per le sitemap. Le sessioni basate su cookie non sono accettate su MCP. Preferite un canale webhook per i sistemi basati su eventi che non devono effettuare polling.
Cursor mcp.json
In ~/.cursor/mcp.json impostate mcpServers.pagedeltas.url su https://api.pagedeltas.com/mcp e headers.Authorization su Bearer pdt_xxxxxxxx. Riavviate Cursor in modo che gli strumenti vengano caricati.
Snippet completi per client
Le istruzioni per Claude Code, VS Code e Claude Desktop tramite mcp-remote sono disponibili nella documentazione MCP.
Documentazione MCP →Il vostro brief è il linguaggio di query
Con un'API REST si filtra tramite parametri di query. Con un feed di modifiche, il filtro è il brief in linguaggio naturale impostato sul monitor. Page Deltas estrae la pagina, la confronta con l'ultimo controllo e chiede a un LLM se la variazione corrisponde al vostro brief. Gli avvisi pertinenti arrivano con un riassunto testuale e screenshot prima/dopo. Scrivete il brief esattamente come istruireste un collega di lavoro.
Prezzi
Cambia il prezzo di un piano o compare un nuovo livello di abbonamento.
Bandi e gare d'appalto
Viene pubblicata una nuova gara d'appalto nel nostro settore di competenza.
Documentazione API
La documentazione dell'API aggiunge, rimuove o depreca un endpoint.
Assunzioni
Viene aperta una posizione senior in ambito ingegneristico; ignora ruoli non tecnici.
Guida generale al monitoraggio
La stessa filosofia illustrata nella nostra guida generale al monitoraggio e nella guida a filtri e descrizioni.
Come monitorare i cambiamenti dei siti web →Guida ai filtri
Esempi efficaci ed errori da evitare nella redazione del brief.
Filtri e descrizioni →Le quote che contano davvero (e quelle che non contano)
Su Page Deltas, il limite da considerare è il numero di URL (o sitemap) che monitorate, non una quota mensile di verifiche. Gli endpoint API in lettura e scrittura non hanno limiti rigidi oltre a un utilizzo ragionevole. L'eccezione è check-now: 1 richiesta/minuto/monitor (con risposta 429 e header Retry-After se superato). Il raggiungimento del limite di URL del piano restituisce un codice 422 con il conteggio attuale e il limite consentito. Gli strumenti tradizionali a consumo di verifiche costringono a calcoli complessi ("un controllo ogni ora su una pagina ≈ 720 verifiche/mese"). Qui scegliete le pagine e scrivete il brief. La cadenza si adatta automaticamente.
Free
10 URL monitorati · cronologia di 14 giorni · verifiche illimitate (best-effort), IA, API, MCP, tutti e 5 i canali di avviso · 0 $
Starter
150 URL monitorati · cronologia di 30 giorni · 29 $/mese · verifiche con priorità
Pro
1.000 URL monitorati · cronologia di 90 giorni · 79 $/mese
Business
5.000 URL monitorati · cronologia di 365 giorni · 199 $/mese
Scale
20.000 URL monitorati · cronologia di 730 giorni · 499 $/mese
Enterprise
URL e cronologia personalizzati · SSO / SCIM
In cosa differisce da un'API di rilevamento stile Visualping
I contenuti per sviluppatori di Visualping puntano su intervalli fissi, selezione CSS/XPath opzionale, un tetto mensile di controlli e un payload webhook pesante incentrato su differenze visive e flag di rilevanza. Questo approccio funziona se l'obiettivo è "scatta quando i pixel si muovono, poi lascia decidere al mio codice". Page Deltas è progettato per "sveglia il mio sistema solo se il cambiamento rispetta questo brief". Questo articolo è la guida tecnica; il confronto completo dettagliato piano per piano è disponibile su Page Deltas vs Visualping.
Brief in linguaggio naturale come priorità
Il filtro principale è il brief. I selettori sono opzionali, non indispensabili.
Cadenza adattiva
Nessuna stringa di intervallo da impostare. Le pagine attive vengono verificate più spesso, quelle tranquille meno spesso.
Payload webhook essenziale e piatto
Incentrato su summary, URL degli screenshot e header X-Signature con HMAC.
Verifiche illimitate; pagamento in base al numero di URL
Ogni piano include verifiche illimitate. Si paga solo per il numero di URL monitorati.
MCP con le stesse chiavi
MCP utilizza le stesse identiche chiavi API della superficie REST.
Confronto completo dei prodotti
Confronto piano per piano tra Page Deltas e Visualping.
Page Deltas vs Visualping →Limiti trasparenti
Comprendete cosa sia e cosa non sia questo feed di modifiche prima di integrarlo nei sistemi di produzione.
Solo pagine pubbliche
Siti di marketing, PDF pubblici, bacheche annunci di lavoro pubbliche, sitemap accessibili. I portali protetti da login sono previsti nella roadmap, ma non disponibili oggi.
Non è uno strumento per regressioni visive o defacement
Se l'obiettivo è rilevare "questo pixel si è spostato di 20px", i prodotti basati su differenze grafiche sono più indicati.
Nessuna attività su LinkedIn o X
Page Deltas monitora il web aperto. L'attività a livello di singoli profili su LinkedIn e X è gestita da MultiFollow. Il monitoraggio di parole chiave su LinkedIn, X, Reddit e altre piattaforme compete a KWatch.
L'invio dei webhook prevede un singolo tentativo
Costruite endpoint riceventi che siano idempotenti.
Non inventare nomi di campi di risposta
Copiate le strutture direttamente dalla documentazione API live e ignorate i campi JSON sconosciuti.
Documentazione API →Guide correlate e documentazione
Integrazioni per team su Slack, avvio rapido senza codice e specifiche complete dell'API.
Avvisi di modifica su Slack
Collegate lo stesso monitor a un webhook in entrata di Slack per inviare notifiche al vostro team anziché a un software.
Come ricevere avvisi di modifica del sito web su Slack →Guida rapida
Percorso senza codice: inserite un URL, scrivete il brief, scegliete un canale e cliccate su Invia test.
Guida rapida →Documentazione API
Struttura in tempo reale di richieste e risposte. Copiate i campi da qui; ignorate le chiavi JSON sconosciute.
Documentazione API →Documentazione MCP
Snippet di configurazione per Claude Code, Cursor, VS Code e Claude Desktop.
Documentazione MCP →Domande frequenti
- Come posso estrarre dati da un sito web sprovvisto di API?
- Esistono tre opzioni: costruire uno scraper, utilizzare un'API di scraping per estrazioni massive, oppure puntare un'API di monitoraggio modifiche sulla pagina e consumare il feed JSON delle modifiche. Quando l'esigenza è "notifica il mio sistema quando questa pagina cambia", il feed di modifiche richiede in genere molto meno codice: basta creare un monitor, poi usare un webhook o fare polling.
- Posso fare tutto questo senza scrivere codice?
- Sì. Create il monitor nella dashboard, aggiungete un webhook generico (oppure Slack / Teams / Discord / email) nella sezione Canali, scrivete il brief e cliccate su Invia test. La guida rapida illustra il percorso senza codice.
- Qual è la differenza tra un'API di scraping e un'API di monitoraggio modifiche?
- Un'API di scraping estrae l'intero contenuto della pagina ogni volta che viene invocata. Un'API di monitoraggio controlla la pagina ed emette solo le variazioni rilevate, fornendo un riassunto IA già calcolato. I problemi di estrazione massiva richiedono scraper. L'esigenza "è cambiato qualcosa che corrisponde al mio brief?" richiede un feed di modifiche.
- L'accesso ad API e webhook comporta costi aggiuntivi?
- No. L'API REST, MCP e i webhook con firma sono inclusi in ogni piano, compreso il piano Free. L'utilizzo è regolato unicamente dal limite di URL monitorati del vostro piano, non da un contatore separato di crediti API.
- Gli agenti IA possono creare monitor al posto mio?
- Sì. È sufficiente puntare un client MCP verso https://api.pagedeltas.com/mcp fornendo una chiave API Bearer. Consultate la documentazione MCP.
Autore
Julien, Product Manager presso Page Deltas. Scegliete un URL pubblico che già aggiornate manualmente. Create un account gratuito, generate una chiave API, create il monitor con un brief di una frase, collegate un webhook generico, verificate la firma HMAC una sola volta e attendete la prima rilevazione reale. Ottimizzate l'elenco delle esclusioni dopo il primo avviso poco rilevante. In questo consiste di solito l'intera configurazione di un'API di monitoraggio modifiche.
Iniziate con una pagina come feed di modifiche
Piano gratuito, nessuna carta di credito. Create un account, generate una chiave API, inserite l'URL che già controllate a mano, aggiungete un brief dalla guida ai filtri e scegliete se interrogare /changes o ricevere JSON firmato via POST sul vostro endpoint.