CookiePalin käyttö Claude Coden kanssa

Ennen kuin aloitat

Claude Code: Tarvitset Claude Coden, Anthropicin tekoälypohjaisen ohjelmointityökalun, asennettuna ja sisäänkirjautuneena.

Node.js ja selain: Tarkistukset lataavat sivut selaimessa omalla koneellasi, joten tarvitset myös Node.js-version 24 tai uudemman sekä Google Chromen, Microsoft Edgen, Braven tai Chromiumin. Jos selaimesi on asennettu epätavalliseen paikkaan, aseta ympäristömuuttuja COOKIEPAL_BROWSER osoittamaan sen suoritettavaan tiedostoon.

Tili: Sivun tarkistamiseen et tarvitse CookiePal-tiliä. Tarvitset sen vain, kun haluat skannata, asentaa ja tarkistaa bannerin ylläpitämälläsi sivustolla, ja voit luoda tilin Claude Codesta kolmannessa vaiheessa.

Asenna lisäosa

Asenna Claude Codessa: Avaa Claude Code ja suorita nämä kolme komentoa yksi kerrallaan.

1/plugin marketplace add cookiepal/cookiepal-plugin
2/plugin install cookiepal@cookiepal
3/reload-plugins

Tai asenna päätteestä: Suorita nämä kaksi komentoa ja suorita sitten /reload-plugins jokaisessa jo avoinna olevassa Claude Code -istunnossa.

1claude plugin marketplace add cookiepal/cookiepal-plugin
2claude plugin install cookiepal@cookiepal

Tarkista yhteys: Suorita Claude Codessa /mcp. Sinun pitäisi nähdä plugin:cookiepal:cookiepal yhdistettynä. Jokainen CookiePal-komento alkaa /cookiepal:, joten kirjoittamalla sen näet ne kaikki.

Yhdistä tai luo tilisi

Suorita komento: Suorita /cookiepal:connect-account. Selaimeesi avautuu CookiePal-sivu.

1/cookiepal:connect-account

Kirjaudu sisään tai rekisteröidy: Jos olet jo kirjautunut CookiePaliin kyseisessä selaimessa, paina Yhdistä, niin olet valmis. Jos et, kirjaudu sisään, jatka Googlella tai luo ilmainen tili, palaa sitten sivulle ja paina Yhdistä. Salasanasi ei koskaan kulje Claude Coden kautta.

Mitä näet: Claude kertoo sähköpostiosoitteen, organisaation ja oletusverkkotunnuksen, joihin se on nyt yhdistetty. Yhdistäminen ei muuta tililläsi mitään muuta. Kun yhteys on muodostettu, voit kysyä Claudelta, mitä verkkotunnuksia tililläsi on, tai pyytää sitä lisäämään uuden. Tällä tavalla lisätty verkkotunnus alkaa ilmaisella paketilla, ja voit lisätä enintään 10 verkkotunnusta päivässä.

Asennustunnusta koskeva kysymys: Jos suostuit jakamaan asennustunnuksen ensimmäisen tarkistuksesi yhteydessä, sinulta kysytään jokaisella yhdistämiskerralla, liitetäänkö se tähän tiliin. Oletus on ei, ja yhdistäminen toimii kummin tahansa. Linkitys poistetaan 180 päivän kuluttua tai kun vastaat ei myöhemmällä yhdistämiskerralla.

Tarkista sivun evästeet ennen suostumusta

Milloin käyttää: Suorita /cookiepal:check-one-page sivun osoitteen kanssa selvittääksesi, mitä evästeitä ja seurantatyökaluja sivu asettaa ennen kuin kävijä on hyväksynyt mitään, ja mitä sen bannerin hyväksy- ja hylkää-painikkeet todella tekevät. Se toimii millä tahansa sivulla, johon koneesi pääsee, mukaan lukien localhost ja julkaisua edeltävät sivustot.

1/cookiepal:check-one-page https://example.com

