Opas
Miten muuttaa mikä tahansa verkkosivusto muutos-APIksi
Useimmat seuraamistasi sivuista eivät koskaan julkaise omaa rajapintaa (API). Kilpailijoiden hinnat, toimittajien käyttöehto-PDF:t, viranomaisten rekisterit, kumppaneiden muutoslokit: tiedot ovat valmiina HTML-koodissa, mutta kutsuttavaa päätepistettä ei ole. Käytössäsi on kolme realistista vaihtoehtoa: Rakenna oma kaapain (scraper) ja korjaa jatkuvia toimintahäiriöitä. Maksa kaavintarajapinnalle koko sivun noutamisesta tarpeen mukaan. Tai muuta sivu muutosvirraksi: monitoriksi, joka tarkkailee sivua puolestasi ja lähettää JSON-dataa vain silloin, kun jotain todella merkittävää on muuttunut. Tämä opas esittelee tuon kolmannen polun alusta loppuun Page Deltasin avulla.
Ilmainen paketti · 10 valvottua URL-osoitetta tai sivustokarttaa · rajattomasti tarkistuksia (best-effort) · tekoälysuodatus ja -tiivistelmät · REST API, MCP ja allekirjoitetut webhookit kaikissa paketeissa · ei vaadi luottokorttia
{
"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"
]
}Oma kaapain vs kaavintarajapinta vs muutosvirta
Rehellinen nyrkkisääntö: Jos tarvitset tuhansia sivuja laajana data-aineistona, käytä kaavintarajapintaa. Jos sinun täytyy tietää, milloin tietty julkinen sivu muuttuu annetun ohjeen mukaisesti, muutosvirta vaatii vähemmän koodia ja huomattavasti vähemmän ylläpitoa.
Tee-se-itse-kaapain
Mitä saat: Raakaa HTML-koodia, jota jäsennät itse. Paras ratkaisu täyteen hallintaan erikoisilla sivustoilla. Vaiva on suuri (valitsimet, välityspalvelimet, renderöinti, uudelleenyritykset). Kun sivusto uudistuu, jäsennin rikkoutuu huomaamatta. Tuoreus riippuu siitä, milloin ajastettu tehtäväsi (cron) suoritetaan. Tyypillinen hinta: Infrastruktuuri plus oma työaikasi.
Kaavintarajapinta (scraping API)
Mitä saat: Rakenteista dataa pyyntöä kohden. Paras suurten sivumäärien massanoutoon. Vaiva on vähäinen tai kohtalainen. Palveluntarjoaja ottaa vastaan useimmat sivuston rakenneongelmat. Tuoreus riippuu vain siitä, milloin kutsut rajapintaa. Tyypillinen hinta: Krediitit pyyntöä kohden.
Muutosvirta (tämä opas)
Mitä saat: JSON-tapahtuman, kun jotain merkittävää muuttuu, mukana tekoälyn laatima tiivistelmä. Paras ratkaisu malliin "ilmoita järjestelmälleni, kun tämä sivu muuttuu". Vaiva on minimaalinen: luot yhden monitorin ja otat käyttöön webhookin tai kyselyn (polling). Sisällön poiminta ja kielimallin ohjeistus ratkaisevat, millä on merkitystä. Mukautuvat tarkistukset ja suora push-lähetys päätepisteeseesi osuman sattuessa. Hinnoittelu pakettiisi kuuluvien valvottujen URL-osoitteiden mukaan (tarkistuksia ei mitata Page Deltasissa).
Mitä tulet rakentamaan
Perus-URL: https://api.pagedeltas.com. Kaikki päätepisteet sijaitsevat polussa /api. Onnistuneet vastaukset palautetaan JSON-muodossa.
Tili ja API-avain
Luo ilmainen Page Deltas -organisaatio ja API-avain.
Monitori ohjeistuksella
Luo monitori julkiselle URL-osoitteelle luonnollisella kielellä kirjoitetulla ohjeella (suodatin).
Kysely tai webhook
Kysy muutoksia säännöllisesti kutsulla GET /api/monitors/{id}/changes tai liitä yleinen webhook-kanava, jolloin jokainen osuma lähettää allekirjoitetun JSON-viestin POST-pyynnöllä sovellukseesi.
Valinnainen MCP
Yhdistä sama avain Claudeen, Cursoriin tai VS Codeen MCP-protokollan kautta.
Käyttöönotto: muuta sivu muutosvirraksi
Viisi vaihetta API-avaimesta allekirjoitettuun webhookiin. Suosi webhookia, kun haluat vastaanottaa tiedot reaaliaikaisena push-lähetyksenä jatkuvan kyselyn sijaan.
Luo tili ja API-avain
Rekisteröidy osoitteessa pagedeltas.com/register. Ei vaadi luottokorttia. Ilmainen paketti: 10 valvottua URL-osoitetta tai sivustokarttaa, rajattomat tarkistukset (parhaan mahdollisen frekvenssin mukaan), tekoälysuodatus ja -tiivistelmät, rajattomasti tiiminjäseniä, Slack / Discord / Teams / sähköposti / allekirjoitetut webhookit, 14 päivän historia, REST API ja MCP. Sovelluksessa: Asetukset → API-avaimet (editor tai admin). Luo avain ja kopioi se välittömästi talteen; se näytetään vain kerran. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". Avaimet kuuluvat organisaatiotasolle ja toimivat pääkäyttäjän oikeuksilla kyseisessä organisaatiossa. Niitä ei ole sidottu yksittäiseen jäseneen, joten tiiminjäsenen poistaminen ei mitätöi avainta. Poista avain katkaistaksesi pääsyn. Käsittele avainta kuin salasanaa: ympäristömuuttujassa tai salaisuuksien hallintapalvelussa, älä koskaan versionhallintaan vietävissä tiedostoissa.
Luo monitori (cURL)
POST https://api.pagedeltas.com/api/monitors otsakkeella Authorization: Bearer $PAGEDELTAS_TOKEN ja JSON-rungolla: url, nl_description (ohjeistus), valinnainen filter_prompt ja channel_ids: []. Esimerkkiohje: "Kilpailijan hinnoittelusivu. Ilmoita, kun minkä tahansa tilauksen hinta muuttuu, paketti lisätään tai poistetaan tai kiintiöt ja rajoitukset muuttuvat. Jätä huomiotta evästebannerit, A/B-testien asettelut ja vaihtuvat asiakaspalautteet." Erillistä tarkistustaajuuskenttää ei ole. Tahti on mukautuva (aktiivisia sivuja tarkistetaan useammin, rauhallisia harvemmin; maksulliset paketit saavat etuoikeutetut tarkistukset). Käytä kutsua POST /api/monitors/{id}/check-now välitöntä tarkistusta varten (rajoitettu 1 pyyntöön minuutissa monitoria kohden). nl_description on ohje, jota kielimalli käyttää arvioidakseen, onko muutos merkityksellinen. Epämääräiset ohjeet tekevät webhookistasi pelkän turhien visuaalisten pikselierojen virran. Valinnaiset kentät: filter_prompt, css_selector, xpath_selector, is_pdf ja channel_ids (monitorikohtaiset kanavat; jätä pois käyttääksesi organisaation oletuksia). Vain julkinen verkko. Kirjautumisen takana olevia sivuja ei vielä tueta. Sivustokarttamonitorit ovat erillinen resurssi (/api/sitemap-monitors), kun tavoitteena on havaita "ilmestyikö kokonaan uusi sivu?" eikä "muuttuiko tämän sivun sisältö?"
Tee kyselyjä muutosvirtaan (polling)
GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 Bearer-tunnuksellasi. Uusimmat muutokset näytetään ensin (oletus 50, enintään 100). Kursoria ei ole. Pidä itse kirjaa viimeisimmästä käsittelemästäsi detected_at-aikaleimasta. Jokainen muutos sisältää kentät id, detected_at ja summary: selkeän tekoälyn laatiman kuvauksen siitä, mikä vastasi ohjetta, ei raakaa HTML-diffiä. Ohjaa summary Slackiin, tiketöintijärjestelmään tai toiselle tekoälyagentille.
Sama luonti ja kysely Pythonilla
Käytä requests-kirjastoa otsakkeilla Authorization Bearer ja Content-Type application/json. Tee POST-kutsu osoitteeseen /api/monitors kentillä url, nl_description ja channel_ids: []. Lue vastauksesta monitor["id"]. Tee sitten GET-kutsu osoitteeseen /api/monitors/{monitor_id}/changes parametrilla limit=50 ja tulosta jokaisen muutoksen detected_at ja summary. Aja tätä ajastetusti, jos haluat välttämättä käyttää kyselyä. Suosi webhookia, jos haluat datan saapuvan automaattisesti push-lähetyksenä.
Ohita kyselyt, vastaanota JSON suoraan (HMAC-allekirjoitetut webhookit)
Sovelluksessa: Kanavat → Lisää kanava → Yleinen webhook. Liitä vastaanottimesi HTTPS-osoite. Kopioi kanavan salaisuus heti, kun se näytetään (vain kerran). Napsauta Lähetä testi. Voit myös luoda kanavan API:n kautta (POST /api/alert-channels) ja liittää sen kutsulla PUT /api/monitors/{id}/alert-channels tai jättää channel_ids-kentän tyhjäksi, jolloin monitori käyttää organisaation oletuksia. Jokainen ohjeistukseen osuva muutos lähettää selkeän JSON-viestin POST-pyynnöllä osoitteeseesi otsakkeilla Content-Type application/json ja X-Signature: sha256=<hex>. Kenttiin kuuluvat event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url ja dashboard_url. Vahvista X-Signature laskemalla pyynnön raa'asta rungosta HMAC-SHA256 kanavan salaisuutta käyttäen (otsakkeen muoto sha256=<hex>). Laske tiiviste tarkalleen ennen JSONin jäsentämistä, muuten vahvistus epäonnistuu. Uusia kenttiä saatetaan lisätä ajan myötä: jätä tuntemattomat avaimet huomiotta. Toimitustiedot: toistaiseksi yksi toimitusyritys kanavaa ja ilmoitusta kohden (ei automaattisia uusintayrityksiä); vastaa nopeasti ja käsittele kaksoiskappaleet idempotentisti. Verkkovirheet tai muut kuin 2xx-tilakoodit merkitsevät toimituksen epäonnistuneeksi; itse monitoria ei keskeytetä toimitusvirheiden takia. Jokainen toimitusyritys auditoidaan palvelimen puolella. Ihmisille suunnatuissa ilmoituksissa käytä Slack-, Discord-, Teams- tai sähköpostikanavia samalla tavalla. Slack-ohjeistus löytyy sivulta Miten saada ilmoituksia verkkosivuston muutoksista Slackiin.
Valinnainen: ohjaa monitoreja Claudesta, Cursorista tai VS Codesta (MCP)
Sama API-avain. Suoratoistettava HTTP MCP -päätepiste: https://api.pagedeltas.com/mcp. Agentit saavat käyttöönsä työkalut kuten create_monitor, list_monitor_changes, create_alert_channel ja sivustokartta-aputoiminnot. Evästeistuntoja ei tueta MCP:ssä. Suosi webhook-kanavaa tapahtumapohjaisissa järjestelmissä, joiden ei tulisi tehdä kyselyjä.
Cursor mcp.json
Aseta tiedostossa ~/.cursor/mcp.json mcpServers.pagedeltas.url arvoon https://api.pagedeltas.com/mcp ja headers.Authorization arvoon Bearer pdt_xxxxxxxx. Käynnistä Cursor uudelleen, jotta työkalut tulevat näkyviin.
Täydet asiakasesimerkit
Ohjeet Claude Codelle, VS Codelle ja Claude Desktopille mcp-remoten kautta löytyvät MCP-dokumentaatiosta.
MCP-dokumentaatio →Ohjeistuksesi on kyselykielesi
REST API:ssa suodatus tehdään kyselyparametreilla. Muutosvirrassa suodattimena toimii monitoriin syötetty luonnollisen kielen ohjeistus. Page Deltas poimii sivun, vertaa sitä edelliseen tarkistukseen ja kysyy kielimallilta, vastaako ero ohjeistustasi. Osuman saaneet ilmoitukset toimitetaan kirjallisen tiivistelmän sekä ennen/jälkeen-kuvakaappausten kera. Kirjoita ohje aivan kuten perehdyttäisit tiimikaveriasi.
Hinnoittelu
Tilauksen hinta muuttuu tai uusi tilaustaso tulee näkyviin.
Tarjouspyynnöt / hankinnat
Uusi tarjouspyyntö julkaistaan toimialallamme.
API-dokumentaatio
API-dokumentaatioon lisätään, siitä poistetaan tai siinä merkitään vanhentuneeksi päätepiste.
Rekrytointi
Uusi kokeneen kehittäjän tehtävä avataan; jätä huomiotta ei-tekniset roolit.
Yleinen valvontaopas
Sama filosofia kuin yleisessä valvontaoppaassamme sekä suodattimien ja kuvausten oppaassa.
Miten valvoa verkkosivuston muutoksia →Suodatinopas
Esimerkkejä toimivista ja vältettävistä tavoista ohjeistusta laadittaessa.
Suodattimet ja kuvaukset →Kiintiöt, joilla on oikeasti väliä (ja ne, joilla ei ole)
Page Deltasissa suunnittelun perustana on seuraamiesi URL-osoitteiden (tai sivustokarttojen) määrä, ei kuukausittainen tarkistuskiintiö. Rajapinnan luku- ja kirjoituspäätepisteillä ei ole kiinteää hintalappua kohtuullisen käytön puitteissa. Poikkeuksena on check-now: 1 pyyntö / minuutti / monitori (palauttaa tilakoodin 429 ja Retry-After-otsakkeen rajan ylittyessä). Pakettisi URL-rajan saavuttaminen palauttaa tilakoodin 422 nykyisellä määrällä ja sallitulla rajalla. Perinteiset tarkistusmäärään perustuvat työkalut pakottavat laskemaan («tunti tarkistus yhdellä sivulla ≈ 720 tarkistusta/kuukausi»). Täällä valitset sivut ja kirjoitat ohjeen. Tarkistustaajuus mukautuu automaattisesti.
Free
10 valvottua URL-osoitetta · 14 päivän historia · rajattomat tarkistukset (best-effort), tekoäly, API, MCP, kaikki 5 ilmoituskanavaa · 0 $
Starter
150 valvottua URL-osoitetta · 30 päivän historia · 29 $/kk · priorisoidut tarkistukset
Pro
1 000 valvottua URL-osoitetta · 90 päivän historia · 79 $/kk
Business
5 000 valvottua URL-osoitetta · 365 päivän historia · 199 $/kk
Scale
20 000 valvottua URL-osoitetta · 730 päivän historia · 499 $/kk
Enterprise
Räätälöity URL-määrä ja historia · SSO / SCIM
Miten tämä eroaa Visualping-tyylisestä muutos-APIsta
Visualpingin kehittäjäsisällöt perustuvat kiinteisiin tarkistusväleihin, valinnaiseen CSS/XPath-rajaukseen, kuukausittaiseen tarkistuskiintiöön ja laajaan webhook-kuormaan pikselieroineen ja tärkeyslippuineen. Se toimii, jos tavoitteena on: "laukea kun pikselit liikkuivat, ja anna oman koodini päättää loput". Page Deltas on rakennettu mallille: "herätä järjestelmäni vain silloin, kun muutos vastaa annettua ohjetta". Tämä opas on tekninen integraatio-ohje; täysi pakettikohtainen vertailu löytyy sivulta Page Deltas vs Visualping.
Luonnollisen kielen ohjeistus ensin
Pääasiallinen suodatin on sanallinen ohje. Valitsimet ovat valinnaisia, eivät pakollisia.
Mukautuva tarkistustahti
Aika-aikavälejä ei tarvitse syöttää käsin. Aktiivisia sivuja tarkistetaan useammin, rauhallisia harvemmin.
Selkeä ja suoraviivainen webhook-rakenne
Keskittyy summary-kenttään, kuvakaappausten URL-osoitteisiin sekä HMAC X-Signature -varmenteeseen.
Rajattomat tarkistukset; maksa URL-määristä
Kaikki paketit sisältävät rajattomasti tarkistuksia. Maksat vain siitä, kuinka montaa URL-osoitetta valvot.
MCP samoilla avaimilla
MCP käyttää täsmälleen samoja API-avaimia kuin REST-rajapinta.
Täysi tuotevertailu
Pakettikohtainen suora vertailu Page Deltasin ja Visualpingin välillä.
Page Deltas vs Visualping →Rehelliset rajoitukset
Tiedosta, mitä tämä muutosvirta on ja mitä se ei ole, ennen kuin kytket sen tuotantojärjestelmiin.
Vain julkiset verkkosivut
Markkinointisivustot, julkiset PDF:t, julkiset rekrytointisivut, julkiset sivustokartat. Kirjautumisen takana olevat portaalit ovat kehityssuunnitelmassa, mutta eivät saatavilla tänään.
Ei työkalu visuaaliseen regressiotestaukseen
Jos tehtävänä on selvittää "liikahtiko tämä pikseli 20px", visuaalisiin eroihin erikoistunut työkalu on edelleen parempi ratkaisu.
Ei LinkedIn- tai X-aktiivisuuden valvontaa
Page Deltas valvoo avointa verkkoa. Yksittäisten henkilöiden LinkedIn- ja X-profiiliaktiivisuus kuuluu MultiFollow'lle. Avainsanamaininnat LinkedInissä, X:ssä, Redditissä ja muualla kuuluvat KWatchille.
Webhook-toimitus on toistaiseksi kertayritys
Rakenna vastaanottavista päätepisteistä idempotentteja.
Älä keksitse omia vastauksen kenttänimiä
Kopioi rakenteet suoraan ajantasaisesta API-viitteestä ja jätä tuntemattomat JSON-avaimet huomiotta.
API-viite →Aiheeseen liittyvät oppaat ja dokumentaatio
Tarkempi käyttöönotto Slackissa tiimeille, kooditon pika-aloitus sekä viralliset rajapintamuodot.
Slack-muutosilmoitukset
Liitä sama monitori saapuvaan Slack-webhookiin lähettääksesi ilmoituksia koodin sijaan ihmisille.
Miten saada ilmoituksia verkkosivuston muutoksista Slackiin →Pika-aloitus
Kooditon polku: syötä URL, kirjoita ohjeistus, valitse kanava ja paina Lähetä testi.
Pika-aloitus →API-viite
Pyyntöjen ja vastausten ajantasaiset rakenteet. Kopioi kentät täältä ja jätä tuntemattomat JSON-avaimet huomiotta.
API-viite →MCP-dokumentaatio
Asiakasesimerkit Claude Codelle, Cursorille, VS Codelle ja Claude Desktopille.
MCP-dokumentaatio →Usein kysytyt kysymykset
- Miten noudan dataa verkkosivustolta, jolla ei ole APIa?
- Käytössäsi on kolme vaihtoehtoa: rakenna oma kaapain, käytä kaavintarajapintaa massanoutoon tai osoita muutosvalvonta-API sivuun ja vastaanota JSON-muutosvirtaa. Tarpeeseen "ilmoita järjestelmälleni, kun tämä sivu muuttuu", muutosvirta vaatii yleensä vähiten koodia: luo monitori ja ota käyttöön webhook tai kysely.
- Voinko tehdä tämän ilman koodaamista?
- Kyllä. Luo monitori hallintapaneelissa, lisää yleinen webhook (tai Slack / Teams / Discord / sähköposti) Kanavat-osiossa, kirjoita ohjeistus ja napsauta Lähetä testi. Pika-aloitusopas esittelee koodittoman polun.
- Mitä eroa on kaavintarajapinnalla ja muutosvalvonta-APIlla?
- Kaavintarajapinta noutaa sivun koko sisällön jokaisella kutsukerralla. Muutosvalvonta-API tarkkailee sivua ja lähettää ainoastaan havaitut muutokset valmiiksi lasketun tekoälytiivistelmän kera. Pelkän sisällön keräämiseen tarvitaan kaapaimia. Kysymykseen "muuttuiko mikään ohjeeni mukainen asia?" vastaa parhaiten muutosvirta.
- Maksavatko API- tai webhook-yhteydet ylimääräistä?
- Eivät. REST API, MCP ja allekirjoitetut webhookit sisältyvät kaikkiin paketteihin, myös ilmaiseen Free-pakettiin. Käyttöä rajoittaa vain pakettisi valvottujen URL-osoitteiden enimmäismäärä, ei erillinen API-krediittilaskuri.
- Voivatko tekoälyagentit luoda monitoreja puolestani?
- Kyllä. Osoita MCP-asiakasohjelma osoitteeseen https://api.pagedeltas.com/mcp käyttäen Bearer API-avainta. Katso lisätiedot MCP-dokumentaatiosta.
Kirjoittaja
Julien, tuotepäällikkö Page Deltasilla. Valitse yksi julkinen URL-osoite, jota päivität jo nyt käsin. Luo ilmainen tili, generoi API-avain, luo monitori yhden virkkeen ohjeistuksella, liitä yleinen webhook, vahvista HMAC-allekirjoitus kerran ja odota ensimmäistä todellista osumaa. Hienosäädä poissuljettujen asioiden luetteloa ensimmäisen turhan ilmoituksen jälkeen. Siinä on yleensä muutosrajapinnan koko käyttöönotto.
Aloita yhdellä sivulla muutosvirtana
Ilmainen paketti, ei vaadi luottokorttia. Luo tili, luo API-avain, syötä seuraamasi URL-osoite, lisää ohje suodatinoppaasta ja valitse joko /changes-kyselyt tai allekirjoitetun JSONin vastaanotto POST-pyyntöinä omaan päätepisteeseesi.