Dla agentów AI

Inkluso dla agentów AI

Większość tej witryny napisano dla ludzi. Ta strona jest dla oprogramowania, które kupuje, porównuje albo sprawdza dostawców w czyimś imieniu. Opisuje pięć punktów końcowych, które Inkluso otwiera klientom automatycznym, co dokładnie zwracają i jak często wolno je wywoływać.

Agent AI może za pomocą Inkluso uruchomić bezpłatny skan strony głównej według WCAG 2.1 AA, przygotować projekt informacji o dostępności i przekazać kupującemu link do płatności Stripe za płatny audyt od 149 EUR. Łączy się przez serwer MCP pod adresem https://inkluso.eu/mcp, z którego mogą korzystać Claude i inni klienci MCP, albo przez pięć endpointów HTTP opisanych w openapi.json, bez klucza i bez rejestracji. Wersje dla ludzi: bezpłatny test dostępności i generator informacji o dostępności (EAA).

Co jest otwarte, a co nie

Plik robots.txt blokuje całe /api/, a następnie pięcioma regułami Allow otwiera z powrotem dokładnie pięć ścieżek: bezpłatny skan, generator informacji o dostępności, ofertę maszynową, zakup i zapytanie o status zamówienia. Nic więcej pod /api/ nie jest przeznaczone do wywołań automatycznych: pełny skan i raport wymagają danych operatora, a pozostałe ścieżki obsługują witrynę, płatności i konto klienta.

Żaden z tych pięciu punktów nie wymaga klucza, rejestracji ani ciasteczka. Żądania i odpowiedzi są w JSON. Wersję maszynową tej strony znajdziesz w openapi.json (OpenAPI 3.1), w llms.txt, a kontrakt ofertowy pod adresem /api/offers.json.

Wyników nie pisze model językowy

Ustalenia pochodzą z axe-core, deterministycznego silnika reguł, a odwołania prawne ze stałej tabeli mapowania. Ani tekst raportu, ani projekt informacji o dostępności nie są generowane przez model językowy. Ta sama strona przy dwóch skanach zwróci więc te same ustalenia, a każde z nich niesie "ai_generated": false.

Pięć punktów końcowych

Bezpłatny skan jednej strony

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

Bezpłatnie · limit 5 wywołań na godzinę z jednego IP · tylko strona główna

Sprawdza podany adres wobec WCAG 2.1 AA i mapuje ustalenia na prawo wybrane polem lang. Najpoważniejsze ustalenie wraca w całości, wraz z odwołaniem prawnym; pozostałe pojawiają się w locked_violations wyłącznie jako waga i liczba wystąpień.

  • Wywołanie trwa około 30 sekund: serwer uruchamia prawdziwą przeglądarkę i renderuje stronę. Ustaw limit czasu klienta na co najmniej 60 sekund.
  • Adres musi wskazywać publiczny host. Brakujący schemat zostanie uzupełniony do https://, a adresy wewnętrzne i lokalne są odrzucane kodem 422.
  • Pole scan_status to autodiagnoza skanu. Wartość "bot_challenge" oznacza, że WAF badanej witryny zablokował skaner, to nie jest dobra ocena, tylko brak oceny.
  • Błędy: 422 (nieprawidłowy adres albo nie było czego skanować), 429 (limit), 503 (skaner zajęty), 504 (skan przekroczył próg 300 sekund).
curl -sS -X POST https://inkluso.eu/api/scan/free \
     -H 'Content-Type: application/json' \
     --max-time 90 \
     -d '{"url": "https://example.cz", "lang": "pl"}'

Projekt informacji o dostępności

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

Bezpłatnie · limit 20 wywołań na minutę z jednego IP · nic nie jest zapisywane

Składa projekt informacji o dostępności z przesłanych danych. Nie uruchamia skanu, niczego nie zapisuje, nie wysyła e-maila i nie zakłada konta. Odpowiedź ma dwa pola: statement (obiekt strukturalny) i text (ten sam dokument jako zwykły tekst do wklejenia w CMS).

  • conformance_status przyjmuje tylko "partial", "none" albo "not_assessed". Wartość "full" jest celowo niedozwolona: pełnej zgodności nie da się zadeklarować o sobie, można ją tylko zmierzyć.
  • known_issues przyjmuje najwyżej 20 pozycji, każdą do 300 znaków; dłuższe dane są przycinane, a nie odrzucane.
  • Informacja jest oświadczeniem własnym podmiotu. Inkluso nie weryfikuje żadnej z podanych informacji i tekst mówi to wprost.
  • Błędy: 422 (nieprawidłowy adres, pusta nazwa podmiotu, niedozwolony conformance_status, błędny 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.cz",
          "lang": "pl",
          "conformance_status": "partial",
          "known_issues": ["Two PDFs published before 2024 are not tagged."]}'

Status zamówienia

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

Bezpłatnie · limit 30 wywołań na godzinę z jednego IP · każda odpowiedź niesie X-Robots-Tag: noindex

