Przejdź do treści
SEO AI Pal
SEO AI PalZarejestruj się

Rozwiązywanie problemów

Zawodzące wywołania narzędzia do sprawdzania backlinków w Twoim asyście: tabela symptomów

Asystenci zacierają błędy. Na tej stronie znajdziesz, co widzisz w czacie, co stało się pod spodem oraz jak to naprawić, zaczynając od symptomów, które kosztują najwięcej.

Zespół badawczy SEO AI Pal ·

Detektyw Clay badający cztery uszkodzone zamki reprezentujące różne awarie linków

Objaw, przyczyna, rozwiązanie

Statusy to te, które zwraca API: 401 przy brakującym lub błędnym kluczu, 402 gdy kończą się kredyty.
Co pokazuje czatCo się stałoRozwiązanie
"Nie udało się pobraać danych" bez szczegółówPrawdopodobnie HTTP 401. Klucz jest nieobecny, literówka lub wklejony ze spacją na końcu.Wklej ponownie klucz. Przetestuj za pomocą darmowej akcji overview w terminalu.
Działało wczoraj, „serwis niedostępny” dzisiajPrawdopodobnie HTTP 402. Saldo osiągnęło zero po pętli lub długiej sesji.Doładuj za pomocą USDT (TRC-20) ze strony konta. Akcje free nadal odpowiadają.
Ocena 0 lub brak wierszy dla prawdziwej stronyIndeks może jeszcze nie zawierać domeny lub nazwa została wysłana z ścieżką lub https://.Wyślij samą domenę. Spróbuj ponownie w następnym miesiącu, jeśli strona jest nowa.
Brak nowego zbudowanego linkuIndeks odświeża się około raz w miesiącu.Poczekaj na odświeżenie. Nie uruchamiaj wywołania dziesięć razy.
Liczby różnią się od panelu innego dostawcyRóżne crawle i różne metody wyceny. Nasz DR to własny metryk.Porównuj trendy, a nie pojedyncze wartości.
Odpowiedź zawiera znacznie mniej wierszy niż oczekiwanoSchemat ograniczył per lub asystent odczytał tylko pierwszą stronę.Poproś jawnie o page=2.
Odpowiedź zawiera liczby, ale brak _creditsNie wykonano wywołania. Model odpowiedział z pamięci.Zastosuj reguły z podręcznika promptów.
Obciążenia wyższe niż planowanoAsystent ponowił płatną akcję lub zapętlił listę.Ogranicz ponowienia do jednego i zrób batch z bulk_dr.

Dlaczego kod statusu jest ważniejszy niż zdanie

Asystent zamienia 402 w uprzejmy akapit. Czytasz akapit, a nie kod. Poproś o surowy status. To najtańsza diagnoza, jaką masz.

Podziel winę na dwie części. Zanim obwinisz model, uruchom ten sam URL w terminalu. Jeśli curl zwraca JSON z ok true, API jest w porządku, a wina leży w wrapperze lub prompcie. Jeśli curl też zawiedzie, problemem jest klucz lub saldo, a żadne słowo w prompcie tego nie naprawi.

Dziewięćdziesiąt sekund triażu

  • Uruchom zawiodłe wywołanie z curl i darmową akcją. Czy zwraca ok?
  • Uruchom ją z akcją płatną. 401 wskazuje na klucz, 402 na saldo.
  • Wydrukuj domenę dokładnie tak, jak wysłał ją asystent. Szukaj www., ścieżek i cudzysłowów.
  • Sprawdź datę ostatniego zamówienia względem miesięcznego odświeżania.
  • Przeczytaj dziennik wywołań narzędzia swojego produktu asystenta, a nie jego podsumowanie.
Droga Clay zatrzymująca się w połowie z rozsypanym żwirem i splątanym łańcuchem

Gdy skrypt zatrzymuje się w połowie

Skrypty to miejsce, gdzie rachunek rośnie cicho. Poniższe trzy przypadki pokazują, jak stop, łańcuch lub cichy błąd zamieniają się w więcej wywołań niż planowano.

Ctrl-C może zostawić batch w połowie

