Fehlerbehebung
Fehlerhafte Backlink-Checks im Assistenten: Eine Symptomtabelle
Assistenten glätten Fehler ab. Diese Seite listet auf, was Sie im Chat sehen, was im Hintergrund passiert ist und wie Sie es beheben – beginnend mit den Symptomen, die am meisten kosten.
SEO AI Pal Research-Team ·

Symptom, Ursache, Lösung
| Was der Chat anzeigt | Was passiert ist | Lösung |
|---|---|---|
| "Daten konnten nicht abgerufen werden" ohne Details | Wahrscheinlich HTTP 401. Der Key fehlt, wurde falsch eingegeben oder mit einem Leerzeichen am Ende eingefügt. | Key erneut einfügen. Testen Sie mit der kostenlosen Aktion overview in einem Terminal. |
| Gestern noch funktioniert, heute "Service nicht verfügbar" | Wahrscheinlich HTTP 402. Das Guthaben ist nach einer Schleife oder einer langen Sitzung auf Null gesunken. | Aufladen mit USDT (TRC-20) über die Kontoseite. Kostenlose Aktionen funktionieren weiterhin. |
| Eine Bewertung von 0 oder keine Zeilen für eine echte Domain | Der Index enthält die Domain möglicherweise noch nicht, oder der Name wurde mit einem Pfad oder https:// gesendet. | Senden Sie die reine Domain. Wiederholen Sie den Versuch im nächsten Monat, wenn die Domain neu ist. |
| Der neu erstellte Link fehlt | Der Index wird etwa einmal im Monat aktualisiert. | Warten Sie auf die Aktualisierung. Führen Sie den Aufruf nicht zehnmal hintereinander aus. |
| Die Zahlen weichen vom Dashboard eines anderen Anbieters ab | Unterschiedliche Crawler und unterschiedliche Bewertungsmethoden. Unser DR ist eine eigene Metrik. | Vergleichen Sie Trends, nicht Einzelwerte. |
| Die Antwort enthält weit weniger Zeilen als erwartet | Das Schema hat per begrenzt, oder der Assistent hat nur Seite 1 gelesen. | Fordern Sie explizit page=2 an. |
Die Antwort enthält Zahlen, aber kein _credits | Es wurde kein Aufruf ausgeführt. Das Modell hat aus dem Gedächtnis geantwortet. | Wenden Sie die Regeln im Prompt-Handbuch an. |
| Höhere Gebühren als geplant | Der Assistent hat eine kostenpflichtige Aktion wiederholt oder über eine Liste iteriert. | Wiederholungen auf eine begrenzen und mit bulk_dr bündeln. |
Warum der Statuscode wichtiger ist als der Satz
Ein Assistent verwandelt ein 402 in einen höflichen Absatz. Sie lesen den Absatz, nicht den Code. Fordern Sie den rohen Status an. Das ist die günstigste Diagnose, die Sie haben.
Teilen Sie die Fehlerquelle in zwei Teile. Bevor Sie das Modell beschuldigen, führen Sie dieselbe URL in einem Terminal aus. Wenn curl JSON mit ok true zurückgibt, ist die API in Ordnung und das Problem liegt im Wrapper oder Prompt. Wenn curl ebenfalls fehlschlägt, sind Key oder Guthaben das Problem, und keine Wortwahl im Prompt wird das beheben.
Neunzig Sekunden Triage
- Führen Sie den fehlerhaften Aufruf mit curl und einer kostenlosen Aktion aus. Kommt
okzurück? - Führen Sie ihn mit einer kostenpflichtigen Aktion aus. Ein 401 deutet auf den Key hin, ein 402 auf das Guthaben.
- Geben Sie die Domain genau so aus, wie der Assistent sie gesendet hat. Achten Sie auf
www., Pfade und Anführungszeichen. - Vergleichen Sie das Datum Ihrer letzten Bestellung mit der monatlichen Aktualisierung.
- Lesen Sie das Tool-Aufruf-Protokoll Ihres Assistenten-Produkts, nicht die Zusammenfassung.