Zamienia referencję zamówienia na stan realizacji, a po jej zakończeniu na adres raportu. Referencja powstaje przy tworzeniu zamówienia i nie jest tokenem raportu, ten nie istnieje aż do końca realizacji.

  • 404 {"detail": "Order not found"}: taka referencja nie istnieje; przestań pytać.
  • 202 {"status": "pending"}: zamówienie istnieje, realizacja jeszcze trwa.
  • 200 {"status": "fulfilled", "report_url": "/api/reports/{token}"}: gotowe.
  • 200 {"status": "failed"}: przebieg nie został ukończony i nie ma report_url. Status failed nie obejmuje uprawnienia do bezpłatnego ponownego skanu. Przestań pytać.
  • 200 {"status": "expired"}: strona płatności wygasła bez płatności. Jeśli kupujący nadal chce audytu, rozpocznij nowe zamówienie. Przestań pytać.
  • Realizacja obejmuje skan całej witryny i wygenerowanie PDF, licz w minutach. Przy 30 wywołaniach na godzinę praktyczny pułap to jedno zapytanie co dwie minuty; jedno co pięć minut jest wzorcem bezpiecznym.
curl -sS -i https://inkluso.eu/api/orders/9f2c1d7a8b6e4f0c

HTTP/2 202
x-robots-tag: noindex

{"status": "pending"}

Kup audyt albo uruchom monitoring

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

Płatne · limit 10 wywołań na minutę z jednego IP

Tworzy sesję Stripe Checkout i zwraca jej adres. Sama płatność odbywa się w Stripe, nie tutaj: dane karty nigdy nie trafiają do tego endpointu. Pole tier wybiera produkt: scan_report to jednorazowy audyt (od 149 EUR lub równowartości w innej walucie); monitor_annual to cykliczna subskrypcja monitoringu rozliczana rocznie (490 EUR / 11 900 Kč / 2 190 zł); plan miesięczny (monitor) nie jest już sprzedawany i jest odrzucany z kodem 422; agency jest prowadzone sprzedażowo (cena za tą wartością to tylko punkt odniesienia, nie cena oferowana, agencje powinny skorzystać ze ścieżki sprzedażowej); shoptet_audit to jednorazowy audyt sklepu na Shoptet (99 EUR / 2 490 Kč / 449 zł; waluta rozliczenia zależy od lang).

  • consent musi mieć wartość true. Potwierdza, że zamawiasz jako przedsiębiorca, akceptujesz regulamin i przyjmujesz do wiadomości politykę prywatności (oba dokumenty na https://inkluso.eu/legal). Nie jest wymagane zrzeczenie się prawa odstąpienia. Wartość false lub brak pola zwraca 422 ("Order confirmation is required: ...") i zamówienie nie powstaje. Formularze internetowe z informacją o zamówieniu wysyłają zamiast consent order_notice: true; wywołania API i agenci wysyłają consent. Nie wysyłaj true w imieniu człowieka bez jego faktycznej zgody.
  • Waluta wynika z pola lang: cs rozlicza się w CZK, pl w PLN, a pozostałe języki (de, en) w EUR. To nie jest przeliczenie jednej kwoty, każda waluta ma własny cennik. Jedynym źródłem prawdy jest price_for_tier() w backend.billing.stripe.
  • Opcjonalny nagłówek Idempotency-Key: wygeneruj samodzielnie świeżą, unikalną wartość dla KAŻDEGO zamiaru zakupu (np. UUID v4). Klucz jest powiązany z Twoim dokładnym żądaniem (e-mail, url, taryfa, język): powtórzenie z TAKIM SAMYM żądaniem w ciągu 24 godzin zwraca TAKI SAM order_ref, checkout_url, amount i currency; ten sam klucz z INNYMI danymi zwraca 422. Klucz użyty ponownie w trakcie przetwarzania zwraca 503, spróbuj ponownie za chwilę. Nigdy nie kopiuj klucza z dokumentacji ani z innego żądania.
  • Błędy: 422 (ani consent, ani order_notice nie jest true, nieprawidłowy adres albo brakujące/błędne pole), 429 (limit żądań albo więcej niż 5 nieopłaconych zamówień na jeden e-mail od tego samego wywołującego w ciągu 24 godzin: nagłówek Retry-After podaje kiedy; ponowienie z tym samym Idempotency-Key nadal zwraca to samo zamówienie), 503 (Idempotency-Key jest właśnie przetwarzany albo dostawca płatności jest chwilowo źle skonfigurowany), 500 (system płatności niedostępny).
curl -sS -X POST https://inkluso.eu/api/billing/checkout \
     -H 'Content-Type: application/json' \
     -H 'Idempotency-Key: ' \
     -d '{"email": "buyer@example.cz", "tier": "scan_report",
          "url": "https://example.cz", "lang": "pl", "consent": true,
          "company": "Example s.r.o.", "business_affirmation": true}'

Następnie odpytuj GET /api/orders/{order_ref} powyżej, aż stan zmieni się na "fulfilled", "failed" lub "expired".

Serwer MCP

