故障排除
助手中的反向链接工具调用失败:症状表
助手往往会掩盖错误。本页面列出了您在聊天中看到的症状、底层发生的情况以及修复方法,从成本最高的症状开始。
SEO AI Pal 研究团队 ·

症状、原因、修复
| 聊天界面显示的内容 | 底层发生的情况 | 修复方法 |
|---|---|---|
| “无法检索数据”,无详细信息 | 可能是 HTTP 401。密钥缺失、拼写错误或粘贴时带有尾随空格。 | 重新粘贴密钥。在终端中使用免费的 overview 操作进行测试。 |
| 昨天正常,今天显示“服务不可用” | 可能是 HTTP 402。循环或长时间会话导致余额归零。 | 从账户页面使用 USDT (TRC-20) 充值。免费操作仍会响应。 |
| 真实网站的评分为 0 或无数据行 | 索引可能尚未收录该域名,或者发送的域名包含了路径或 https://。 | 发送裸域名。如果网站是新站,请下个月重试。 |
| 新构建的链接缺失 | 索引大约每月刷新一次。 | 等待刷新。不要重复运行调用十次。 |
| 数字与其他供应商仪表板显示的不符 | 爬虫不同,评分标准也不同。我们的 DR 是独立的指标。 | 比较趋势,而非单个数值。 |
| 回复中的行数远少于预期 | 模式限制了 per 的值,或者助手只读取了第一页。 | 明确要求 page=2。 |
回复包含数字,但没有 _credits | 未发起调用。模型从记忆中作答。 | 应用 提示词运行手册 中的规则。 |
| 费用高于预期 | 助手重试了付费操作,或在列表中循环。 | 将重试次数限制为一次,并使用 bulk_dr 进行批量处理。 |
为什么状态码比句子更重要
助手会将 402 错误转化为礼貌的段落。您阅读的是段落,而不是代码。要求查看原始状态码。这是最廉价的诊断方式。
将故障分为两部分。在归咎于模型之前,先在终端中运行相同的 URL。如果 curl 返回包含 ok 为 true 的 JSON,则 API 正常,故障在于包装器或提示词。如果 curl 也失败,则是密钥或余额的问题,任何提示词措辞都无法解决。
90 秒的排查
- 使用 curl 和免费操作运行失败的调用。返回
ok了吗? - 使用付费操作运行。401 指向密钥,402 指向余额。
- 准确打印助手发送的域名。查找
www.、路径和引号。 - 将上次订单的日期与月度刷新时间进行对比。
- 阅读助手产品的工具调用日志,而不是其摘要。

当脚本中途停止时
脚本是账单悄然增长的地方。以下三种情况展示了停止、链式调用或静默错误如何导致超出预期的调用次数。
Ctrl-C 可能导致批处理未完成
许多脚本会遍历域名列表,并为每个项目发起一次付费调用。如果在中间按下 Ctrl-C,已运行的调用会被计费,而其余调用则不会发生。您的输出文件应标明哪些域名已完成。
收到结果后立即将其写入磁盘。这样重启时可以跳过已完成的域名,避免重复付费。
链式脚本会倍增调用次数
运行三个脚本并将它们的输出合并到一个电子邮件中看起来很整洁。假设每个脚本进行两次付费调用,单次运行将计费六次。先计数,再安排。
一个脚本一次性收集数据,然后进行格式化,可以将账单和逻辑集中在一个地方。定时脚本也应在结束时打印调用次数,以便下次查看余额时有一个数字可以核对。
在重新运行之前读取错误正文
失败的调用通常仍会返回正文,其中 ok 设置为 false 并附带简短消息。先阅读消息。使用相同的密钥和余额重新运行,会以相同的方式失败。
吞没正文并仅打印“失败”一词的脚本浪费了您拥有的唯一线索。引用原始的状态码和消息。助手的转述已经丢失了有助于解决问题的细节。始终使用逐字原文。
包装器本身的错误和修复
大多数包装器都会出现同样的三个错误。将密钥放在 URL 中意味着它会出现在日志和共享转录中,因此在您的产品允许的情况下使用 bearer header。
暴露所有操作是第二个问题。您的 GPT 只需要其中四个,每个额外的操作都是消耗您未计划使用的积分的另一种方式。第三个问题是在回复只需要十个时请求 5,000 行。
修复这些问题后,上面的大多数表格将不再适用。幸存的所有错误数字详见 误区页面。

