← Wszystkie wpisy

FourA Digest: 13-20 listopada 2026

Tryb Auto uczy się teraz, kiedy kolejne próby nie przyniosą strony, i kończy te wywołania wcześniej. Do tego czytelny błąd 400 dla spacji w adresach URL oraz natychmiastowe unieważnianie sesji.

Najważniejsze zmiany

Wywołanie, które nie może pobrać strony, powinno szybko zwrócić informację o błędzie. Auto uczy się teraz dla każdej witryny z osobna, czy przeszukiwanie kolejnych węzłów wyjściowych ma szansę zwrócić stronę. Tam, gdzie niemal nigdy to nie pomaga, wywołanie kończy się już przy pierwszym pustym wyszukiwaniu. Single, Proxy Finder oraz Auto zwracają teraz także czytelny 400 dla adresów URL zawierających spację, unieważnienie sesji w Dashboardzie natychmiast wylogowuje dane urządzenie, a MCP 0.8.4 dba o to, by offload_large działał nadal po wyczyszczeniu folderu payload.

Nowości

Auto uczy się, kiedy dodatkowe węzły wyjściowe nic nie dadzą

W zeszłym tygodniu Auto zaczęło ograniczać się do trzech żądań przeglądarki na wywołanie w witrynach, w których kolejne próby prawie nigdy nie przynoszą rezultatu. Teraz mechanizm idzie o krok dalej. Jeśli szukanie węzła wyjściowego po tych trzech próbach przeglądarkowych również ostatnio nie dawało efektów w danej witrynie, wywołanie kończy się przy pierwszym pustym wyniku wyszukiwania. Taka reguła obowiązuje przez kolejne 24 godziny, po czym Auto sprawdza sytuację ponownie.

Odpowiedź precyzuje, co się stało: error zaczyna się od the browser has not got through to this site, a status zawiera ostatnią odpowiedź witryny. Dzięki temu znasz powód zakończenia wywołania, zanim podejmiesz decyzję o ponowieniu próby.

Blokada jest ustawiana per witryna, a nie per klucz API. Ponieważ dotyczy wszystkich odpytujących dany serwis, Auto ocenia sytuację na podstawie odpowiedzi samej witryny, a nie Twojej reguły validate (Twoja restrykcyjna reguła nie może jej aktywować). Ponadto wywołanie z parametrem exitClass: "premium" nadal otrzymuje swoje węzły wyjściowe premium.

Zadaniem Auto jest znalezienie trasy. Gdy przekaże Ci działającą sesję dla danej witryny, odtwarzaj tę sesję w Single lub Browser przy ruchu masowym. Smart Fetch (Auto) pokazuje sposób odtwarzania oraz wymienia wszystkie przypadki, w których wywołanie Auto może zakończyć się przedwcześnie.

Czytelny błąd 400 dla spacji wewnątrz adresu URL

Crawlery pobierają linki dokładnie w takiej postaci, w jakiej zapisano je na stronie, a strony miewają nietypową zawartość: javascript: void(0), link do udostępniania z całym zdaniem w środku. Jeśli wyślesz do Single, Proxy Finder lub Auto adres URL ze spacją lub znakiem sterującym, otrzymasz teraz 400, zanim żądanie w ogóle opuści FourA:

invalid URL: it contains a space; encode it as %20 (the URL as sent: "...")

Nic nie jest pobierane, żadne kredyty nie są zużywane, a wynik to client_error (zobacz Request Outcomes). Browser jest wyjątkiem: sam koduje spację i pobiera stronę.

Poprawka po Twojej stronie wymaga kilku linii. Rozwiąż każdy link względem strony, z której pochodzi, pomiń te, które nie są stronami, a resztę zakoduj:

from urllib.parse import urljoin, quote
import requests

SKIP = ("javascript:", "mailto:", "tel:")

def to_fetch(page_url, href):
    href = href.strip()
    if href.lower().startswith(SKIP):
        return None
    # %20 for a space; an already-encoded link stays as it is
    return quote(urljoin(page_url, href), safe=":/?#[]@!$&'()*+,;=%")

url = to_fetch("https://example.com/shop/", "/items/blue shoes?size=42")
# -> https://example.com/items/blue%20shoes?size=42

r = requests.post(
    "https://api.foura.ai/api/single",
    headers={"X-API-Key": "pk_live_..."},
    json={"url": url},
).json()

Typowe problemy zestawia objawy bezpośrednio z rozwiązaniem.

Unieważnienie sesji natychmiast wylogowuje urządzenie

W Ustawieniach znajduje się zakładka Sesje, która wyświetla wszystkie sesje na Twoich urządzeniach. Wybierz tam sesje, kliknij Unieważnij wybrane, a te urządzenia zostaną natychmiast wylogowane z Dashboardu, tak samo jak w przypadku opcji Wyloguj pozostałe. Unieważnione urządzenie musi zalogować się ponownie, zanim uzyska dostęp do Twojego Dashboardu.

To funkcja przydatna, gdy zostawisz zalogowanego laptopa w biurze klienta. Jedno urządzenie zostaje odłączone, a wszystkie pozostałe sesje działają bez zmian.

MCP 0.8.4 sprawia, że offload_large nadal zwraca swój link

Przy offload_large: true serwer MCP zapisuje response o rozmiarze 50 KB lub większym na dysku i przekazuje do Twojego klienta resource_link zamiast body. W przypadku własnej instancji dokumentacja zaleca usuwanie plików starszych niż godzina z katalogu payload. W wersji 0.8.4 offload_large nadal zwraca swój link po takim czyszczeniu (lub po opróżnieniu folderu temp przez system), ponieważ serwer tworzy ten folder ponownie przed każdym zapisem. Payload, którego pliki zostały usunięte, zwraca Payload not found.

Wydanie aktualizuje także zablokowane zależności, usuwając opublikowane alerty bezpieczeństwa, a npm audit nie zgłasza żadnych znanych podatności. Narzędzia, ich schematy oraz wysyłane requesty pozostają bez zmian. Zaktualizuj @fouradata/mcp lub skieruj klienta na hostowany serwer, który działa już w wersji 0.8.4. Konfiguracja oraz wszystkie opcje znajdują się w dokumentacji serwera MCP.

Najtańsze nieudane wywołanie to takie, które kończy się w kilka sekund i wskazuje dokładnie, którą linię należy poprawić.