トラブルシューティング
アシスタントでのバックリンクチェックツール呼び出しの失敗:症状表
アシスタントはエラーをなだらかに処理します。このページでは、チャットで表示される内容、裏側で何が起こったか、そして修正方法を、最もコストがかかる症状から順にリストします。
SEO AI Pal リサーチチーム ·

症状、原因、修正方法
| チャットに表示される内容 | 裏側で何が起こったか | 修正方法 |
|---|---|---|
| 詳細なしで「データを取得できませんでした」と表示される | おそらくHTTP 401です。キーが欠落している、入力ミスがある、または末尾にスペースが含まれて貼り付けられています。 | キーを再貼り付けしてください。ターミナルで無料のoverviewアクションでテストします。 |
| 昨日は正常だったのに、今日は「サービス利用不可」 | おそらくHTTP 402です。ループや長時間のセッションにより残高が0になりました。 | アカウントページからUSDT(TRC-20)でチャージしてください。無料アクションは引き続き応答します。 |
| 実際のサイトに対して評価が0または行がない | インデックスにドメインがまだ含まれていないか、パスやhttps://付きで名前が送信されました。 | ドメインのみを送信してください。サイトが非常に新しい場合は、再来月再試行してください。 |
| 作成した新しいリンクが欠落している | インデックスは約1ヶ月に1回更新されます。 | 更新を待ちます。呼び出しを10回再実行しないでください。 |
| 他のベンダーのダッシュボードの数値と異なる | 異なるクローラーと異なるスコアリング方式です。当社のDRは独自の指標です。 | 単一の数値ではなく、トレンドを比較してください。 |
| 返信には予想より少ない行数しか含まれていない | スキーマでperが制限されていたか、アシスタントが1ページ目しか読み取った可能性があります。 | page=2を明示的に指定してください。 |
返信には数値が含まれているが_creditsがない | 呼び出しが行われませんでした。モデルはメモリから回答しました。 | プロンプトリファレンスブックのルールを適用してください。 |
| 予想より高額な請求 | アシスタントが有料アクションを再試行したか、リストに対してループ処理を行いました。 | 再試行を1回に制限し、bulk_drでバッチ処理してください。 |
ステータスコードが文章よりも重要な理由
アシスタントは402を丁寧な文章に変換します。あなたはコードではなく文章を読みます。生のステータスを問い合わせてください。それは最も安価な診断方法です。
障害を2つに分割してください。モデルを責める前に、同じURLをターミナルで実行してください。curlがok trueを含むJSONを返す場合、APIは正常であり、障害はラッパーまたはプロンプムにあります。curlも失敗する場合、キーまたは残高に問題があり、プロンプムの文章では修正できません。
90秒のトリアージ
- 失敗した呼び出しをcurlと無料アクションで実行します。
okが返ってきますか? - 有料アクションで実行します。401はキーを、402は残高を指します。
- アシスタントが送信したドメインを正確に出力します。
www.、パス、引用符を探してください。 - 前回の注文の日付を月次更新と比較してください。
- アシスタント製品の要約ではなく、ツール呼び出しログを読んでください。

スクリプトが途中で停止した場合
スクリプトは請求が静かに増加する場所です。以下の3つのケースは、停止、連鎖、または静かなエラーが計画以上の呼び出しにどのようにつながるかを示しています。
Ctrl-Cはバッチ処理を半分に止める可能性があります
多くのスクリプトはドメインのリストに対してループ処理を行い、アイテムごとに1回の有料呼び出しを行います。途中でCtrl-Cを押すと、すでに実行された呼び出しは請求され、残りは実行されません。出力ファイルにはどのドメインが完了したかを示すべきです。
結果が到着次第すぐにディスクに書き込んでください。そうすれば、再起動時にすでに完了したドメインをスキップでき、二度請求されることを防げます。
スクリプトの連鎖は呼び出し数を増殖させる
3つのスクリプトを実行し、その出力を1つのメールにマージするのは整然としているように見えます。各スクリプトが2回の有料呼び出しを行う場合、1回の実行で6回の請求が発生します。まずカウントし、スケジュールを組んでください。
データを一度収集し、その後フォーマットする単一のスクリプトは、請求とロジックを1か所に保ちます。スケジュールされたスクリプトは、最後に呼び出し数を出力すべきです。そうすれば、残高を確認する際に一致する数値が得られます。
再実行前にエラーボディを読んでください
失敗した呼び出しは通常、okがfalseに設定され、短いメッセージを含むボディを返します。まずメッセージを読んでください。同じキーと残高で再実行しても、同じ方法で失敗します。
ボディを飲み込み、失敗したという単語のみを出力するスクリプトは、得られた唯一の手がかりを無駄にします。ステータスとメッセージをそのまま引用してください。アシスタントによる要約は、すでに役立つ詳細を失っています。常に原文のまま。
ラッパー自体のミスと修正
同じ3つのミスがほとんどのラッパーで発生します。キーをURLに含めると、ログや共有されたトランスクリプトに表示されるため、製品が許可する場合はBearerヘッダーを使用してください。
すべてのアクションを公開するのは2つ目のミスです。あなたのGPTには4つのアクションのみが必要であり、余分なアクションは計画外のクレジット消費につながります。3つ目は、返信が10行であるのに5,000行を要求することです。
これらを一度修正すれば、上記の表の大部分が適用されなくなります。それらすべてを生き残った誤った数値は、神話ページでカバーされています。

