Bez KYC — bez dowodu, bez selfie, bez dokumentów. Płatność kryptowalutą: BTC, USDT, USDC, ETH, SOL, LTC
Język: Polski
Uzyskaj klucz API

Zastosowanie · agenci AI · nazwa narzędzia read_url

Narzędzie web fetch dla agentów AI: czytaj strony jako czysty Markdown

Agent, który potrafi wyszukiwać, ale nie czytać, odpowiada na podstawie snippetów. Daj mu narzędzie, które zamienia dowolny publiczny URL w krótki, czysty Markdown, a będzie mógł przeczytać źródło, zacytować je i podać jako referencję, w ramach ustalonego przez Ciebie budżetu.

Ostatnia aktualizacja: · 5 min czytania

Szybka odpowiedź

Jaki jest najlepszy sposób, aby dać agentowi AI narzędzie web fetch?

Owiń API do czytania stron jako narzędzie, które przyjmuje URL i zwraca główną treść strony jako Markdown, przyciętą do ustalonej długości. WebReaderAPI wykonuje odczyt, renderuje JavaScript, gdy to potrzebne, respektuje robots.txt i pobiera jeden kredyt za stronę od 0,07 USD/1K stron według stanu na październik 2026. Gotowy kod narzędzia obejmuje MCP, OpenAI function calling, LangChain, n8n i OpenClaw. Bez KYC; płatność kryptowalutą.

WebReaderAPI jako narzędzie agenta

Narzędzieread_url(url, max_chars) wywołujący https://webreaderapi.com/api/v1/read
ZwracaMarkdown głównej treści oraz tytuł, autora, datę i liczbę słów
Limit długościmax_chars, od 1 000 do 500 000 znaków na stronę
Strony JavaScriptRenderowanie JavaScript w przeglądarce headless, gdy strona tego wymaga (render=auto), zawsze lub nigdy
OdmowyZwracane jako jasne błędy, nigdy nie obciążane opłatą
IntegracjeMCP, OpenAI, LangChain i LlamaIndex, n8n, OpenClaw
Cena3,75 USD za 10 000 stron; kredyty nigdy nie wygasają

Dlaczego agent potrzebuje readera zamiast surowego HTML?

Bo surowy HTML zajmuje okno kontekstu rzeczami, których model nie potrzebuje. Artykuł informacyjny albo strona dokumentacji przychodzi opakowana w nawigację, skrypty, bannery zgody i powiązane linki. Przekazana w niezmienionej formie, wypiera rozmowę i sprawia, że model cytuje menu.

Reader rozwiązuje trzy problemy naraz. Zachowuje tylko główną treść, renderuje strony, które są puste, dopóki nie wykona się JavaScript, i zamienia PDF-y na tekst. Agent dostaje jeden zwarty blok Markdown z tytułem i datą, które może zacytować.

Dlaczego wbudowane narzędzia do pobierania czasem zawodzą?

Głównie dlatego, że strony odmawiają ruchowi zautomatyzowanemu. Od 1 lipca 2025 Cloudflare domyślnie blokuje AI crawlers dla nowych domen, a od 15 września 2026 jego presety blokują ruch "Agent" na stronach z reklamami nowych domen. Wbudowane narzędzia w agentach kodujących i asystentach napotykają te odmowy jak każdy inny klient.

Inne awarie są techniczne. Dokumentacja OpenClaw, czytana 22 października 2026, mówi, że jego wbudowane web_fetch wyodrębnia treść za pomocą Readability, nie uruchamia JavaScript i ogranicza wynik do 20 000 znaków. Strony budowane w przeglądarce, długie dokumenty, wolne serwery i rate limit wywracają takie narzędzia. Reader, który renderuje strony, rozwiązuje przypadek z JavaScript; cache i cierpliwość rozwiązują resztę. Odmowy to decyzja właściciela strony. Nasz przewodnik po błędach 403 przy web fetch wyjaśnia każdy przypadek.

Dlaczego narzędzie nazywa się read_url, a nie web_fetch?

Aby uniknąć kolizji z narzędziami, które agenci już mają. Claude Code i OpenClaw mają wbudowane narzędzie o nazwie web_fetch. Drugie narzędzie o tej samej nazwie myli model co do tego, które wywołuje. Nazwanie naszego read_url sprawia, że oba pozostają dostępne: agent może używać wbudowanego fetchera do szybkich sprawdzeń i read_url, gdy potrzebuje czystego Markdown, PDF-ów albo stron z JavaScript.

Definicje narzędzi na naszych stronach dokumentacji używają tej nazwy, więc możesz przełączać się między frameworkami bez zmiany promptów.

Python: zwarte narzędzie read_url z limitem długości
import os

import requests

