Pre AI agentov

Inkluso pre AI agentov

Väčšina webu je písaná pre ľudí. Táto stránka je pre softvér, ktorý nakupuje, porovnáva alebo preveruje dodávateľov za niekoho iného. Opisuje päť endpointov, ktoré Inkluso otvára automatickým klientom, čo presne vracajú a ako často sa smú volať.

AI agent môže s Inkluso spustiť bezplatný sken úvodnej stránky podľa WCAG 2.1 AA, navrhnúť informácie o prístupnosti a odovzdať ľudskému kupujúcemu odkaz na platbu cez Stripe za platený audit od 149 EUR. Pripojí sa cez MCP server na https://inkluso.eu/mcp, ktorý vedia používať Claude aj ďalší MCP klienti, alebo cez päť HTTP endpointov opísaných v openapi.json, bez kľúča a bez registrácie. Verzie pre ľudí: bezplatný test prístupnosti a generátor informácií o prístupnosti.

Čo je otvorené a čo nie

Súbor robots.txt zakazuje celé /api/ a potom piatimi pravidlami typu Allow znovu otvára presne päť ciest: bezplatný sken, generátor informácií o prístupnosti, strojovo čitateľnú ponuku, nákup a dopyt na stav objednávky. Nič ďalšie pod /api/ nie je určené na automatické volanie: sken a report v plnom rozsahu vyžadujú prihlásenie prevádzkovateľa, ostatné cesty obsluhujú web, platby a zákaznícky účet.

Žiadny z tých piatich endpointov nepotrebuje kľúč, registráciu ani cookie. Požiadavky aj odpovede sú JSON. Strojovo čitateľná verzia tejto stránky je v openapi.json (OpenAPI 3.1), v llms.txt a ponuka s cenami je na /api/offers.json.

Výsledky nepíše jazykový model

Zistenia pochádzajú z axe-core, deterministického pravidlového enginu, a právne odkazy z pevnej mapovacej tabuľky. Text reportu ani informácií o prístupnosti negeneruje jazykový model. Tá istá stránka preto pri dvoch skenoch vráti rovnaké zistenia a každé z nich nesie "ai_generated": false.

Päť endpointov

Bezplatný sken jednej stránky

POST https://inkluso.eu/api/scan/free

Zadarmo · limit 5 volaní za hodinu na IP · len domovská stránka

Skontroluje zadanú adresu podľa WCAG 2.1 AA a namapuje zistenia na zákon, ktorý určuje pole lang. Najzávažnejšie zistenie dostanete celé aj s právnym odkazom; ostatné sa vrátia len ako závažnosť a počet výskytov v poli locked_violations.

  • Volanie trvá zhruba 30 sekúnd: server spustí skutočný prehliadač a stránku vykreslí. Nastavte si klientský timeout aspoň 60 sekúnd.
  • Adresa musí smerovať na verejný host. Chýbajúca schéma sa doplní na https://, interné a lokálne adresy sa odmietnu s kódom 422.
  • Pole scan_status je vlastná diagnostika skenu. Hodnota "bot_challenge" znamená, že sken zablokoval WAF cieľového webu, taký výsledok nie je dobré hodnotenie, ale žiadne hodnotenie.
  • Chyby: 422 (neplatná adresa alebo nebolo čo skenovať), 429 (limit), 503 (skener je zaneprázdnený), 504 (sken prekročil časový strop 300 sekúnd).
curl -sS -X POST https://inkluso.eu/api/scan/free \
     -H 'Content-Type: application/json' \
     --max-time 90 \
     -d '{"url": "https://example.sk", "lang": "sk"}'

Návrh informácií o prístupnosti

POST https://inkluso.eu/api/statement/draft

Zadarmo · limit 20 volaní za minútu na IP · nič sa neukladá

Zostaví návrh informácií o prístupnosti z údajov, ktoré pošlete. Nebeží pri tom žiadny sken, nič sa neukladá, neodosiela sa e-mail a nevzniká účet. Odpoveď má dve polia: statement (štruktúrovaný objekt) a text (ten istý dokument ako čistý text na vloženie do CMS).

  • conformance_status smie byť len "partial", "none" alebo "not_assessed". Hodnota "full" je zámerne neprípustná: úplnú zhodu nemožno vyhlásiť o sebe, len zmerať.
  • known_issues berie najviac 20 položiek, každú najviac 300 znakov; dlhší vstup sa skráti, nie odmietne.
  • Informácie sú vlastné tvrdenie objednávateľa. Inkluso žiadny z uvedených údajov neoveruje a text to výslovne hovorí.
  • Chyby: 422 (neplatná adresa, prázdny názov subjektu, nepovolený conformance_status, chybný e-mail), 429 (limit).
curl -sS -X POST https://inkluso.eu/api/statement/draft \
     -H 'Content-Type: application/json' \
     -d '{"organisation": "Vzor s.r.o.",
          "url": "https://example.sk",
          "lang": "sk",
          "conformance_status": "partial",
          "known_issues": ["Two PDFs published before 2024 are not tagged."]}'