失敗を表示する呼び出しログを設定する
ログはあなたが購入する最も安価な診断です。維持コストはゼロで、チャットに関する漠然とした苦情をカウントできるステータスコードのリストに変えます。2つの習慣だけで十分です。
呼び出しごとに1行、ステータス付き
タイムスタンプ、アクション、ドメイン、HTTPステータス、および_credits値を1行に書き込んでください。プレーンテキストで十分です。スプレッドシートは後で読み取ることができ、ステータスの列は単一のチャットの返信が隠すパターンを示します。
無料呼び出しと有料呼び出しを別々の列に保持し、有料エラーの増加が合計の中に隠れないようにしてください。再試行された呼び出しをマークし、元の呼び出しの横に再試行回数记录下来します。同じ時間内に繰り返される402は、悪い日ではなくループを指します。まずログを読んでください。最後にモデルを責めてください。
トーンではなくステータスでアラート
チャットウィンドウは冷静に読めるかもしれませんが、ログにはすべての行に402が表示されています。関心のあるステータスコードのルールを設定してください。退屈なままにしてください。401はキーを、402は残高を、その他はボディを読むことを意味します。
無料アクションは応答しているが有料アクションが失敗している場合は明確なシグナルです。残高が原因である可能性が高いです。チャージと再試行回数が優先されます。無料アクションはパス自体がまだ機能していることを示すため、コントロールとしても機能します。
失敗した呼び出しを5つのステップで再現
外側から内側に向かって作業します。各ステップで1つのレイヤーを除外するため、障害が1か所に収束します。
- 1
正確なURLをコピー
アシスタントまたはスクリプトが送信したリクエストを、ドメインとスペルを含むバイト単位でコピーします。隠れたスペースや余分な
https://が一般的な原因です。 - 2
無料のoverviewアクションを実行
キーを必要としない
overviewに同じドメインを送信します。これがoktrueで応答する場合、パスとドメインは正常であり、問題はキーまたは残高にあります。 - 3
キーを使用して有料アクションを実行
カスタムGPTセットアップが推奨するように、ヘッダーにキーを含めて有料呼び出しを繰り返します。401はキーを、402は残高を指します。
- 4
最初の行を比較
返された最初の行がターミナルで行った同じ呼び出しと一致することを確認します。不一致がある場合、ラッパーが何らかの変更を加えたことを意味します。
- 5
結果を書き留める
ステータス、アクション、ドメイン、および
_credits値を一緒に保持してください。次のログを読む人は、尋ねることなく何が起こったかがわかります。
実際の空の結果と壊れた結果の見分け方
チャットウィンドウでは似ているように見えるが、非常に異なる意味を持つ2種類の返信があります。まずそれらを区別してください。間違ったものを修正すると時間がかかり、場合によってはクレジットも消費します。
0行は回答である
ドメインはok trueと空のリストを返すことがあります。これはインデックスに関する発見です。呼び出しの障害ではありません。新しいサイト、スペルの不一致、または月次更新に到達していないリンクである可能性があります。
結果として扱ってください。1文で報告してください。空の結果を返したドメインの短いリストと、各呼び出しの日付を保持してください。同じドメインが1ヶ月間空のままの場合、次の疑わしいのはスペルであり、月次更新だけでは説明しきれない場合があります。
行数が少なすぎるのは設定の問題
場合によっては、スキーマが行数を制限しているか、スクリプトが1ページ目しか読み取っているため、返信が短くなることがあります。呼び出しは行数に関係なく1回請求されるため、リクエストでより大きなperを使用しても追加のクレジットはかかりません。まずスキーマの制限を確認してください。そこから始めてください。
アシスタントがさらにあることに気づくことを期待するのではなく、意図的に2ページ目を要求し、プロンプムでそれを明記してください。
クイックアンサー
- バックリンクチェックツールはランクトラッカーと同じですか?
- いいえ。リンクを読み取ります:参照ドメイン、アンカー、トップページ、および0〜100の評価。キーワードの順位と毎日のクローリングはAhrefsやSemrushの分野であり、それらの仕事にはより包括的な製品です。それぞれの得意な場所で使用してください。
- 1回の呼び出しで返せる行数は?
- 1回の呼び出しで最大1,000行、
pageとper(10〜5000)によるページネーション、および深層ページネーションは最大50,000行に制限されます。呼び出しは行数に関係なく1回請求されるため、より大きなperは追加コストがかかりません。 - なぜ私のDRはAhrefsと異なるのですか?
- 私たちの評価はround(100 log(ref_domains+1) / log(210^7))で、参照ドメインの対数スケールです。Ahrefs DRは独自のメソッドを持つ別の指標です。精神は似ていますが、数字は常に異なります。