用途：为任意公司及其竞争对手构建交互式竞争流量报告，集中展示三项指标——SimilarWeb 的月访问量、Ahrefs 的自然搜索流量与 Domain Rating（DR）。三者回答不同问题，不可互相替代或平均：月访问量代表全渠道总需求，自然流量代表搜索贡献，DR 代表外链权威与结构性位置。
主要能力：脚本抓取数据并生成独立 HTML 报告，logo 以内联 data URI 形式嵌入，无外部请求，可承受严格 CSP；报告可用 Artifact 工具发布。焦点域名在图表中为橙色并始终参与排名，竞品按排名取五级蓝色渐变。
用法：
export AHREFS_API_KEY=... # required export BRANDDEV_API_KEY=... # optional, for logos S=skills/competitor-traffic-report/scripts
node $S/fetch-traffic.js acme.com rival1.com,rival2.com,rival3.com --out /tmp/data.json node $S/build-report.js /tmp/data.json "AI presentation tools, ranked" --out /tmp/report.html
选择竞品集：建议在运行前扩充到 20–40 个真实同行；名单来源依次为客户自有对比页、相关 SERP 前 100、Ahrefs competitors_overview。排除通用巨头与非真正竞争对手；SimilarWeb 根域数据已含子域，只列根域，避免重复计数。
限制：SimilarWeb 按 IP 限流，约每窗口 15 次调用且封禁持续数小时，脚本按 15 秒节奏仍可能遗漏，需重跑补缺或分两段执行；X-Extension-Version 头必填，仅用浏览器 User-Agent 会返回 403。返回 0 表示低于检测下限而非无流量，模板会将其剔除。Ahrefs 自然流量使用 mode=subdomains，域名模式会漏掉 www 主机。免费 DR 端点不消耗 API 单元，自然流量历史则按每域名每月一行计费。发布 DR 数据须保留带链接的归属：Domain Rating by Ahrefs，不得转售数据或用于构建与 Ahrefs 竞争的产品。解读时关注三项指标间的差距，并注明数据分母与时间窗口；两来源均为模型估算，小站点最不可靠。