Miten se toimii: Sivu ladataan kolme kertaa, joka kerta uudessa väliaikaisessa selainprofiilissa koneellasi. Saapumiskierros tallentaa, mitä asetettiin ennen kuin mitään napsautettiin, hyväksymiskierros painaa bannerin hyväksy-painiketta ja hylkäyskierros sen hylkää-painiketta. Se ei koskaan paina painiketta, josta se ei ole varma: jos se ei löydä banneria tai useampi painike täsmää, se raportoi saapumiskierroksen ja kertoo, että painikkeita ei testattu.

Tuloksen lukeminen: Saat jokaisen evästeen kategorioineen, jokaisen kolmannen osapuolen palvelimen, johon sivu otti yhteyttä, sekä sen, mikä muuttui kolmen kierroksen välillä. Kiinnitä eniten huomiota siihen, mikä on yhä käynnissä hylkäämisen jälkeen. Tulos selittää sitten löydökset suhteessa GDPR:ään, CCPA:han ja CPRA:han, LGPD:hen sekä Quebecin Law 25 -lakiin, erikseen kunkin lain osalta. Se ei koskaan väitä sivuston olevan vaatimustenmukainen, eikä se ole oikeudellista neuvontaa.

Muodon valitseminen: Lisää osoitteen perään html, markdown tai terminal saadaksesi paikallisen HTML-tiedoston, paikallisen Markdown-tiedoston tai tuloksen suoraan päätteeseesi. Lisää artifact julkaistaksesi sen claude.ai-palveluun; tämä kysyy ensin lupaa ja vaatii maksullisen claude.ai-tilauksen. Ilman muotoa ensimmäinen tarkistus kysyy, julkaistaanko claude.ai-palveluun. Oletus on ei, jolloin säilytetään paikallinen HTML-tiedosto, ja vastauksesi muistetaan. 20 viimeisimmän tarkistuksesi tiedostot säilytetään lisäosan datakansiossa. Kun suoritat komennon muodon kanssa ilman osoitetta, kyseisestä muodosta tulee oletuksesi.

Asennustunnus: Ensimmäinen tarkistus kysyy, jaetaanko satunnainen asennustunnus, jotta CookiePal voi laskea ihmisiä tarkistusten sijaan. Oletus on ei, ja tarkistus toimii kummin tahansa. Suorita /cookiepal:check-one-page stop-sharing milloin tahansa lopettaaksesi jakamisen, poistaaksesi sen alla tallennetut tarkistukset ja irrottaaksesi sen CookiePal-tilistäsi.

Skannaa verkkotunnuksesi

Milloin käyttää: Suorita /cookiepal:run-scan indeksoidaksesi yhden yhdistetyistä verkkotunnuksistasi ja päivittääksesi sen evästeraportin CookiePalissa. Indeksointi tapahtuu koneellasi, ei koskaan CookiePalin puolella. Se käyttää oletusverkkotunnustasi, ellet nimeä toista. Se vaatii yhdistetyn tilin ja tarkistetun bannerin, paitsi Claude Codesta lisäämäsi verkkotunnuksen ensimmäisessä skannauksessa.

1/cookiepal:run-scan

Tuloksen lukeminen: Useamman sivun indeksointi voi kestää muutaman minuutin, ja Claude kertoo sinulle, kun se on käynnissä. Kun se valmistuu, raportti tallennetaan CookiePaliin paikallisena skannauksena, ja Claude kertoo, kuinka monta sivua ja evästettä se kattaa. Pyydä Claudea lukemaan raportti sinulle, niin saat koko evästeluettelon.

Jos skannaus hylätään: Skannaus hylätään, jos verkkotunnuksen banneria ei ole tarkistettu, joten tarkista asennus ensin. Skannaus hylätään myös, kun verkkotunnus on käyttänyt kuukausittaisen skannauskiintiönsä: Claude kertoo luvut, ja kiintiö nollautuu seuraavan kuukauden alussa. Jos sivuston robots.txt estää indeksoinnin, Claude kertoo, mikä sivu estettiin ja mitä pitää sallia.

Selvitä, mihin bannerisi kuuluu

Milloin käyttää: Suorita /cookiepal:detect-stack sivustosi repositoriossa selvittääksesi, millä sovelluskehyksellä se on rakennettu ja mikä tiedosto renderöi sivun head-osion, muuttamatta mitään. Se tunnistaa Next.js:n, Nuxtin, Astron, Viten, Remixin, React Router v7:n, SvelteKitin ja Shopify-teemat, ja muussa tapauksessa se olettaa oman koontiversion (custom build).