Te same cztery możliwości istnieją też jako natywny serwer MCP dla klientów obsługujących Model Context Protocol (Claude, Cursor i inne środowiska agentowe), bez własnego kodu HTTP:

Endpoint:  https://inkluso.eu/mcp        (Streamable HTTP, tylko POST, bezstanowy)
Narzędzia: scan_accessibility, draft_accessibility_statement,
           start_audit_checkout, check_order_status
Auth:      brak

Karta serwera: /.well-known/mcp.json. Semantyka narzędzi dokładnie odzwierciedla endpointy HTTP: ta sama walidacja, te same limity na IP, to samo zachowanie Idempotency-Key (przekazywany jako argument idempotency_key narzędzia start_audit_checkout), a argument consent niesie tę samą wyraźną zgodę opisaną wyżej. start_audit_checkout zwraca URL płatności hostowany przez Stripe, na którym płaci człowiek, narzędzie samo nigdy nie pobiera płatności. Jedyna różnica wobec HTTP: narzędzia zwracają report_url jako absolutny URL, ponieważ wywołujący przez MCP nie ma origin, względem którego mógłby rozwiązać ścieżkę względną.

Skill agenta (instalacja): npx skills add maticijus/hexenkraft-agent-skills --skill inkluso-eaa-scan - https://skills.sh/maticijus/hexenkraft-agent-skills/inkluso-eaa-scan

Pytania agentów i ich twórców

Jak połączyć Inkluso z Claude?

Claude, Cursor i inni klienci Model Context Protocol dodają serwer https://inkluso.eu/mcp (Streamable HTTP, bez uwierzytelniania), który udostępnia cztery narzędzia. Agent, który nie korzysta z MCP, na przykład własny GPT z akcjami (Actions) w ChatGPT, może wywoływać te same funkcje przez HTTP, opisane w openapi.json.

Co zwraca bezpłatny skan?

Sprawdza jedną stronę, główną, według WCAG 2.1 AA. Najpoważniejsze ustalenie wraca w całości wraz z odniesieniem prawnym, wszystkie pozostałe tylko z wagą i liczbą wystąpień. Jedno wywołanie trwa około 30 sekund. Wersja dla ludzi: bezpłatny test dostępności.

Jak kupuje się płatny audyt?

Agent wywołuje start_audit_checkout (przez HTTP: POST /api/billing/checkout) z consent i business_affirmation ustawionymi na true i dostaje adres płatności hostowanej przez Stripe. Nie wysyłaj true w imieniu człowieka bez jego faktycznej zgody. Kupujący, człowiek, płaci na tej stronie, narzędzie samo nigdy nie przyjmuje płatności. Jednorazowy audyt kosztuje od 149 EUR, potem agent sprawdza status zamówienia, aż raport będzie gotowy.

Jakie przepisy cytuje Inkluso?

Wyniki są przypisywane do krajowego aktu, który wdraża europejski akt o dostępności, a o tym, który to akt, decyduje język zapytania: de cytuje BFSG, cs zákon č. 424/2023 Sb., pl ustawę z 26 kwietnia 2024, sk zákon č. 351/2022 Z. z., a en samą dyrektywę (UE) 2019/882. Jeśli znasz rynek, przekaż argument jurisdiction narzędzia skanującego; tylko tak można dotrzeć do austriackiej ustawy BaFG. Wyjątek: raport pl dla hosta gov.pl lub edu.pl cytuje ustawę z dnia 4 kwietnia 2019 r. (podmioty publiczne), która wdraża dyrektywę (UE) 2016/2102, a odpowiedź ustawia regime; przekaż regime_scope razem z cytowaniem, a dla innej witryny, o której wiesz, że należy do podmiotu publicznego, otwórz report_url z ?regime=pl-pub. Płatny raport PDF przypisuje wyniki do ustawy z dnia 4 kwietnia 2019 r., gdy audyt zamówiono na stronie report_url, która pokazuje wyniki z przepisami tej ustawy. Dla zamówienia pl złożonego przez start_audit_checkout (to narzędzie nie ma argumentu jurisdiction) płatny raport PDF przypisuje wyniki do ustawy z dnia 26 kwietnia 2024 r. Inkluso nie rozstrzyga, który akt dotyczy danej firmy. Skan to dowód, a nie certyfikacja ani porada prawna. Przygotowujesz informację o dostępności? Generator informacji o dostępności (EAA).

Jakie obowiązują limity wywołań?

Bezpłatny skan pozwala na 5 wywołań na godzinę na adres IP i sprawdza tylko stronę główną. Projekt informacji o dostępności pozwala na 20 wywołań na minutę, status zamówienia na 30 wywołań na godzinę, a płatność na 10 wywołań na minutę. Dla skanów ustaw timeout klienta na co najmniej 60 sekund.

Kontakt

Operator: HEXENKRAFT s.r.o., matic@hexenkraft.cz. Niedziałający punkt końcowy, błędne mapowanie prawne albo limit blokujący uczciwą integrację zgłoś na ten adres.