跳过内容
SEO AI Pal
SEO AI Pal领取 $100 免费额度

故障排除

助手中的反向链接工具调用失败:症状表

助手往往会掩盖错误。本页面列出了您在聊天中看到的症状、底层发生的情况以及修复方法,从成本最高的症状开始。

SEO AI Pal 研究团队 ·

Clay 侦探检查四个代表不同链接检查故障的坏锁孔

症状、原因、修复

状态码是 API 返回的:401 表示密钥缺失或错误,402 表示积分耗尽。
聊天界面显示的内容底层发生的情况修复方法
“无法检索数据”,无详细信息可能是 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.、路径和引号。
  • 将上次订单的日期与月度刷新时间进行对比。
  • 阅读助手产品的工具调用日志,而不是其摘要。
Clay 道路中途停止,散落着碎石和纠缠的链条

当脚本中途停止时

脚本是账单悄然增长的地方。以下三种情况展示了停止、链式调用或静默错误如何导致超出预期的调用次数。

Ctrl-C 可能导致批处理未完成

许多脚本会遍历域名列表,并为每个项目发起一次付费调用。如果在中间按下 Ctrl-C,已运行的调用会被计费,而其余调用则不会发生。您的输出文件应标明哪些域名已完成。

收到结果后立即将其写入磁盘。这样重启时可以跳过已完成的域名,避免重复付费。

链式脚本会倍增调用次数

运行三个脚本并将它们的输出合并到一个电子邮件中看起来很整洁。假设每个脚本进行两次付费调用,单次运行将计费六次。先计数,再安排。

一个脚本一次性收集数据,然后进行格式化,可以将账单和逻辑集中在一个地方。定时脚本也应在结束时打印调用次数,以便下次查看余额时有一个数字可以核对。

在重新运行之前读取错误正文

失败的调用通常仍会返回正文,其中 ok 设置为 false 并附带简短消息。先阅读消息。使用相同的密钥和余额重新运行,会以相同的方式失败。

吞没正文并仅打印“失败”一词的脚本浪费了您拥有的唯一线索。引用原始的状态码和消息。助手的转述已经丢失了有助于解决问题的细节。始终使用逐字原文。

包装器本身的错误和修复

大多数包装器都会出现同样的三个错误。将密钥放在 URL 中意味着它会出现在日志和共享转录中,因此在您的产品允许的情况下使用 bearer header。

暴露所有操作是第二个问题。您的 GPT 只需要其中四个,每个额外的操作都是消耗您未计划使用的积分的另一种方式。第三个问题是在回复只需要十个时请求 5,000 行。

修复这些问题后,上面的大多数表格将不再适用。幸存的所有错误数字详见 误区页面。

Clay 天平在长凳上平衡羽毛和石头,旁边有一把放大镜

设置显示失败的调用日志

日志是您能买到的最廉价的诊断工具。它无需成本即可保留,并将关于聊天的模糊投诉转化为可计数的状态码列表。只需养成两个习惯。

每次调用一行,包含状态码

在一行中写入时间戳、操作、域名、HTTP 状态和 _credits 值。纯文本即可。电子表格以后可以读取它,状态码列可以显示单个聊天回复所隐藏的模式。

将免费调用和付费调用分列,以免付费错误增加被总数掩盖。标记任何重试的调用,并在原始调用旁边保留重试次数。同一小时内重复出现 402 错误指向循环,而非糟糕的一天。先阅读日志,最后归咎于模型。

根据状态码而非语气发出警报

聊天窗口可能看起来很平静,但日志显示每一行都是 402。为您关心的状态码设置规则。保持简单。401 意味着密钥,402 意味着余额,其他任何情况意味着阅读正文。

免费操作仍在响应而付费操作失败是一个明确的信号。余额可能是原因。充值和重试计数优先。免费操作也作为控制手段,因为它们显示路径本身仍然有效。

在五个步骤中重现失败的调用

由外向内工作。每一步排除一层,使故障最终集中在一个地方。

  1. 1

    复制确切的 URL

    复制助手或脚本发送的请求,逐字节,包括域名及其拼写。隐藏的空格和多余的 https:// 是常见的罪魁祸首。

  2. 2

    运行免费的 overview 操作

    将相同的域名发送到 overview,它不需要密钥。如果它以 ok 为 true 响应,则路径和域名没问题,问题出在密钥或余额上。

  3. 3

    使用密钥运行付费操作

    按照 自定义 GPT 设置 的建议,在 header 中包含密钥重复付费调用。401 指向密钥,402 指向余额。

  4. 4

    比较第一行

    检查返回的第一行是否与终端中进行的相同调用匹配。不匹配意味着包装器在传输过程中更改了某些内容。

  5. 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 方法。理念相似,但数字永远不同。