---
title: "API prześwietlarki stron — dokumentacja dla programistów"
description: "Sprawdzaj strony przez HTTP: na czym stoją, jak widzi je Google, czy wpuszczają asystentów AI i co mają poprawić. Odpowiedź w JSON, odczyt bez limitu."
url: https://klyo.pl/api-przeswietlarki/
canonical: https://klyo.pl/api-przeswietlarki/
type: faq
language: pl
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-09-04
llms: https://klyo.pl/llms.txt
---

# API prześwietlarki stron

Ten sam silnik, który stoi za naszym darmowym narzędziem, dostępny przez dwa adresy. Wysyłasz adres strony, dostajesz raport: na czym stoi, jak widzi ją Google, na jakie frazy celuje, czy wpuszcza asystentów AI i co ma poprawić. Odpowiedź w formacie JSON.

## 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`
Skopiuj

[Gotowe przykłady na GitHubie](https://github.com/krastranseu-lang/klyo-website-analyzer)
curl · JavaScript · Python · PHP · Rust

Nie masz jeszcze żadnego klucza? [Prześwietl dowolną stronę](https://klyo.pl/sprawdz-strone-internetowa/?adres=klyo.pl) — klucz pojawi się w adresie wyniku.

## 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.

## 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ą.

## 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. |

## 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](https://github.com/krastranseu-lang/klyo-website-analyzer)

## 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](https://klyo.pl/robot/).

## 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](https://klyo.pl/polityka-prywatnosci/). Pytania o dane: [kontakt@klyo.pl](mailto:kontakt@klyo.pl).

## 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.

## 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](mailto:kontakt@klyo.pl?subject=Klucz%20do%20API%20prze%C5%9Bwietlarki)

[Zobacz, co zwraca API, w przeglądarce](https://klyo.pl/sprawdz-strone-internetowa/)

---

Źródło: https://klyo.pl/api-przeswietlarki/ · Wykonawca: klyo software house (Łódź, cała Polska) · Kontakt: kontakt@klyo.pl · Indeks dla modeli językowych: https://klyo.pl/llms.txt