Wiele skryptów pętluje po liście domen i wykonuje jedno płatne wywołanie na element. Naciśnij Ctrl-C w środku. Wywołania, które już się wykonały, są rozliczone, a reszta nigdy nie nastąpi. Twój plik wyjściowy powinien wskazywać, które domeny się zakończyły.

Zapisuj każdy wynik na dysku natychmiast po jego otrzymaniu. Następnie restart może pominąć domeny, które już zostały wykonane, zamiast płacić za nie dwukrotnie.

Łańcuchowanie skryptów mnoży wywołania

Uruchomienie trzech skryptów i scalenie ich outputu w jeden e-mail brzmi schludnie. Załóżmy, że każdy z trzech skryptów wykonuje dwa płatne wywołania, a pojedyncze uruchomienie rozlicza sześć. Policz najpierw, potem zaplanuj.

Pojedynczy skrypt, który zbiera dane raz, a następnie formatuje, trzyma rachunek i logikę w jednym miejscu. Zaplanowany skrypt powinien również drukować liczbę wywołań na końcu, aby następna kontrola salda miała liczbę do porównania.

Przeczytaj ciało błędu przed ponownym uruchomieniem

Zawiodłe wywołanie zwykle nadal zwraca ciało z ok ustawionym na false i krótką wiadomością. Przeczytaj wiadomość najpierw. Ponowne uruchomienie z tym samym kluczem i saldem zawiedzie w ten sam sposób.

Skrypty, które pochłaniają ciało i drukują tylko słowo „nieudane”, marnują jedną wskazówkę, jaką miałeś. Cytuj status i wiadomość tak, jak przyszły. Parafraza przez asystenta już utraciła szczegół, który pomógłby. Dosłownie, zawsze.

Błędy i poprawki w samym wrapperze

Te same trzy błędy pojawiają się w większości wrapperów. Umieszczenie klucza w URL oznacza, że pojawia się w logach i wspólnych transkryptach, więc używaj nagłówka bearer tam, gdzie Twój produkt na to pozwala.

Eksponowanie każdej akcji to drugi błąd. Twój GPT potrzebuje tylko czterech z nich, a każde dodatkowe działanie to kolejna możliwość wydania kredytów, których nie planowałeś. Trzecim jest proszenie o 5000 wierszy, gdy odpowiedź używa dziesięciu.

Napraw je raz, a większość powyższej tabeli przestanie mieć zastosowanie. Błędne liczby, które przetrwają wszystko to, są omówione na stronie mitów.

Waga Clay równoważąca pióro i kamień z lupą na ławce

Skonfiguruj dziennik wywołań, który pokazuje błędy

Dziennik to najtańsza diagnoza, jaką kiedykolwiek kupisz. Kosztuje nic do utrzymania, a zamienia ogólną skargę na czacie w listę kodów statusu, które można policzyć. Wystarczą dwie nawyki.

Jedna linia na wywołanie, ze statusem

Zapisz znacznik czasu, akcję, domenę, status HTTP i wartość _credits w jednej linii. Zwykły tekst wystarczy. Arkusz kalkulacyjny może go odczytać później, a kolumna statusów pokazuje wzorzec, który ukrywa pojedyncza odpowiedź czatu.

Trzymaj wywołania free i płatne w osobnych kolumnach, aby wzrost płatnych błędów nie ukrywał się w sumie. Oznacz każde wywołanie, które zostało ponowione, i trzymaj liczbę ponowień obok oryginału. Powtarzające się 402 w tej samej godzinie wskazują na pętlę, a nie na zły dzień. Czytaj dziennik najpierw. Obwiniaj model na końcu.

Alert na status, nie na ton

Okno czatu może wyglądać spokojnie, podczas gdy dziennik pokazuje 402 w każdym wierszu. Ustaw regułę dla kodów statusu, które Cię interesują. Zachowaj nudny charakter. 401 oznacza klucz, 402 oznacza saldo, a cokolwiek innego oznacza przeczytaj ciało.

