用途
seo-weekly-report 是 Open Analytics 的完整 SEO 周报生成技能，用于从 GSC、GA4 及可选的 Bing Webmaster Tools 取数，产出以证据为依据的 Markdown 周报。核心原则是每个数字都能回溯到当期平台数据、导出文件或数据包（bundle）。
取数方式
技能优先使用当前环境中已授权的数据入口，来源可混用：
- GA4：Analytics MCP 读取
- GSC 与 Bing Webmaster Tools：通过内置浏览器登录态操作
- API 脚本：在 scripts/ 目录执行 npm run fetch-gsc、fetch-ga4、fetch-bing、merge、fetch-all，产出 data/seo-report-bundle-{YYYY-MM-DD}.json；可用环境变量 REPORT_WEEK_END=YYYY-MM-DD（周日）固定报告周
- 平台导出：直接读取 XLSX/CSV 等导出证据
MCP 与浏览器模式不要求客户目录存在 .env；只有选择 API 采集器时才需配置 OPEN_ANALYTICS_PROJECT_ROOT。
主要能力
- 按 D0–D5 对每个来源做健康检查：来源类型标注、周期对齐、维度完整性、GA4/Bing 可用性、页面对齐率、点击量区间核对
- GSC 品牌词与非品牌词拆分（依赖 config/brand-query-registry.yaml 规则）
- GA4 渠道、落地页、Key events、aiAssistant 分析
- Bing 第二搜索引擎与抓取问题
- 同来源、等长、对齐的周环比；无法严格对齐时分别呈现窗口与限制
- 页面/查询候选保留本期、上期与大幅变化行，对“未返回”数据谨慎处理
- 生成报告 §1 健康检查摘要与文首警示
使用方式
按 SKILL.md 执行，触发时需提供：项目根目录、报告周结束日（默认上周日）、取数方式组合、可选的项目执行记录与上周报告。输入还包括项目属性与页面范围（GSC、GA4、Bing 属性及生产 hostname）、可选的四个手动文本块（content、backlinks、observations、project status）。
报告输出路径为 reports/{project-id}-seo-weekly-{YYYY-MM-DD}.md。成稿按 references/portable/report-template.md 建立事实与证据链，并遵循渐进式加载：默认只读 SKILL.md，取数时读 evidence-intake.md，成稿时读 report-template.md。
适用场景
适用于需要定期输出 SEO 周报、已接入测量且能访问 GSC/GA4（可选 Bing）的项目，包括早期站点（0 点击时看趋势不看绝对值）、多来源混合取数、API 批量复跑等情形。
限制
- 不是实时看板；看板模块标为未接入，只读 bundle，不建 UI
- 不是 Google Ads / 社媒完整归因工具（extensions 中相关模块当前为 null/未接入）
- 不是 GTM/GA4 安装教程，站点需已接好测量
- 品牌词拆分依赖外部品牌词规则文件，缺失则不报告品牌份额
- GA4 权限不足（如未加 Property Viewer）或 GSC 属性不匹配时相应章节降级或跳过
- 数据新鲜度受平台处理延迟影响（GSC 延迟约 2–3 天）
- 客户配置、凭据与真实数据不写入公开仓库，data/ 与 reports/ 需脱敏或清空
故障排查要点
- GSC 403/404：核对服务账号 Full 权限与 GSC_SITE_URL 属性
- GA4 403：在 GA4 Admin 添加 Property Viewer
- Bing HTTP 401：重新生成 API Key 并确认站点验证
- d1_periodAligned=false：REPORT_WEEK_END 不是周日
- merge 找不到文件：检查是否已跑 fetch 且环境变量与文件名后缀一致
以上分类判断：该技能核心用途为 SEO 数据周报的生成与分析，归入数据分析类。