API prześwietlarki stron

Zacznij tutaj

Jedno polecenie, żeby zobaczyć odpowiedź

Odczyt zapisanego wyniku nie wymaga klucza. Wystarczy klucz raportu, ten sam, który widzisz w adresie po prześwietleniu strony w przeglądarce.

curl https://klyo.pl/api/przeswietl/v1/wynik/KLUCZ

Gotowe przykłady na GitHubie curl · JavaScript · Python · PHP · Rust

Nie masz jeszcze żadnego klucza? Prześwietl dowolną stronę — klucz pojawi się w adresie wyniku.

Dwa adresy

Wszystko, co API potrafi

GET `/api/przeswietl/v1/wynik/{klucz}`

Zwraca zapisany raport. Bez klucza dostępu i bez limitu — sam klucz raportu jest przepustką. Odpowiedź jest z pamięci podręcznej, więc przychodzi w ułamku milisekundy.

curl https://klyo.pl/api/przeswietl/v1/wynik/mtu9hfexbh

Kody odpowiedzi: 200 wynik, 400 zły format klucza, 404 nie ma takiego wyniku.

klw `przeswietl.surowy`

Ten sam raport oddany jako gotowe bajty w formacie msgpack, prosto z bazy — bez rozpakowywania i bez składania JSON-a po drodze. Dla programów, które i tak czytają msgpack. Idzie po tym samym połączeniu WebSocket, którego używa nasza strona.

// połączenie: wss://klyo.pl/klw?gosc=1
klw.rpc("przeswietl.surowy", { klucz: "mtu9hfexbh" })
// → { content_type: "application/vnd.msgpack", size: 7760, bytes: … }

Klient przeglądarki (własny msgpack, 2 kB, bez zależności) jest w naszym repozytorium przykładów.

POST `/api/przeswietl/v1/badaj`

Prześwietla stronę od nowa. Wymaga klucza, bo każde wywołanie pobiera cudzą stronę. Pole konkurent jest opcjonalne — gdy je podasz, w odpowiedzi dojdzie drugi raport i lista co_dorobic.

curl -X POST https://klyo.pl/api/przeswietl/v1/badaj \
  -H "Authorization: Bearer klyo_sk_TWOJ_KLUCZ" \
  -H "Content-Type: application/json" \
  -d '{"adres":"twojafirma.pl","konkurent":"konkurencja.pl"}'

Kody odpowiedzi: 200 raport, 401 brak lub zły klucz, 403 klucz bez uprawnienia „przeswietl”, 409 strona chroni się przed automatami, 429 limit, 503 kolejka zajęta.

Dla asystentów AI

Prześwietlarka jako narzędzie w Claude i ChatGPT

Nasz serwer MCP wystawia prześwietlarkę jako narzędzie, z którego asystent korzysta sam. Poprosisz go „prześwietl stronę konkurencji i powiedz, co mam poprawić”, a on zrobi to przez nas i odpowie na podstawie prawdziwego pomiaru, nie zgadywania.

`klyo_przeswietl_strone`

Adres serwera: https://panel.klyo.pl/mcp. Logowanie przez OAuth, uprawnienie klyo:read. Narzędzie przyjmuje adres i opcjonalnie konkurent, zwraca ten sam raport co API. Niczego nie zmienia — tylko czyta.

Limit: 120 prześwietleń na godzinę na konto.

Chcesz wpiąć to u siebie? Napisz — pomożemy z konfiguracją.

Co dostajesz

Najważniejsze pola odpowiedzi

Pełny raport ma ponad czterdzieści pól. Poniżej te, po które sięga się najczęściej.

Pole	Typ	Co znaczy
`klucz`	tekst	Dziesięć znaków. Adres wyniku i klucz do odczytu.
`oceny.ogolna`	0–100	Złożenie pięciu pozostałych ocen.
`oceny.google`	0–100	Widoczność w wyszukiwarce. Zero, gdy strona ma zakaz indeksowania.
`oceny.ai`	0–100	Czy stronę mogą przeczytać asystenci AI.
`oceny.szybkosc`	0–100	Liczona z tego, ile telefon naprawdę pobiera.
`silnik.nazwa`	tekst	WordPress, Wix, Shopify, strona pisana na zamówienie i tak dalej.
`silnik.kreator`	prawda/fałsz	Czy strona stoi na abonamencie kreatora.
`kb_pobierane`	liczba	Ile kilobajtów pobiera przeglądarka. Osobno `kb_kodu` po rozpakowaniu.
`ukryta_przed_google`	prawda/fałsz	Zakaz indeksowania. Unieważnia całą resztę raportu.
`ai.zablokowane`	lista	Asystenci, którym strona zabrania wstępu.
`frazy`	lista	Zwroty z liczbą wystąpień, udziałem i miejscem (tytuł, nagłówek, opis).
`usterki`	lista	Waga 0–2, tytuł, skutek i nasza usługa, która to naprawia.
`co_dorobic`	lista	Tylko przy podanym konkurencie: co on ma, a ty nie.

