设置指南
查找我的外链列表并设置月度监控
十分钟的设置即可让你获得谁链接到你的带日期记录。当出现问题时,你可以对比两个文件,而不是盲目猜测。
六步完成设置
创建 API 密钥
密钥以 sk_ 开头。请将其保留在公共仓库之外;将其视为密码对待。
尝试免费查询
action=overview&q=yourdomain.com 免费,可验证你的密钥和域名拼写。
获取真实列表
运行 refdomains、anchors 和 toppages,每次调用返回 1,000 行,每次调用消耗 2 个信用点。
按日期保存
将文件命名为 refdomains-2026-10.json。切勿覆盖上月的文件。
差异对比
将行与上月的数据进行对比。新增的域名是你需要关注的重点。
一次调用,解释所有字段
替换域名和密钥。相同的模式适用于所有操作。
curl "https://darkseo.net/api.php?action=refdomains&q=yourdomain.com&per=1000&page=1&key=sk_live_..." \
-o refdomains-2026-10.json参数参考
| 参数 | 含义 | 备注 |
|---|---|---|
| action | 要运行的报告类型 | refdomains、backlinks、anchors、toppages 及其他 |
| q | 你要调查的域名 | 裸域名,无协议头 |
| key | 你的 API 密钥 | 或者发送 Authorization: Bearer sk_... |
| page | 页码 | 深度分页上限为 50,000 行 |
| per | 每页行数 | 从 10 到 5000;每次调用计费一次 |
| sort, order | 排序列及升序或降序 | 有助于优先查看最新或最大的数据 |
文件命名、存储与对比
只有文件可以无需人工辅助进行对比时,“查找我的外链列表”才有意义。清晰的命名规则和每月一个文件夹能完成大部分工作。现在花十分钟制定规则,因为稍后花一小时整理会更糟糕。然后,永远不要重命名它们。
对每个域名和每次调用使用相同的模式,以便按月份对文件进行排序。混合模式会破坏排序,而排序错误正是上月文件被覆盖的原因。
可排序的文件名
将年份和月份放在最前面,然后是域名,最后是调用名称,例如 2026-10 后接域名和 refdomains。月份补零可确保正确排序,且按此顺序命名的文件名读起来像日志。
避免在文件名中使用空格和重音字符。脚本处理它们效果不佳,且复制失败可能看起来像成功。
每月一个文件夹
为每个月创建一个文件夹,并将每个域名的三个文件复制进去。每月一个文件夹可确保上月文件不受影响,从而使差异对比变为两个文件夹之间的比较。
如果系统允许,请在月份关闭后将文件夹设置为只读。无法编辑的已保存文件是更可靠的记录。
简短的变更日志
在根文件夹中保留纯文本日志。每次拉取写一行,包含日期、域名和执行的调用。变更日志让你能在几年后解释系列数据中的空白,当时可能已无人记得原因。
将每次响应的信用点成本添加到同一行,使日志同时充当账单。
在日志中记录域名列表的每次更改及原因。某月新增的域名解释了该月的激增,并节省后续长时间搜索的时间。保持行格式简单,以便脚本在需要自动生成摘要时读取日志。
错误与修复
| 错误 | 症状 | 修复 |
|---|---|---|
| 密钥缺失或错误 | HTTP 401 | 检查密钥和标头拼写 |
| 余额为空 | HTTP 402 | 从账户页面使用 USDT (TRC-20) 充值 |
忽略读取 ok | 空文件被误认为成功 | 在保存之前,在脚本中测试 ok 标志 |
| 覆盖上月数据 | 无法进行差异对比 | 在文件名中包含月份 |
| 期望获取实时数据 | 新链接缺失 | 索引大约每月刷新一次;按月对比,而非按天 |
自动化设置
每月第一天的 cron 条目即可。将三个 curl 调用写入一个 shell 脚本,在每个文件名中添加月份,并仅当新增域名数量超过阈值时发送邮件通知。
经过身份验证的响应包含 _credits,其中包含成本和剩余余额,因此脚本可以在余额不足时警告你。手动测试一次。然后忘记它,直到收到邮件。
对于团队,将月度拉取与 示例阈值 配对,以便每个人阅读相同的规则。
保持脚本简单。使用 plain curl,遍历域名列表,每月一个文件夹。简单的脚本能经受住人员变动的考验。
处理运行失败
运行失败应保留上月文件不变,并在变更日志中写一行。常见的陷阱是部分下载:一个存在但包含错误主体的文件乍一看像数据。在移动之前检查大小和 ok 标志。没有任何文件未经检查就进入月度文件夹。
如果连续两次运行失败,首先检查密钥和域名拼写。免费概览调用可免费测试两者,因此那里的失败能告诉你问题是出在设置还是付费调用。
在预算内保持监控
一旦了解算术,监控就很便宜。每次付费调用只计费一次,无论行数多少,每次调用最多 1,000 行。将你进行的调用次数乘以其信用点成本,再乘以每个信用点 $0.0001,即得月度账单。先做这个计算。
以下是一个域名三次调用的算术计算。refdomains、anchors 和 toppages 每次消耗 2 个信用点,共六个信用点,即每月 $0.0006。
估算月度账单
为新人添加一个 bulk_dr 调用,消耗 1 个信用点,总额增加一个信用点。阈值页面上的表格计算了十个站点的案例,因此你可以看到数字如何随列表增长。
将估算值与拉取记录保存在同一日志中。如果账单持续上升,而估算值已提前记录,则更容易解释。
在余额耗尽前停止
经过身份验证的响应包含成本和剩余余额。在脚本中读取它们,将余额与下月的估算值进行比较,并在余额紧张时警告自己。如果响应中 ok 设置为 false,应在保存任何文件之前停止运行。
HTTP 402 意味着余额已耗尽。从账户页面使用 USDT (TRC-20) 充值,然后重新运行该月的调用,而不是跳过该月。
月度循环
这是一个草图,不是产品。它每月为每个域名保存三个报告。调整域名列表和密钥。
#!/bin/bash
M=$(date +%Y-%m)
for D in yourdomain.com second-site.org; do
for A in refdomains anchors toppages; do
curl -s "https://darkseo.net/api.php?action=$A&q=$D&per=1000&key=$DARKSEO_KEY" -o "$D-$A-$M.json"
done
done如何处理文件
并排打开上月和本月的 refdomains 文件,列出仅在新文件中出现的域名。该列表即为本月的阅读内容。
将列表通过 bulk_dr 发送以获取快速质量评分,检查 anchors 文件中是否有任何短语增长,并阅读 top pages 以查看你不认识的 URL。如果一切正常,在日志中写一行并关闭标签页。
如果出现问题,打开 运行手册 和 拒绝链接决策表。月度拉取成本不到一分钱,因此真正的成本是你的注意力。
撰写月度笔记
在每月末写简短笔记。列出域名、新增域名数量、最大 anchor 占比及决策。四行即可。当天写的笔记比稍后写的长笔记更有价值。
将笔记保存在文件旁边,而不是文件内部。未来的读者应能在一个地方找到决策及其依据的数字。这位读者可能是你,一年后,对那个月毫无记忆。
关于月度监控的问题
我需要付费计划才能运行此功能吗?
没有订阅费,也没有月度最低消费,因为服务是预付费信用点。新账户获得 $100 免费信用点,无需绑定银行卡。免费查询不收费,因此你可以在拉取任何付费列表之前测试设置。
为什么不每天运行脚本?
索引大约每月刷新一次,因此每日任务会反复下载相同的内容。每日运行也会为无新信息的数据消耗信用点。月度是该数据的合理节奏。
如果新文件大得多,我该怎么办?
将行数与基线进行比较,然后在差异对比中查看新人。较大的文件可能来自真实激增或行限制更改。首先排除第二种原因,因为它是更便宜的检查。
一个脚本可以监控多个域名吗?
可以。上述月度循环处理域名列表,每个域名都有自己独立的文件。保持列表足够短,以便每个域名每月都能得到真实阅读,因为无人阅读的监控仅是存储成本。
索引大约每月刷新一次,因此每日 cron 任务只会下载相同的内容。此外,外链列表不是判决:在行动之前,将每个标志与 Search Console 链接报告配对。