参考
工具列表评分字段详解
设计一次列表表格，每月的更新工作便自动完成。以下是目录可以存储的每个链接评分列，以及用于填充它们的数据调用。
SEO Tools AI 研究团队 ·
各列概览
| 列名 | 数据来源 | 积分 | 刷新频率 |
|---|---|---|---|
| dr | bulk_dr，最多 2,000 个域名 | 1 | 每月 |
| dr_checked_on | 您的自定义任务，在获取数据的当天 | 0 | 每次运行 |
| ref_domains | refdomains，按您的选择排序 | 2 | 每月，仅限顶级列表 |
| top_anchors | anchors | 2 | 每季度 |
| top_pages | toppages | 2 | 每季度 |
| overview_blob | overview（免费，无需密钥） | 0 | 按需 |
| rival_overlap | intersect，2 到 10 个域名 | 2 | 添加工具时 |
值得保留的列
从两列开始。dr 作为排序键，dr_checked_on 作为真实性列。
没有日期的评分看起来像事实，但一个月后就成了传闻。日期可以防止这种情况，并且当任务因崩溃重启后，它还能让您跳过那些一小时前已刷新过的行。
将其他所有内容视为可选。展示指向域名与评分对比的对比网站，能为读者提供第二个用于交叉验证的数字，这比更漂亮的徽章更有用。我们的反向链接分析工具页面展示了与其他检查器的对比效果。
目录提供链接的列
评分描述的是工具。目录还会提供链接，这些链接也值得拥有独立的列。要求反向链接的目录很常见，所以这个问题会比您预期的更早出现。
从一个记录反向链接的是/否字段开始。在编写之前，请先自行检查列出的网站，因为记忆中的答案往往是包含几百行数据的列表中最先出错的地方。
互惠链接列
添加 reciprocal_link 作为是/否列，用于指示列出的工具网站是否链接回您的网站。假设您维护 300 个工具，其中 40 个要求互惠链接。该列可以告诉您哪些列表依赖于人情，并且在读者提问之前就能显示出来。
将该列排除在评分排序之外。它描述的是关系而非工具本身，因此将其混入排名会使后续解释顺序变得更加困难。
您发布的链接状态列
记录 outbound_status，包括您发布的每个链接的 HTTP 状态以及您上次检查的日期。返回 404 错误的列表是对读者的失信，而其他人不会为您注意到这一点。
检查可以与评分刷新的每月任务一起进行。您只需添加一列，无需新的计划，这是目录可以购买的最便宜的维护方式。
记录您获得的承诺
当目录要求互惠链接时，在 link_note 列中记录日期、页面以及请求的确切措辞。一条简单的备注只需一分钟即可写出，但能避免六个月后的争论。
不要承诺您无法兑现的排名。如果互惠链接从未添加，诚实的做法是标记该行并保持评分不变。
将付费排名分开
如果某个列表是通过付费获得的，请在评分旁边存储 placement 值，并且不要让评分单独决定顺序。高 dr 不应成为付费列表排在更优列表之上的唯一原因。
在评分旁边显示付费标记，以便任何对页面进行排序的人都能看到两者。发现标签的读者，就是会继续信任列表其余部分的读者。
你实际会使用的请求参数
这些是 API 的参数，按同步作业所需的顺序排列。
action what to do: domain, overview, bulk_dr, refdomains, anchors ...
q one domain, for single-domain actions
domains comma list, for bulk_dr (GET) or send it as a POST body
key your sk_ key, or use the Authorization: Bearer header
page which page of rows
per rows per page, 10 to 5000, up to 1,000 rows per billed call
sort column to sort by
order asc or desc经得起时间考验的命名和类型
根据列的内容命名，而不是根据供应商命名。dr 用于我们的数据没问题，但如果你后续添加第二个指标，使用 dr_ours 和 da_moz 这样的命名方式可以避免后续迁移的麻烦。
将评分存储为 0 到 100 的整数，日期存储为 ISO 字符串（如 2026-10-01），计数存储为整数。存储 “1.2k” 这种文本的列会在第一次排序时成为陷阱。
保留一个 source 列，填入简短的值如 seotoolsai。它仅占用少量字节，但能回答未来每一位编辑都会问的问题。
每个响应都包含 ok。经过身份验证的响应还包含 _credits，显示该次调用的成本和你的剩余余额。请记录这两项。在将任何其他字段映射到列之前，先进行一次免费的 domain 调用，并自行阅读 JSON。
分五步设置表格
先命名列
在触碰 API 密钥之前先写出列名列表，并为每列指定其存储的内容。列名中不要包含供应商名称，这样后续添加指标时就不必重命名。
进行一次免费调用
对单个域名运行 overview。它不需要密钥，因此你可以读取 JSON 并将字段名与你的表格进行比对，然后再消耗任何积分。
添加评分及其日期
将 dr 存储为整数，将 dr_checked_on 存储为 ISO 日期。这两列是建立读者可信任评分的最小要求。
在二十行上进行测试
对二十个你已知情的列表项发送 bulk_dr。手动将三个结果与免费的 domain 操作结果进行比对，然后再运行完整列表。
为精选列表项添加详细列
获取引用域名和锚文本每次调用需消耗 2 个积分，因此仅为你详细展示的列表项获取这些数据。1 个积分的评分仍足以覆盖其他所有行。
工作示例：假设的列表项记录
这是一个虚构示例，并非真实列表项。想象一个名为 ToolShelf 的目录，其中包含一个虚构产品 example-seo.test 的列表项。
其记录包含 dr 41，dr_checked_on 2026-10-01 和 ref_domains 1,000。这符合公开公式，因为 log(1001) 除以 log(20,000,000) 再乘以 100 四舍五入后为 41。
一个月后，作业重新获取数据，发现引用域名变为 1,800，因此评分变为 45。只有 dr 和日期发生变化。评论文本、截图和编辑备注保持原样，因为评分不会触及它们。
哪些列表项值得评分，以及深度如何
并非每个列表项都需要相同的深度。拥有几百个工具的目录可以对每一行进行评分，但详细调用是一个单独的决策，具有单独的成本。
对每一行进行评分，包括你向读者隐藏的行。当有人在后台管理系统中进行筛选时，隐藏的列表项仍然需要数值，而空白单元格会被误认为是漏检而非有意为之。
同一域名上的两个列表项
两个列表项可以共享同一主机，例如同一网站上的工具和其免费试用页面。评分属于域名，因此两行都获得相同的 dr。
在第二行添加简短文本备注，如 shares domain。如果没有它，编辑看到两个相同的数字会认为其中一个是复制错误。
同一规则也适用于在单一站点下运营多个工具的公司。每个工具可能都需要自己的页面，但其评分仍然是其所在域名的评分，因此请在备注列中说明这一点。
将详细调用花费在读者关注的地方
类别的顶部是引用域名计数影响决策的地方。从这里开始进行 2 积分的调用，而长尾部分则仅保留 dr。
每年重新审视一次划分。列表项在页面上上下移动，三月时埋没的行现在可能值得进行详细调用。
保留一次原始响应
将每次刷新时的原始 JSON 保留在一个文本列或单独的文件中。当你更改页面显示内容时，可以从该副本重建，避免为相同的行重复付费。
当评分看起来不正确时，它还能为你提供一份可引用的记录。在手动更改任何评分之前，将存储的响应与当前响应进行比较。
在存储的响应旁边也记录 ok 值。由非 ok 响应构建的行应标记为需要重新运行，而不应被视为可信的评分。
按固定顺序运行刷新
随机顺序处理行的刷新难以审计。按页面显示的顺序处理行，并将运行中的第一个和最后一个域名写入日志。
如果作业中途停止，日志会告诉你从哪里恢复。已带有本月日期的行可以跳过，且不会重复付费。
字段问题
我应该为每个列表项存储原始 JSON 吗？
是的，每次刷新存储一次。将其保存在单个文本或 JSON 列中，然后从中派生出 dr 和其他显示字段。当你更改显示内容时，可以重建页面而无需再次调用 API 并重复付费。
如果域名不在索引中会发生什么？
不要猜测评分。将 dr 单元格留空，该列表项不显示徽章。我们的索引包含 181,132,097 个域名，虽然数量庞大但并非整个互联网，留空比零更诚实。
公共页面需要显示所有这些字段吗？
不需要。显示评分及其日期，以及精选列表项的引用域名。其余字段保留在后台管理系统中，用于排序、审计以及发现那些数值在月份间发生跳变的列表项。