Wenn ein Skript in der Mitte abbricht
Skripte sind der Ort, an dem die Rechnung leise wächst. Die drei folgenden Fälle zeigen, wie ein Abbruch, eine Kette oder ein stiller Fehler zu mehr Aufrufen führt als geplant.
Ein Ctrl-C kann einen Batch halbfertig zurücklassen
Viele Skripte iterieren über eine Liste von Domains und führen pro Element einen kostenpflichtigen Aufruf aus. Drücken Sie in der Mitte Ctrl-C. Die bereits ausgeführten Aufrufe werden berechnet, der Rest findet nicht statt. Ihre Ausgabedatei sollte angeben, welche Domains abgeschlossen wurden.
Schreiben Sie jedes Ergebnis sofort auf die Festplatte. Dann kann ein Neustart die bereits abgeschlossenen Domains überspringen, anstatt doppelt für sie zu zahlen.
Verkettete Skripte multiplizieren die Aufrufe
Drei Skripte auszuführen und ihre Ausgabe in einer E-Mail zusammenzuführen, wirkt ordentlich. Wenn jedes der drei Skripte zwei kostenpflichtige Aufrufe macht, kostet eine einzelne Ausführung sechs. Zählen Sie zuerst, planen Sie dann.
Ein einzelnes Skript, das die Daten einmal sammelt und sie dann formatiert, hält die Rechnung und die Logik an einem Ort. Ein geplantes Skript sollte am Ende auch seine Aufrufanzahl ausgeben, damit der nächste Blick auf das Guthaben eine Zahl zum Abgleichen hat.
Lesen Sie den Fehlerbody, bevor Sie erneut ausführen
Ein fehlgeschlagener Aufruf gibt normalerweise immer noch einen Body mit ok false und einer kurzen Nachricht zurück. Lesen Sie die Nachricht zuerst. Ein erneuter Aufruf mit demselben Key und demselben Guthaben schlägt auf dieselbe Weise fehl.
Skripte, die den Body verschlucken und nur das Wort „failed“ ausgeben, verschwenden den einzigen Hinweis, den Sie hatten. Zitieren Sie den Status und die Nachricht so, wie sie kamen. Eine Paraphrase des Assistenten hat bereits die Details verloren, die geholfen hätten. Wörtlich, immer.
Fehler und Lösungen im Wrapper selbst
Die gleichen drei Fehler treten in den meisten Wrappern auf. Den Key in der URL zu platzieren bedeutet, dass er in Logs und freigegebenen Transkripten erscheint, also verwenden Sie den Bearer-Header, wo Ihr Produkt dies zulässt.
Jede Aktion freizugeben ist das zweite. Ihr GPT benötigt nur vier davon, und jede zusätzliche Aktion ist ein weiterer Weg, Guthaben auszugeben, das Sie nicht eingeplant haben. Das dritte ist die Anforderung von 5.000 Zeilen, wenn die Antwort zehn verwendet.
Beheben Sie sie einmal, und die meisten der obigen Tabelle gelten nicht mehr. Falsche Zahlen, die all dem widerstehen, werden auf der Mythos-Seite behandelt.

