SuperAPI AI 工具集

backlinks-domain-pages-summary

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于获取单一目标按页面聚合的外链(入站链接)指标,聚合到页面层级,而不需要拉取完整的页面列表。它调用 Frevana 的端点 POST /service/backlinks/domain-pages-summary 并原样返回 Backlinks API 响应。

主要能力:请求字段支持 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。脚本只发送该 API 支持的字段;不要传入不支持的字段,也不要将 API 密钥、输出路径或请求元数据放进 payload,Frevana 在服务端处理这些细节。

使用方式:必需输入为 target。命令示例:bash <skill-path>/scripts/get_backlinks_domain_pages_summary.sh --target frevana.com --limit 100。可用 --output 指定保存路径:bash <skill-path>/scripts/get_backlinks_domain_pages_summary.sh --target frevana.com --limit 100 --output ./out/backlinks-domain-pages-summary-result.json。需要环境变量 FREVANA_TOKEN,或当前运行显式传入 --token;脚本优先读取 FREVANA_TOKEN,交互式 shell 缺失时可能提示输入,非交互或智能体工作流中缺失应快速失败并提示用户设置 FREVANA_TOKEN 或显式传 --token。依赖 curl、bash、python3,优先使用捆绑脚本而非临时 curl 命令。结构化值使用 --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。

输出:成功时脚本校验响应体为 JSON 并打印到 stdout,默认保存到 ./out/backlinks-domain-pages-summary-<UTC 时间戳>-<pid>.json,指定 --output 时写入该路径。失败时打印响应体或解析错误并以非零码退出。脚本校验响应为 JSON 并原样返回,除非用户明确要求转换,否则不应重写或重塑返回数据;仅在用户要求总结时进行总结。不要在输出中回显 Bearer token。

限制:该技能针对单一目标;不获取完整页面列表。若缺少 token、curl、bash 或 python3,或传入不支持的字段,可能导致执行失败。