Darmowe akcje nadal odpowiadają, podczas gdy płatne zawodzą to wyraźny sygnał. Saldo jest prawdopodobną przyczyną. Doładuj i policz ponowienia jako pierwsze. Akcje free służą też jako kontrola, ponieważ pokazują, że sama ścieżka nadal działa.

Odtwórz zawiodłe wywołanie w pięciu krokach

Działaj od zewnątrz do wewnątrz. Każdy krok wyklucza jedną warstwę, więc wina ląduje w jednym miejscu.

  1. 1

    Skopiuj dokładny URL

    Weź żądanie, które wysłał Twój asystent lub skrypt, bajt po bicie, w tym domenę i jej pisownię. Ukryte spacje i przypadkowy https:// to częste winowajcy.

  2. 2

    Uruchom darmową akcję overview

    Wyślij tę samą domenę do overview, który nie wymaga klucza. Jeśli odpowie z ok true, ścieżka i domena są w porządku, a kłopot leży z kluczem lub saldem.

  3. 3

    Uruchom płatną akcję z kluczem

    Powtórz płatne wywołanie z kluczem w nagłówku, jak zaleca konfiguracja custom GPT. 401 wskazuje na klucz, a 402 na saldo.

  4. 4

    Porównaj pierwszy wiersz

    Sprawdź, czy zwrócony pierwszy wiersz pasuje do tego samego wywołania wykonanego w terminalu. Rozbieżność oznacza, że wrapper coś zmienił po drodze.

  5. 5

    Zapisz wynik

    Trzymaj status, akcję, domenę i wartość _credits razem. Osoba czytająca dziennik później będzie wiedziała, co się stało, bez pytania.

Rozróżnianie prawdziwego pustego wyniku od uszkodzonego

Dwa rodzaje odpowiedzi wyglądają podobnie w oknie czatu i oznaczają bardzo różne rzeczy. Rozróżnij je najpierw. Zmiana złej rzeczy kosztuje czas i czasem kredyty.

Zero wierszy to odpowiedź

Domena może zwrócić ok true i pustą listę. To jest wniosek dotyczący indeksu. Nie błąd w wywołaniu. Może to być nowa strona, niezgodność pisowni lub link, który nie dotarł jeszcze do miesięcznego odświeżenia.

Traktuj to jako wynik. Zgłoś go w jednym zdaniu. Trzymaj krótką listę domen, które zwróciły pusto, z datą każdego wywołania. Jeśli ta sama domena pozostaje pusta przez miesiąc, pisownia jest kolejnym podejrzanym, a miesięczne odświeżenie może wyjaśnić tylko tyle.

Za mało wierszy to ustawienie

Czasami odpowiedź jest krótka, ponieważ schemat ograniczył wiersze, lub ponieważ skrypt odczytał tylko pierwszą stronę. Wywołanie jest rozliczone raz niezależnie od liczby wierszy, więc większe per w żądaniu nie kosztuje dodatkowych kredytów. Sprawdź limit w swoim schemacie najpierw. Zacznij stamtąd.

Poproś o drugą stronę celowo i powiedz o tym w prompcie, zamiast liczyć, że asystent zauważy, że jest więcej.

Szybkie odpowiedzi

Czy narzędzie check backlink to to samo co rank tracker?
Nie. Czyta linki: domeny odsyłające, kotwice, najlepsze strony i ocenę 0-100. Pozycje słów kluczowych i codzienne crawle należą do Ahrefs lub Semrush, które są pełniejszymi produktami do tego zadania. Używaj każdego tam, gdzie jest silny.
Ile wierszy może zwrócić jedno wywołanie?
Do 1000 wierszy na wywołanie, z page i per (10 do 5000) dla paginacji, a głęboka paginacja ograniczona do 50 000. Wywołanie jest rozliczone raz niezależnie od liczby wierszy, więc większe per nie kosztuje więcej.
Dlaczego mój DR różni się od Ahrefs?
Nasza ocena to round(100 log(ref_domains+1) / log(210^7)), skala logarytmiczna na domenach odsyłających. DR Ahrefs to osobny metryk z własną metodą. Podobny w duchu, nigdy taka sama liczba.