Stav objednávky

GET https://inkluso.eu/api/orders/{ref}

Zadarmo · limit 30 volaní za hodinu na IP · každá odpoveď nesie X-Robots-Tag: noindex

Prevedie referenciu objednávky na stav plnenia a po dokončení na adresu reportu. Referencia vzniká pri vytvorení objednávky a nie je totožná s tokenom reportu, ten do dokončenia plnenia neexistuje.

  • 404 {"detail": "Order not found"}: taká referencia neexistuje; prestaňte sa pýtať.
  • 202 {"status": "pending"}: objednávka existuje, plnenie ešte neskončilo.
  • 200 {"status": "fulfilled", "report_url": "/api/reports/{token}"}: hotovo.
  • 200 {"status": "failed"}: beh sa nedokončil a report_url chýba. Stav failed nezahŕňa nárok na bezplatný opakovaný sken. Prestaňte sa pýtať.
  • 200 {"status": "expired"}: platobná stránka vypršala bez platby. Ak kupujúci audit stále chce, založte novú objednávku. Prestaňte sa pýtať.
  • Plnenie zahŕňa sken celého webu a vygenerovanie PDF, počítajte s minútami. Pri limite 30 volaní za hodinu je praktický strop jeden dopyt za dve minúty; jeden dopyt za päť minút je bezpečný vzorec.
curl -sS -i https://inkluso.eu/api/orders/9f2c1d7a8b6e4f0c

HTTP/2 202
x-robots-tag: noindex

{"status": "pending"}

Kúpiť audit alebo spustiť monitoring

POST https://inkluso.eu/api/billing/checkout

Platené · limit 10 volaní za minútu na IP

Vytvorí platobnú reláciu Stripe Checkout a vráti jej adresu. Samotná platba prebehne na Stripe, nie tu: údaje o karte sa na tento endpoint nikdy neposielajú. Pole tier vyberá produkt: scan_report je jednorazový audit (od 149 EUR alebo ekvivalentu v inej mene); monitor_annual je opakované monitorovacie predplatné účtované ročne (490 EUR / 11 900 Kč / 2 190 zł); mesačný plán (monitor) sa už nepredáva a je odmietnutý s kódom 422; agency sa rieši obchodne (cena za touto hodnotou je len záchytný bod, nie ponúkaná cena, agentúry by mali použiť obchodný kanál); shoptet_audit je jednorazový audit e-shopu na Shoptete (99 EUR / 2 490 Kč / 449 zł; mena sa riadi poľom lang).

  • consent musí byť true. Potvrdzuje, že objednávate ako podnikateľ, prijímate obchodné podmienky a beriete na vedomie zásady ochrany osobných údajov (oboje na https://inkluso.eu/legal). Nežiada sa žiadne vzdanie sa práva na odstúpenie. Hodnota false alebo chýbajúce pole vráti 422 ("Order confirmation is required: ...") a objednávka nevznikne. Webové formuláre s oznámením o objednávke posielajú namiesto consent order_notice: true; API a agenti posielajú consent. Neposielajte true v mene človeka bez jeho skutočného súhlasu.
  • Mena sa riadi poľom lang: cs sa účtuje v CZK, pl v PLN, ostatné jazyky (de, en, sk) v EUR. Nejde o prepočet jednej sumy, každá mena má vlastný cenník. Jediným zdrojom pravdy je funkcia price_for_tier() v backend.billing.stripe.
  • Voliteľná hlavička Idempotency-Key: vygenerujte si sami čerstvú jedinečnú hodnotu pre KAŽDÝ nákupný zámer (napr. UUID v4). Kľúč je zviazaný s vaším presným požiadavkom (e-mail, url, tarif, jazyk): opakovanie s ROVNAKÝM požiadavkom do 24 hodín vráti ROVNAKÉ order_ref, checkout_url, amount a currency; rovnaký kľúč s INÝMI údajmi vráti 422. Kľúč použitý počas spracovania vráti 503, skúste to o chvíľu znova. Kľúč nikdy nekopírujte z dokumentácie ani z iného požiadavku.
  • Chyby: 422 (ani consent, ani order_notice nie je true, neplatná adresa alebo chýbajúce/chybné pole), 429 (limit požiadaviek alebo viac ako 5 nezaplatených objednávok na jeden e-mail od toho istého volajúceho za 24 hodín: hlavička Retry-After hovorí kedy; opakovanie s rovnakým Idempotency-Key sa stále vracia), 503 (Idempotency-Key sa práve spracúva, alebo je platobný poskytovateľ dočasne zle nakonfigurovaný), 500 (platobný systém nedostupný).
curl -sS -X POST https://inkluso.eu/api/billing/checkout \
     -H 'Content-Type: application/json' \
     -H 'Idempotency-Key: ' \
     -d '{"email": "buyer@example.sk", "tier": "scan_report",
          "url": "https://example.sk", "lang": "sk", "consent": true,
          "company": "Example s.r.o.", "business_affirmation": true}'

