用途:批量获取多个域名或 URL 的引用域(referring domain)数量总计,适合需要一次性查询大量目标外链概况的场景。
主要能力:调用 Frevana 的 POST /service/backlinks/bulk-referring-domains 接口,校验响应为 JSON 后原样返回,不重写或重塑数据,除非用户明确要求转换。
必要输入:targets。支持的请求字段为 targets 和 tag,脚本只发送该接口支持的字段。
使用方式:需在环境变量中提供 FREVANA_TOKEN,或本次运行显式传入 --token;依赖 curl、bash、python3。优先使用随附脚本而非临时 curl 命令。示例:bash <skill-path>/scripts/get_backlinks_bulk_referring_domains.sh --targets frevana.com,example.com。可用 --output 指定保存路径,默认保存到 ./out/ 目录。结构化值可用 --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;不要传入不支持的字段,也不要在 payload 中传 API key、输出路径或请求元数据。失败时脚本打印响应体或解析错误并以非零状态退出。