设置显示失败的调用日志
日志是您能买到的最廉价的诊断工具。它无需成本即可保留,并将关于聊天的模糊投诉转化为可计数的状态码列表。只需养成两个习惯。
每次调用一行,包含状态码
在一行中写入时间戳、操作、域名、HTTP 状态和 _credits 值。纯文本即可。电子表格以后可以读取它,状态码列可以显示单个聊天回复所隐藏的模式。
将免费调用和付费调用分列,以免付费错误增加被总数掩盖。标记任何重试的调用,并在原始调用旁边保留重试次数。同一小时内重复出现 402 错误指向循环,而非糟糕的一天。先阅读日志,最后归咎于模型。
根据状态码而非语气发出警报
聊天窗口可能看起来很平静,但日志显示每一行都是 402。为您关心的状态码设置规则。保持简单。401 意味着密钥,402 意味着余额,其他任何情况意味着阅读正文。
免费操作仍在响应而付费操作失败是一个明确的信号。余额可能是原因。充值和重试计数优先。免费操作也作为控制手段,因为它们显示路径本身仍然有效。
在五个步骤中重现失败的调用
由外向内工作。每一步排除一层,使故障最终集中在一个地方。
- 1
复制确切的 URL
复制助手或脚本发送的请求,逐字节,包括域名及其拼写。隐藏的空格和多余的
https://是常见的罪魁祸首。 - 2
运行免费的 overview 操作
将相同的域名发送到
overview,它不需要密钥。如果它以ok为 true 响应,则路径和域名没问题,问题出在密钥或余额上。 - 3
使用密钥运行付费操作
按照 自定义 GPT 设置 的建议,在 header 中包含密钥重复付费调用。401 指向密钥,402 指向余额。
- 4
比较第一行
检查返回的第一行是否与终端中进行的相同调用匹配。不匹配意味着包装器在传输过程中更改了某些内容。
- 5
记录结果
将状态、操作、域名和
_credits值放在一起。下一个阅读日志的人无需询问即可知道发生了什么。
区分真实的空结果和损坏的结果
聊天窗口中两种回复看起来相似,但含义截然不同。首先要区分它们。更改错误的东西会花费时间,有时还会消耗积分。
零行是一个答案
域名可以返回 ok 为 true 且列表为空。这是关于索引的发现。不是调用的故障。可能是新站、拼写不匹配或链接尚未达到月度刷新。
将其视为结果。用一句话报告它。保留一个返回空值的域名短列表,以及每次调用的日期。如果同一域名持续为空一个月,则拼写是下一个嫌疑对象,而月度刷新只能解释一部分原因。
行数太少是一个设置问题
有时回复很短是因为模式限制了行数,或者脚本只读取了第一页。无论行数多少,调用只计费一次,因此请求中较大的 per 不会消耗额外积分。首先检查模式中的限制。从那里开始。
有目的地请求第二页,并在提示词中说明,而不是指望助手注意到还有更多内容。
快速解答
- 反向链接检查工具与排名跟踪器相同吗?
- 不。它读取链接:引用域名、锚文本、顶级页面和 0-100 评分。关键词位置和每日爬虫属于 Ahrefs 或 Semrush,它们是更完整的产品。在各自擅长的领域使用它们。
- 一次调用可以返回多少行?
- 每次调用最多 1,000 行,使用
page和per(10 到 5000)进行分页,深度分页上限为 50,000。无论行数多少,调用只计费一次,因此较大的per不会花费更多。 - 为什么我的 DR 与 Ahrefs 不同?
- 我们的评分是 round(100 log(ref_domains+1) / log(210^7)),是对引用域名的对数刻度。Ahrefs DR 是单独的指标,具有其 own 方法。理念相似,但数字永远不同。