用途:调用 Frevana 的 /service/backlinks/referring-domains 接口,获取指向一个目标(target)的外链来源域名列表,包含每个域名的外链指标,支持过滤、排序和分页。
主要能力:必填输入为 target;请求字段支持 target、limit、offset、internal_list_limit、backlinks_status_type、filters、order_by、backlinks_filters、include_subdomains、include_indirect_links、exclude_internal_backlinks、rank_scale、tag。脚本只发送该接口支持的字段。响应为 JSON,技能会校验其为合法 JSON 并原样返回,不重写或重塑数据,除非用户明确要求转换。
使用方式:依赖环境变量中的 FREVANA_TOKEN(或本次运行用 --token 显式传入),以及 curl、bash、python3。优先使用随附脚本而非临时 curl 命令。示例:
bash <skill-path>/scripts/get_backlinks_referring_domains.sh --target frevana.com --limit 100
保存到指定文件:
bash <skill-path>/scripts/get_backlinks_referring_domains.sh --target frevana.com --limit 100
--output ./out/backlinks-referring-domains-result.json
脚本默认从 FREVANA_TOKEN 读取令牌;交互式 shell 中令牌缺失时可能提示输入,非交互或智能体流程中则快速失败,提示设置 FREVANA_TOKEN 或显式传入 --token。默认将 JSON 保存到 ./out/ 目录,文件名含 UTC 时间戳与进程号;使用 --output 时写入指定路径。成功时校验响应体为 JSON 并打印到 stdout;失败时打印响应体或解析错误并以非零状态退出。结构化值可用 --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。
限制:必须提供 target;不要传不受支持的字段,也不要在请求体里传 API 密钥、输出路径或请求元数据。不要向用户回显 Bearer 令牌。未提供时摘要仅在用户要求时生成。