用途:批量获取多个域名或 URL 的新增与丢失外部引用域(referring domain)数量总计,适合需要一次性对比大量目标外链变化的场景。
主要能力:调用 Frevana 的 POST /service/backlinks/bulk-new-lost-referring-domains 接口,校验响应为 JSON 后原样返回,不重写或重塑数据,除非用户明确要求转换。
必要输入:targets。支持的请求字段为 targets、date_from、tag,不要传入不支持的字段,也不要在请求体中放 API 密钥、输出路径或请求元数据。
使用方式:需要环境变量 FREVANA_TOKEN,或本次运行显式传入 --token;依赖 curl、bash、python3。优先使用随附脚本而非临时 curl 命令。示例:bash <skill-path>/scripts/get_backlinks_bulk_new_lost_referring_domains.sh --targets frevana.com,example.com --date-from 2026-06-01。可用 --output 指定保存路径,默认保存到 ./out/ 下带 UTC 时间戳和 pid 的文件。结构化值可用 --filters-json、--backlinks-filters-json、--custom-mode-json、--targets-json、--exclude-targets-json;--targets、--exclude-targets、--order-by 接受逗号分隔值;布尔选项接受 true、false、1、0、yes、no、on、off。
限制:非交互或智能体流程中若缺少 token 应快速失败并提示设置 FREVANA_TOKEN 或显式传 --token;不要向用户回显 Bearer token;失败时脚本打印响应体或解析错误并以非零状态退出。