Kod do wklejenia

Przykłady w pięciu językach, na GitHubie

Gotowe do skopiowania wywołania w curl, JavaScripcie, Pythonie, PHP i Rust, prawdziwa odpowiedź z produkcji do podejrzenia oraz opis zabezpieczeń. Repozytorium zawiera dokumentację i przykłady — silnik analizy zostaje u nas.

github.com/krastranseu-lang/klyo-website-analyzer

Zasady

Czego oczekujemy w zamian

API jest otwarte, także do zastosowań komercyjnych. Zasady są krótkie i wynikają z tego, że po drugiej stronie każdego prześwietlenia stoi czyjś serwer.

Podaj źródło

Jeśli pokazujesz nasze wyniki dalej, napisz, skąd pochodzą, i zlinkuj do klyo.pl. Nie podawaj naszych pomiarów jako własnych.

Nie zbieraj masowo

API służy do sprawdzania stron, o które ktoś zapytał. Nie wolno przez nie budować bazy danych o cudzych stronach ani skanować internetu.

Nie omijaj limitów

Jeden klucz na jedno zastosowanie. Rozdzielanie ruchu na wiele kluczy albo adresów, żeby ominąć limit, kończy się wycofaniem klucza.

Uszanuj cudzą odmowę

Gdy strona zabrania automatom wstępu, API zwraca odmowę i tak ma zostać. Nie próbuj tego obchodzić przez nasze API ani poza nim.

Więcej o tym, jak zachowuje się nasz robot i jak mu zabronić wstępu, jest na osobnej podstronie.

Prywatność

Co zapisujemy, a czego nie

Zapisujemy

wynik pomiaru: oceny, listę fraz, listę usterek, rozpoznany silnik
adres badanej strony i datę badania
nieodwracalny skrót adresu IP pytającego, do liczenia limitów

Nie zapisujemy

treści badanych stron — kod znika z pamięci zaraz po odczytaniu
danych osobowych z badanych stron; numer telefonu i adres e-mail sprawdzamy tylko pod kątem „czy jest”
adresu IP pytającego w postaci jawnej
niczego o osobach odwiedzających badaną stronę — nigdy się z nimi nie stykamy

Pełne zasady: polityka prywatności. Pytania o dane: kontakt@klyo.pl.

Pytania

To, o co pytają programiści

Ile kosztuje?

Odczyt zapisanego wyniku jest darmowy i bez limitu. Nowe prześwietlenie wymaga klucza i mieści się w limicie sześciuset na godzinę. Jeśli potrzebujesz więcej, napisz — ustalimy limit pod twój przypadek.

Skąd wziąć klucz?

Napisz do nas z jednym zdaniem, do czego go potrzebujesz. Klucz wystawiamy w panelu i ma uprawnienie „przeswietl”. Klucz jest tajny: trzymaj go po stronie serwera, nigdy w kodzie strony.

Dlaczego nowe prześwietlenie jest limitowane, a odczyt nie?

Bo każde nowe prześwietlenie puka do cudzego serwera. Ograniczenie nie leży po naszej stronie: sama analiza zajmuje czternaście tysięcznych sekundy. Odczyt zapisanego wyniku niczego nie pobiera, więc nie ma powodu go ograniczać.

Jak długo żyje wynik?

Pół roku. Ostatni wynik danego adresu zostaje na zawsze, żeby porównanie „co się zmieniło” miało do czego wracać. Ten sam adres sprawdzony ponownie w ciągu piętnastu minut wraca z pamięci i nie obciąża cudzego serwera.

Czy mogę zbudować na tym własne narzędzie?

Tak, także komercyjne. Prosimy o jedno: podaj przy wyniku, skąd pochodzi, i nie podawaj naszych pomiarów jako własnych. Nie wolno używać API do masowego zbierania danych o cudzych stronach — patrz zasady niżej.

Co z prywatnością?

Nie zapisujemy treści cudzych stron, tylko wynik pomiaru. Nie zbieramy danych osobowych z badanych stron. Twojego adresu IP nie przechowujemy w postaci jawnej — trafia do bazy jako nieodwracalny skrót.

Klucz

Potrzebujesz klucza do prześwietlania?

Napisz jednym zdaniem, do czego go użyjesz. Wystawiamy klucze bezpłatnie, także do projektów komercyjnych. Odpisujemy w jeden dzień roboczy.

Poproś o klucz Zobacz, co zwraca API, w przeglądarce