Overzicht van tools

Beschikbaar opelk abonnement

Als je een AI-client met Cabin verbindt, krijgt die toegang tot de tools hieronder. Je assistent kiest welke hij aanroept op basis van wat je vraagt. De tools zijn ingedeeld naar wat ze doen:

• Leestools halen alleen gegevens op en zijn altijd veilig om te gebruiken.
• Schrijftools maken of wijzigen gegevens: de meeste clients vragen je eerst om bevestiging.
• Destructieve tools verwijderen gegevens: clients vragen altijd eerst toestemming.

Elke tool werkt alleen met domeinen in je eigen account, en elke tool houdt zich aan je abonnement. Heeft een tool een functie nodig die jij niet hebt, dan zegt hij dat, in plaats van halve gegevens terug te geven.

Leestools

list_domains

Toont elk domein in je account, elk met de URL van het privédashboard (en de URL van het openbare dashboard als delen aanstaat). Geen parameters.

get_analytics

Statistieken voor een domein over een periode: paginaweergaven, unieke bezoekers, sessies, toppagina's en verwijzers.

• domain: het domein om op te vragen (bijv. example.com)
• date_from, date_to: de periode, in het formaat YYYY-MM-DD
• scope: wat erin moet: core, pages, referrals of een combinatie (standaard core)
• limit_lists: aantal items per lijst (standaard 50)

get_domain_settings

De huidige instellingen van een van je domeinen: tijdzone, status van het openbare dashboard, ontvangers van het wekelijkse rapport, eigen scripthost, merkkleur en de lijst met uitgesloten IP-adressen. Lees dit voordat je emailRecipients of excludeIps wijzigt, want die vervangen allebei de hele lijst.

• domain: het domein om te lezen

validate_installation

Controleert of het trackingscript van Cabin goed is geïnstalleerd op een van je domeinen.

• domain: het domein om te controleren

check_custom_domain_dns

Controleert of de CNAME van een eigen subdomein goed naar custom.withcabin.com wijst.

• custom: het eigen subdomein om te controleren (bijv. stats.example.com)

analyse_page

Voert een analyse van CO₂/energie en prestaties uit op één URL, inclusief historische gemiddelden. URL's die Cabin nog niet eerder heeft gezien kunnen 20 tot 30 seconden duren.

• url: de volledige URL om te analyseren (bijv. https://example.com/about)
• force: opnieuw uitvoeren, ook als er al een recente analyse is (standaard false)

Schrijftools

create_domain

Voegt een nieuw domein toe aan je account. Geeft de URL van het dashboard terug en het fragment van het trackingscript om te installeren.

• domain: het domein om toe te voegen (zonder protocol of pad)
• tz: IANA-tijdzone voor de statistieken, bijv. Europe/London (standaard UTC)

update_domain_settings

Wijzigt een of meer instellingen van een domein dat van jou is.

• domain: het domein om te wijzigen
• public: het dashboard openbaar toegankelijk maken
• publicPassword: het openbare dashboard met een wachtwoord beveiligen; een lege string haalt het wachtwoord weg (Plus en Scale)
• privacypage: een privacyverklaring tonen op het openbare dashboard
• emailRecipients: array van e-mailadressen die het wekelijkse rapport van dit domein ontvangen (Plus stuurt alleen naar het e-mailadres van je eigen account, Scale naar iedereen). Vervangt de hele lijst. Wil je één adres toevoegen of verwijderen, lees dan eerst de huidige ontvangers met list_domains en stuur daarna de volledige bijgewerkte lijst. Een lege array stopt alle wekelijkse e-mails.
• tz: IANA-tijdzone
• color: merkkleur van het dashboard (hex)
• excludeIps: array van maximaal 30 IP-adressen of CIDR-bereiken (IPv4 of IPv6) waarvan de bezoeken bij binnenkomst worden weggegooid. Vervangt de hele lijst; geef [] mee om hem leeg te maken. Als je deze lijst via een AI-client instelt of leest, deel je die adressen met de aanbieder van die client.

add_custom_domain

Koppelt een eigen subdomein, zodat het trackingscript vanaf je eigen host wordt geladen en adblockers wordt omzeild. Geeft instructies voor de DNS-instellingen terug en de nieuwe <script>-tag om te installeren zodra de DNS is geverifieerd (Plus en Scale).

• domain: het Cabin-domein waar het subdomein naar wijst
• custom: het subdomein om te gebruiken, bijv. stats.example.com (vermijd namen als analytics, tracker of stats, waar adblockers zelf op letten)

Destructieve tools

delete_domain

Verwijdert een domein definitief uit je account; de statistieken worden daarna ingepland voor verwijdering. Dit kan niet ongedaan worden gemaakt.

• domain: het domein om te verwijderen

remove_custom_domain

Ontkoppelt een eigen subdomein van een domein dat van jou is, en geeft de scripttag met de standaardhost terug om weer op je site te zetten.

• domain: het Cabin-domein waaraan het subdomein gekoppeld is
• custom: het subdomein om te verwijderen