API = "https://webreaderapi.com/api/v1/read"
HEADERS = {"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]}


def read_url(url: str, max_chars: int = 12000) -> str:
    """Return a web page as Markdown for a model, or a short reason it was not read."""
    resp = requests.get(API, headers=HEADERS, params={"url": url, "max_chars": max_chars}, timeout=90)
    data = resp.json()
    if resp.status_code != 200:
        err = data.get("error", {})
        return "Not read (" + err.get("code", "error") + "): " + err.get("message", "")
    head = "# " + (data.get("title") or url) + "\nSource: " + data["final_url"]
    if data.get("published_at"):
        head += " | Published: " + data["published_at"]
    return head + "\n\n" + data["markdown"]


if __name__ == "__main__":
    print(read_url("https://example.com/blog/pour-over-coffee", max_chars=2000)[:500])

Jak agent powinien decydować, co czytać?

Daj mu budżet i regułę. Trzy nawyki trzymają koszty i kontekst w ryzach:

  • Czytaj mało, czytaj dobrze. Dwa do czterech źródeł na pytanie zwykle wystarczą, by odpowiedzieć z cytatami.
  • Ogranicz każdą stronę. Zacznij od max_chars około 10 000 do 15 000 znaków; zwiększaj tylko wtedy, gdy word_count pokazuje, że odpowiedź jest prawdopodobnie dalej.
  • Zgłaszaj odmowy. Gdy strona nie jest czytana, pozwól modelowi to powiedzieć i przejść do innego źródła zamiast ponawiać próby.

Powyższe narzędzie zwraca odmowy jako jedno zwykłe zdanie, więc model może je wyjaśnić użytkownikowi.

Ile kosztuje uruchomienie agenta na WebReaderAPI?

Jeden kredyt za stronę, dwa, gdy strona wymaga przeglądarki. Asystent, który odpowiada na 100 pytań dziennie i czyta po 4 strony do każdego, czyta około 12 000 stron miesięcznie. 50 000 stron (14,25 USD) pokrywają to na cztery miesiące, według stanu na październik 2026.

Kredyty nigdy nie wygasają, więc agent, który jest zajęty jednego tygodnia, a bezczynny następnego, nie marnuje miesięcznego limitu. Strony, które zawodzą albo których odmawia robots.txt, nie kosztują nic.

Który pack pasuje do agenta?

Prototypuj na 10 000 stron; przejdź na 50 000 stron lub 100 000 stron, gdy agent obsługuje prawdziwych użytkowników. Kredyty nigdy nie wygasają.

Test

10 000 stron

3,75 USD

0,38 USD/1K stron

  • Wypróbuj na swoich prawdziwych URL-ach
  • To samo API co w największym pakiecie
  • Kredyty nigdy nie wygasają
Wybierz 10 000 stron

Starter

50 000 stron

14,25 USD

0,28 USD/1K stron

  • Agent AI lub prototyp RAG
  • Crawluj stronę dokumentacji
  • Kredyty nigdy nie wygasają
Wybierz 50 000 stron

Build

100 000 stron

21,75 USD

0,22 USD/1K stron

  • Agenty produkcyjne i pipeline'y RAG
  • Zadania batch i crawling
  • Kredyty nigdy nie wygasają
Wybierz 100 000 stron

W każdym planie: Wyodrębnianie głównej treści · Renderowanie JavaScript, gdy potrzebne · Nieudane i odrzucone strony bez opłat · Kredyty nigdy nie wygasają

Agenci AI: najczęstsze pytania

Czy mogę dodać WebReaderAPI do Claude Desktop lub Cursor?

Tak, przez mały serwer MCP, który udostępnia read_url. Strona MCP zawiera kod i fragment konfiguracji; Twój klucz API pozostaje w zmiennej środowiskowej.

Czy działa z OpenClaw?

Tak, jako serwer MCP obok wbudowanego web_fetch w OpenClaw. Strona OpenClaw pokazuje polecenia z dokumentacji samego OpenClaw.

Czy agent może czytać strony, które blokują boty AI?

Nie. Jeśli robots.txt zabrania danej strony, API zwraca blocked_by_robots; jeśli strona odmawia, zwraca target_refused ze statusem strony. Żadne z nich nie jest naliczane, a my nigdy nie próbujemy obejść odmowy.

Jak powstrzymać długą stronę przed zapełnieniem okna kontekstu?

Ustaw max_chars. Markdown jest ucinany na tej długości, a word_count informuje agenta, jak długa była pełna strona, więc może poprosić o więcej tylko wtedy, gdy to potrzebne.

Czy potrzebuję karty lub dokumentu tożsamości?

Nie. WebReaderAPI nie wymaga żadnego dokumentu tożsamości, selfie, dokumentów ani karty. Płatność jest w BTC, USDT, USDC, ETH, SOL, LTC, z minimalnym doładowaniem 25 USD.

Źródła (3)
  1. Komunikat prasowy: crawlery AI blokowane domyślnie — Cloudflare (2025-07-01)
  2. Blog: nowe domyślne ustawienia dla crawlerów AI i agentów — Cloudflare (2026-09-15)
  3. Narzędzie do pobierania stron — OpenClaw (read 2026-10-22)

Od 0,07 USD/1K stron · bez KYC

Uzyskaj klucz API