Ein Aufrufprotokoll einrichten, das Fehler anzeigt
Ein Protokoll ist die günstigste Diagnose, die Sie je kaufen werden. Es kostet nichts, es zu pflegen, und es verwandelt eine vage Beschwerde über den Chat in eine Liste von Statuscodes, die Sie zählen können. Zwei Gewohnheiten reichen.
Eine Zeile pro Aufruf, mit dem Status
Schreiben Sie Zeitstempel, Aktion, Domain, HTTP-Status und den _credits-Wert in eine Zeile. Einfacher Text reicht aus. Eine Tabelle kann später gelesen werden, und eine Spalte mit Statuscodes zeigt ein Muster, das eine einzelne Chat-Antwort verbirgt.
Halten Sie kostenlose und kostenpflichtige Aufrufe in separaten Spalten, damit ein Anstieg der kostenpflichtigen Fehler nicht in der Gesamtzahl verschwindet. Markieren Sie jeden Aufruf, der wiederholt wurde, und halten Sie die Wiederholungsanzahl neben dem Original. Wiederholte 402er in derselben Stunde deuten auf eine Schleife hin, nicht auf einen schlechten Tag. Lesen Sie zuerst das Protokoll. Beschuldigen Sie das Modell zuletzt.
Alarmieren Sie basierend auf dem Status, nicht auf dem Ton
Ein Chat-Fenster kann ruhig wirken, während das Protokoll in jeder Zeile ein 402 zeigt. Legen Sie eine Regel für die Statuscodes fest, die Sie interessieren. Halten Sie sie langweilig. Ein 401 bedeutet den Key, ein 402 das Guthaben, und alles andere bedeutet, den Body zu lesen.
Dass kostenlose Aktionen noch antworten, während kostenpflichtige fehlschlagen, ist ein klares Signal. Das Guthaben ist die wahrscheinliche Ursache. Aufladen und Wiederholungsanzahl kommen zuerst. Kostenlose Aktionen dienen auch als Kontrolle, da sie zeigen, dass der Pfad selbst noch funktioniert.
Einen fehlerhaften Aufruf in fünf Schritten reproduzieren
Arbeiten Sie von außen nach innen. Jeder Schritt schließt eine Schicht aus, sodass das Problem an einem Ort endet.
- 1
Kopieren Sie die exakte URL
Nehmen Sie die Anfrage, die Ihr Assistent oder Skript gesendet hat, Byte für Byte, einschließlich der Domain und ihrer Schreibweise. Versteckte Leerzeichen und ein fehlgeleitetes
https://sind häufige Schuldige. - 2
Führen Sie die kostenlose Overview-Aktion aus
Senden Sie dieselbe Domain an
overview, das keinen Key benötigt. Wenn das mitoktrue antwortet, sind Pfad und Domain in Ordnung, und das Problem liegt beim Key oder Guthaben. - 3
Führen Sie die kostenpflichtige Aktion mit dem Key aus
Wiederholen Sie den kostenpflichtigen Aufruf mit dem Key im Header, wie im Custom GPT Setup empfohlen. Ein 401 deutet auf den Key hin, ein 402 auf das Guthaben.
- 4
Vergleichen Sie die erste Zeile
Stellen Sie sicher, dass die erste zurückgegebene Zeile mit demselben Aufruf übereinstimmt, der in einem Terminal ausgeführt wurde. Eine Abweichung bedeutet, dass der Wrapper unterwegs etwas verändert hat.
- 5
Schreiben Sie das Ergebnis auf
Halten Sie Status, Aktion, Domain und den
_credits-Wert zusammen. Die nächste Person, die das Protokoll liest, weiß, was passiert ist, ohne zu fragen.
Ein echtes leeres Ergebnis von einem defekten unterscheiden
Zwei Arten von Antworten sehen in einem Chat-Fenster ähnlich aus und bedeuten sehr unterschiedliches. Trennen Sie sie zuerst. Das Falsche zu ändern kostet Zeit und manchmal Guthaben.
Null Zeilen ist eine Antwort
Eine Domain kann mit ok true und einer leeren Liste zurückkommen. Das ist ein Befund über den Index. Kein Fehler im Aufruf. Es kann eine neue Domain sein, eine Schreibweise-Abweichung oder ein Link, der noch nicht die monatliche Aktualisierung erreicht hat.
Behandeln Sie es als Ergebnis. Melden Sie es in einem Satz. Führen Sie eine kurze Liste von Domains, die leer zurückkamen, mit dem Datum jedes Aufrufs. Wenn dieselbe Domain einen Monat lang leer bleibt, ist die Schreibweise der nächste Verdächtige, und die monatliche Aktualisierung kann nur so viel erklären.
Zu wenige Zeilen sind eine Einstellung
Manchmal ist die Antwort kurz, weil das Schema die Zeilen begrenzt hat, oder weil das Skript nur Seite 1 gelesen hat. Ein Aufruf wird einmal berechnet, unabhängig von der Zeilenanzahl, also kostet ein größeres per in der Anfrage kein zusätzliches Guthaben. Prüfen Sie zuerst die Begrenzung in Ihrem Schema. Beginnen Sie dort.
Fordern Sie Seite zwei bewusst an und sagen Sie dies im Prompt, anstatt zu hoffen, dass der Assistent bemerkt, dass es mehr gibt.
Schnelle Antworten
- Ist ein Backlink-Check-Tool dasselbe wie ein Rank-Tracker?
- Nein. Es liest Links: Verweisdomains, Anker, Top-Seiten und eine Bewertung von 0-100. Keyword-Positionen und tägliche Crawler gehören zu Ahrefs oder Semrush, die umfassendere Produkte für diese Aufgabe sind. Nutzen Sie jedes dort, wo es stark ist.
- Wie viele Zeilen kann ein Aufruf zurückgeben?
- Bis zu 1.000 Zeilen pro Aufruf, mit
pageundper(10 bis 5000) zur Paginierung und tiefer Paginierung, begrenzt auf 50.000. Der Aufruf wird einmal berechnet, unabhängig von der Zeilenanzahl, also kostet ein größerespernicht mehr. - Warum unterscheidet sich mein DR von Ahrefs?
- Unsere Bewertung ist round(100 log(ref_domains+1) / log(210^7)), eine logarithmische Skala auf Verweisdomains. Ahrefs DR ist eine separate Metrik mit eigener Methode. Ähnlich im Geist, nie dieselbe Zahl.