seo-ops

name	seo-ops
description	yakuten (hrtyaku.com) 网站运营/SEO 作战入口。当用户要求：分析 GA/GSC 数据、看流量/排名/搜索词、 出 SEO 报告、推荐 SEO 文章选题、优化 CTR/meta/AEO、内容更新计划、"网站运营" 等任务时触发。 分析由 Claude 本人完成（不调 Gemini；scripts/seo/ai-analyze.mjs 仅为 CI 无人值守备用）。

seo-ops — 网站运营/SEO 作战手册

分工原则：数据用脚本拉（机械、可复现），分析和建议由 Claude 直接做（不转包给 Gemini）。 npm run seo:ai（Gemini 脚本）只用于 CI 无人值守场景，日常交互一律 Claude 亲自分析。

0. 数据源与凭证（已接通，直接用）

数据源	怎么读	凭证
GA4	MCP 工具 mcp__analytics-mcp__run_report 等，property_id=541902985	服务账号 [e-mail]（已是属性查看者）
GSC	npm run seo:gsc → docs/data/gsc-latest.csv（列: query,impressions,clicks,ctr,position,top_page）	本地 .gsc-credentials.json（gitignored）= [e-mail]
Trends	npm run seo:trends → docs/data/trends-latest.json（geo=CN，词表 trends-keywords.json）	无需
策略底稿	docs/seo-keyword-gap.md（人工 P0/P1/P2 + AUTO-SNAPSHOT 区块）	—
页面清单	public/llms.txt	—

GA4 API 陷阱：metrics/dimensions 传字符串数组（["screenPageViews","sessions"]），传 {name:...} 对象会 InputValidationError。 GA4 埋点 Measurement ID G-1E6C28RJFJ 写死在 src/components/overrides/Head.astro，生产自动激活。

GA4 常用配方（date_ranges 用 [{"start_date":"28daysAgo","end_date":"today"}]）：

要什么	dimensions	metrics	备注
热门页面	["pagePath"]	["screenPageViews","activeUsers","averageSessionDuration"]	order_bys desc screenPageViews，limit 30
国家分布	["country"]	["activeUsers","sessions"]	验证多语种投放是否到达目标市场
流量渠道	["sessionDefaultChannelGroup"]	["sessions","activeUsers"]	Organic Search 占比 = SEO 大盘健康度
语言版本对比	["pagePath"] + dimension_filter BEGINS_WITH /es/ 等	["screenPageViews","bounceRate"]	逐 locale 看
日趋势	["date"]	["activeUsers","screenPageViews"]	看改动前后拐点
实时在线	run_realtime_report + ["unifiedScreenName"]	["activeUsers"]	偶尔抽查

两侧数据的分工：GSC = 进站前（搜索词/排位/CTR），GA4 = 进站后（停留/跳出/路径）。 高曝光词的落地页要两侧对照——排位好+CTR 好但跳出高 = 内容不符预期，光改 meta 没用。

1. 标准分析流程

1. 刷新数据（GSC 数据滞后 2 天）。先查新鲜度，同日已拉过就跳过： ls -la docs/data/gsc-latest.csv（看 mtime 是否今天）→ 过期才跑 npm run seo:gsc && npm run seo:trends && npm run seo:refresh ⚠ 绝不随手跑 npm run seo:ai --dry-run——它会把当日 ai-seo-report-*.md 覆盖成占位符（2026-07-10 实际踩坑）。
2. 读数：gsc-latest.csv + seo-keyword-gap.md 的 AUTO-SNAPSHOT（已算好 top40 + striking distance）； 再按上表补 GA4 流量侧（至少：热门页面 + 国家 + 渠道），做两侧对照。
3. Claude 直接分析，按下面的「分析框架」产出。
4. 写报告：docs/data/ai-seo-report-YYYY-MM-DD.md + 覆盖 ai-seo-report-latest.md（均 gitignored，含真实搜索词不入库）。首行注释注明 Generated by Claude (seo-ops) + 数据来源与日期范围。

2. 分析框架（按优先级）

1. CTR 塌陷（最大机会）：position ≤10 且 CTR <1% 的高曝光词 → 逐页改 title/description/直答段。本站标杆 snippet：药娘用药指南(zh, CTR 19%)、プロギノンデポー 個人輸入(ja, 20%)。
2. Striking distance（rank 10–30，曝光 ≥20）：小改（h2/内链/描述）即可进前 10，AUTO-SNAPSHOT 已列好。
3. 意图-落地页错配：calculator/工具类词落在文章页 → 改落到工具页。
4. 内容缺口：有曝光但无对应页/覆盖弱的 query → 推荐新博客选题（走第 4 节规则）。
5. AEO：高意图问句词页面顶部加 40–60 字直接回答 + FAQ schema，抢 AI 概览/精选摘要。
6. 暂缓项要明说：排 40+ 的通用药名（竞争激烈、曝光小）标注"先不投入"，防止精力错配。

多语种纪律：站有 17 个 locale，query 天然分布在各语言。每条行动必须落到具体 locale 的具体页面 （/es/... 而非笼统的"孕酮页"）；改 meta 只改命中语言的页，勿顺手全语种铺开（i18n 同步另有流程）。