1/cookiepal:detect-stack

Tuloksen lukeminen: Claude kertoo sovelluskehyksen, head-tiedoston ja signaalin, josta se tunnistettiin. Kun se sanoo custom build, kyseessä on paras arvaus HTML-koodisi perusteella, ei tunnistettu sovelluskehys. Jos useampi tiedosto voisi olla head-tiedosto, se listaa ne ja kysyy, mitä niistä julkiset sivusi käyttävät.

Asenna banneri koodiisi

Milloin käyttää: Kun verkkotunnuksesi on yhdistetty, suorita /cookiepal:install-banner sivustosi repositoriossa lisätäksesi CookiePal-bannerin tagin koodiisi. Se sijoittaa tagin sivun head-osioon niin aikaisin kuin sovelluskehyksesi sallii, jotta banneri voi estää skriptit ennen niiden latautumista.

1/cookiepal:install-banner

Tuloksen lukeminen: Claude näyttää muutoksen diff-muodossa ja jättää sen committaamatta. Se ei koskaan tee committia tai pushia, joten tarkista muutos, committaa se ja julkaise sivustosi tavalliseen tapaan. Repositorio, jossa tagi on jo, jätetään ennalleen, ja toisen verkkotunnuksen tagista ilmoitetaan sen sijaan, että lisättäisiin toinen banneri.

Sovita banneri ulkoasuusi

Milloin käyttää: Suorita /cookiepal:match-site-design sivustosi repositoriossa antaaksesi bannerille sivustoosi sopivat värit ja sijainnin. Se lukee design tokenisi, kuten Tailwind-konfiguraation, CSS-muuttujat tai teematiedoston.

1/cookiepal:match-site-design

Tuloksen lukeminen: Claude ehdottaa värit ja sijainnin, ja jokaisen värin kontrasti tarkistetaan WCAG AA -tason mukaisesti. Riittämätöntä väriä säädetään vain niin vähän kuin tarvitaan, ja muutos näytetään. Mitään ei tallenneta ennen kuin sanot kyllä. Jos repositoriossasi ei ole design tokeneita, Claude kertoo sen, ja bannerisi säilyttää nykyisen tyylinsä.

Tarkista asennus

Milloin käyttää: Kun muutoksesi on julkaistu, suorita /cookiepal:verify-installation varmistaaksesi, että banneri on käytössä. Se vaatii yhdistetyn tilin ja tarkistaa etusivusi, ellet lisää sivun osoitetta, esimerkiksi /cookiepal:verify-installation https://example.com/shop. Se lataa sivusi selaimessa koneellasi ja asettaa verkkotunnuksesi asennustilan CookiePalissa. Voit käyttää sitä myös pelkästään bannerin tagin hakemiseen, jos haluat liittää sen itse.

1/cookiepal:verify-installation

Tarkistettu: Banneri on käytössä, ja verkkotunnuksesi näkyy CookiePalissa asennettuna. Jos sivu lataa useamman kuin yhden CookiePal-bannerin skriptin, poista ylimääräinen, sillä kaksi banneria kilpailee suostumuksesta.

Epäonnistui: Claude kertoo syyn, kuten että tagi puuttuu sivulta tai tagi kuuluu toiselle verkkotunnukselle. Jos tagi on paikallaan mutta banneri ei koskaan käynnistynyt, sen estää yleensä toinen suostumustyökalu tai sisällön suojauskäytäntö (content security policy). Vapauta CookiePal-skripti kyseisestä estosta sen sijaan, että liittäisit tagin uudelleen.

Ei ratkaisevaa tulosta: Sivua ei voitu lukea, esimerkiksi koska se palautti virheen, aikakatkaistiin tai ohjasi toiselle sivustolle. Tilasi CookiePalissa ei muutu. Korjaa syy ja tarkista uudelleen.

Tarkista Google Consent Mode