Potom opakovane volajte GET /api/orders/{order_ref} vyššie, kým sa stav nezmení na "fulfilled", "failed" alebo "expired".

MCP server

Rovnaké štyri schopnosti existujú aj ako natívny MCP server pre klientov s podporou Model Context Protocolu (Claude, Cursor a ďalšie agentné runtime prostredia), bez vlastného HTTP kódu:

Endpoint:  https://inkluso.eu/mcp        (Streamable HTTP, len POST, bezstavový)
Nástroje:  scan_accessibility, draft_accessibility_statement,
           start_audit_checkout, check_order_status
Auth:      žiadna

Karta servera: /.well-known/mcp.json. Sémantika nástrojov presne zrkadlí HTTP endpointy: rovnaká validácia, rovnaké limity na IP, rovnaké správanie Idempotency-Key (odovzdáva sa ako argument idempotency_key nástroja start_audit_checkout) a argument consent nesie ten istý výslovný súhlas opísaný vyššie. start_audit_checkout vracia platobnú URL hostovanú Stripom, ktorú platí človek, nástroj sám nikdy platbu nevykonáva.

Agent skill (inštalácia): npx skills add maticijus/hexenkraft-agent-skills --skill inkluso-eaa-scan - https://skills.sh/maticijus/hexenkraft-agent-skills/inkluso-eaa-scan

Otázky agentov a ich vývojárov

Ako pripojím Inkluso z Claude?

Claude, Cursor a ďalší klienti Model Context Protocol pridajú server https://inkluso.eu/mcp (Streamable HTTP, bez autentifikácie), ktorý ponúka štyri nástroje. Agent, ktorý nepoužíva MCP, napríklad vlastný GPT s akciami (Actions) v ChatGPT, môže rovnaké funkcie volať cez HTTP, opísané v openapi.json.

Čo vracia bezplatný sken?

Skontroluje jednu stránku, úvodnú, podľa WCAG 2.1 AA. Najzávažnejšie zistenie sa vráti celé s právnym odkazom, všetky ostatné len so závažnosťou a počtom výskytov. Jedno volanie trvá približne 30 sekúnd. Verzia pre ľudí: bezplatný test prístupnosti.

Ako sa kupuje platený audit?

Agent zavolá start_audit_checkout (cez HTTP: POST /api/billing/checkout) s consent a business_affirmation nastavenými na true a dostane adresu platby hostovanej na Stripe. Neposielajte true v mene človeka bez jeho skutočného súhlasu. Ľudský kupujúci zaplatí na tej stránke, nástroj platbu nikdy sám nevykoná. Jednorazový audit stojí od 149 EUR, potom agent sleduje stav objednávky, kým nie je report hotový.

Ktoré zákony Inkluso cituje?

Nálezy sa mapujú na národný zákon, ktorý preberá európsky akt o prístupnosti, a ktorý to je, sa riadi jazykom požiadavky: de cituje BFSG, cs zákon č. 424/2023 Sb., pl ustawa z 26 kwietnia 2024, sk zákon č. 351/2022 Z. z. a en priamo smernicu (EÚ) 2019/882. Keď trh poznáte, odovzdajte argument jurisdiction skenovacieho nástroja; len tak sa dostanete k rakúskemu BaFG. Výnimka: report pl pre host gov.pl alebo edu.pl cituje poľský zákon ustawa z dnia 4 kwietnia 2019 r. (subjekty verejného sektora), ktorý preberá smernicu (EÚ) 2016/2102, a odpoveď nastaví regime; s citáciou odovzdajte regime_scope a pre iný web, o ktorom viete, že patrí subjektu verejného sektora, otvorte report_url s ?regime=pl-pub. Platený PDF report cituje poľský zákon ustawa z dnia 4 kwietnia 2019 r., keď je audit objednaný na stránke report_url v čase, keď táto stránka tento zákon cituje. Pre objednávku pl cez start_audit_checkout, ktorý nemá argument jurisdiction, cituje platený PDF report poľský zákon ustawa z dnia 26 kwietnia 2024 r. Ktorý zákon sa na firmu vzťahuje, Inkluso nerozhoduje. Sken je podklad, nie certifikácia ani právne poradenstvo. Píšete informácie o prístupnosti? Generátor informácií o prístupnosti.

Aké platia limity volaní?

Sken zadarmo povoľuje 5 volaní za hodinu na IP a kontroluje len úvodnú stránku. Návrh informácií o prístupnosti povoľuje 20 volaní za minútu, stav objednávky 30 volaní za hodinu a platba 10 volaní za minútu. Pre skeny nastavte timeout klienta aspoň 60 sekúnd.

Kontakt

Prevádzkovateľ: HEXENKRAFT s.r.o., matic@hexenkraft.cz. Nefunkčný endpoint, chybné právne mapovanie alebo limit, ktorý blokuje legitímnu integráciu, nahláste na túto adresu.