meta 改写标准：description 110–160 字符（与 blog eval 同标准）；title 含目标 query 主词 + 一个点击钩子 （数字/年份/直答），不夸大疗效、不用绝对语。

产出格式：一句话诊断 → Top 5 行动表（词/曝光/排位/CTR/落地页/动作）→ 模式归纳 → 区分「机械改写」vs「需要新写内容」→ 若上轮报告存在，附「上轮行动回顾」（同 query 排位/CTR 对比）。

3. 改站与内容更新的硬约束（不可妥协）

• 医学声明必须 <CitationRef> + DOI + 证据等级；无引用 = 不上线。
• 绝不个人化剂量建议、不推荐购药渠道、不削弱急症警告/紧急 banner。
• 无绝对语（"一定"→"建议"，"必须"→"通常"）。
• meta/title 改写也算内容改动——不得为了 CTR 夸大疗效或弱化风险。
• 博客以 zh 为主（ja 限日本本地话题）；文章创作走 /cto-blog-pipeline（有可循证性硬门槛）。
• 隐私红线：GSC/GA 只含站点自身聚合数据，永不掺入用户健康数据/AI 对话/血检记录。gsc-.csv 与 ai-seo-report-.md 保持 gitignored。
• UI/组件级修改遵守 CLAUDE.md（设计系统 + a11y + i18n skill 门槛）。

4. 推荐 SEO 文章选题时

1. 依据 = GSC 真实 query（不臆造搜索词）+ seo-keyword-gap.md P0/P1/P2 优先级 + Trends 热度。
2. 每个选题给：目标 query（真实出现的）、建议标题、目标路径、预期落地语言、一句话理由、可循证性判断（能否找到 DOI 支撑）。
3. 可循证性不过关的选题直接淘汰，不进推荐表。
4. 用户拍板后，创作交给 /cto-blog-pipeline（勿在本 skill 内直接写全文）。

4.5 写文章的配图（gpt-image-2）

选题定稿、正文交给 /cto-blog-pipeline 后，配图这样做。gpt-image-2 现在能可靠渲染文字、多语言、信息图式复杂版面——旧的「图表一律拒绝 LLM 生图」规则（cto-image §26.5）对它已放宽，可放心用于：博客/文档 OG 图、编辑类信息图、概念示意图、图标套装、文字卡片。

gpt-image-2 提示词结构（OpenAI 官方 cookbook）：

1. 顺序 背景/场景 → 主体 → 关键细节 → 约束，复杂需求用换行分块而非长段落。
2. 精确文字放双引号里（或 ALL CAPS），标注字体/字重/颜色/位置（"bold sans-serif, dark-teal, centered top third"）。生僻词（品牌名）逐字母拼：Spell the brand: U-T-R-O-G-E-S-T-A-N。
3. 文字密集/多字体/信息图 → quality: high；一般产品图 medium。
4. 硬约束收尾防乱码：Render text verbatim. No extra characters. No duplicate text. No invented logos.
5. 尺寸 ≤3840px 长边；OG 用 1536×1024（横）或 1024×1536（竖）。信息图加 clean flat visual system, consistent icon style, clear arrows, readable labels, generous white space。
6. 多语言：保留排版只换文字时说 keep typography style, placement, spacing, hierarchy; translate verbatim, no reflow。
7. 站点风格：暗色默认走米哈游「二相乐园」（绯色 #C84B7C / 幻月金 #D4A853 / glass morphism）；手账皮肤走乐园手账（cream #FFF5E0 / sakura #E5578B）——见 CLAUDE.md Visual Design。

医疗红线（配图同样不可妥协）：

• ❌ 带真实数字的图必须走代码组件（PKCurveChart、DoseTable、血检范围图），不用 gpt-image-2 —— AI 画错剂量/半衰期/坐标轴数值是安全事故，不是画质问题。gpt-image-2 只做「示意/编辑/品牌」类图，不做「承载数据」类图。
• ❌ 配图不得暗示疗效夸大、不得出现购药渠道/商业品牌导流、不得弱化风险。
• ✅ 每张图必须有描述性 alt（无障碍 + SEO）；产品示意图 alt 标明是「示意图」。
• ✅ 生成后人工核对渲染出的文字——gpt-image-2 偶尔会加乱码字符或漏字，落库前肉眼确认文案正确（官方硬约束 no extra/duplicate text 是降低概率，不是保证）。
• ✅ 生成后压缩为 WebP/AVIF（>500KB 必压），落 public/images/，OG 图postbuild 由 generate-og-images.mjs 处理。

实际生图仍走 /cto-image 的委派流程（Codex gpt-image-2 asset-in-loop）；本 skill 只负责产出符合上述规范的 prompt + 医疗红线把关。

5. 验证闭环

• 改 meta/内容后：npm run build 通过 + grep dist 确认改动落地（CJK ** 陷阱见 memory）。
• 下一次跑 seo-ops 时对比同一 query 的 position/CTR 变化，在报告中列「上轮行动回顾」。
• 月度 CI：.github/workflows/seo-refresh.yml 每月 1 号自动拉数据开 PR（需 GitHub Secret GSC_CREDENTIALS_B64；未配则只跑 Trends）。