Milloin käyttää: Jos sivustosi käyttää Google-tageja, suorita /cookiepal:check-gcm tarkistaaksesi, että Google Consent Mode on määritetty oikein. Se vaatii yhdistetyn tilin ja lukee etusivusi, ellet lisää sivun osoitetta. Sivu luetaan koneellasi, ja tulos asettaa verkkotunnuksesi Consent Mode -tilan CookiePalissa. Suorita se uudelleen niin usein kuin tarvitset ongelmaa korjatessasi: jokainen tarkistus korvaa edellisen.

1/cookiepal:check-gcm

Tuloksen lukeminen: Claude joko kertoo, että Consent Mode on määritetty oikein, tai nimeää yhden kolmesta ongelmasta ja sen korjauksen: Consent Modea ei löytynyt sivulta, sen oletusasetuksia ei ole asetettu tai oletukset asetetaan liian myöhään, jotta ne ehtisivät vaikuttaa. Ongelma pysyy verkkotunnuksellasi CookiePalissa, kunnes tarkistus menee läpi.

Mitä CookiePaliin lähetetään

Sivut ladataan koneellasi: CookiePal ei koskaan lataa sivujasi. Evästeet luokitellaan koneellasi avoimen lähdekoodin CookiePal-evästeluettelon perusteella, eikä tarkistus koskaan avaa omaa selainprofiiliasi, joten evästeitäsi ja kirjautumisiasi ei koskaan lueta.

Sivun tarkistus lähettää: sivun osoitteen ilman kyselymerkkijonoa; kunkin evästeen nimen, verkkotunnuksen, polun, vanhenemisajan, liput ja kategorian, mutta ei koskaan sen arvoa; kolmannen osapuolen palvelimet; mitä hyväksy- ja hylkää-painikkeet tekivät; lisäosan version; maan, josta tarkistus suoritettiin, IP-osoitteesi perusteella päätelty (IP-osoitetta ei tallenneta); sekä satunnaisen asennustunnuksen vain, jos suostuit jakamaan sen.

Muut komennot lähettävät vain tarvitsemansa, kun suoritat ne: tarkistus lähettää sivulta löytyneen CookiePal-skriptin, skannaus lähettää sivumäärän ja kunkin evästeen tiedot ilman arvoja, Consent Mode -tarkistus lähettää suostumusmerkintöjensä nimet ja bannerimuutokset lähettävät pyytämäsi asetukset. Bannerimuutokset tulevat voimaan heti, joten Claude Code pyytää sinua vahvistamaan jokaisen ensin.

Kaikki yksityiskohdat: Tallennetut tarkistukset poistetaan 180 päivän kuluttua. Lue tietosuojailmoitus saadaksesi tiedon kaikesta, mitä lisäosa lähettää ja säilyttää, sekä käyttöehdot isännöidyn palvelun osalta.

Päivitä ja poista asennus

Päivitä: Suorita nämä komennot päätteessäsi ja suorita sitten /reload-plugins jokaisessa jo avoinna olevassa Claude Code -istunnossa.

1claude plugin marketplace update cookiepal
2claude plugin update cookiepal@cookiepal

Poista asennus: Suorita nämä komennot poistaaksesi lisäosan kokonaan. Asennuksen poistaminen poistaa myös asennustunnuksen koneeltasi, mutta ei sen alla tallennettuja tarkistuksia, joten suorita ensin /cookiepal:check-one-page stop-sharing, jos haluat ne poistettavan.

1claude plugin uninstall cookiepal@cookiepal
2claude plugin marketplace remove cookiepal

Vianmääritys

Komennot eivät näy: Suorita /reload-plugins ja sitten /mcp, ja tarkista, että plugin:cookiepal:cookiepal näkyy yhdistettynä.

Selainta ei löytynyt: Asenna Google Chrome, Microsoft Edge, Brave tai Chromium, tai aseta COOKIEPAL_BROWSER osoittamaan käyttämäsi selaimen suoritettavaan tiedostoon.

Kirjautuminen ei avaudu: Suorita /mcp, valitse cookiepal, valitse Authenticate ja suorita sitten /cookiepal:connect-account uudelleen.

Yhä jumissa: Lähetä sähköpostia osoitteeseen support@cookiepal.io ja kerro suorittamasi komento ja mitä Claude vastasi.