Przeglądaj źródła

docs(seo): v1.1 finalized strategy with GitHub skill learnings

- 学习 GitHub 头部 SEO 技能(claude-seo 13.7k⭐ / claude-blog / marketingskills)
- 修正:FAQPage 富结果已停、llms.txt 非杠杆、GEO=SEO 重包装
- 新增:AI 引用优化(GEO)、E-E-A-T、IndexNow、多语言 QA、可证伪建议
- 决策确认:完整 P1 / GEO 入 P2 / OG 复用 B1 / GA4
DoTouch Dev 2 tygodni temu
rodzic
commit
fea9efca54

+ 2 - 2
.omo/run-continuation/ses_0229f653bffedHZYFR3ILxjlpg.json

@@ -1,10 +1,10 @@
 {
   "sessionID": "ses_0229f653bffedHZYFR3ILxjlpg",
-  "updatedAt": "2026-08-08T18:35:03.574Z",
+  "updatedAt": "2026-08-08T19:56:13.124Z",
   "sources": {
     "background-task": {
       "state": "idle",
-      "updatedAt": "2026-08-08T18:35:03.574Z"
+      "updatedAt": "2026-08-08T19:56:13.124Z"
     }
   }
 }

+ 197 - 0
docs/seo/seo-strategy-v1.0.md

@@ -0,0 +1,197 @@
+# DoTouch.AI SEO 方案 v1.1(定稿)
+
+> 日期:2026-08-09 | 状态:**方案定稿 ✅(2026-08-09 决策确认,尚未执行代码)**
+> 适用站点:Next.js 14 多语言站(vi/en/zh-CN/zh-TW)+ 管理后台(/admin,无 SEO 需求)
+> 主目标市场:**越南**(次:东南亚/全球英文开发者)
+
+---
+
+## 一、现状审计(2026-08-09 实测)
+
+| 项目 | 现状 | 影响 |
+|---|---|---|
+| 页面 metadata | 仅全局 layout 有英文 title/description;各页无独立 metadata、无 OG/Twitter/canonical | ❌ 搜索摘要差、社交分享无卡片 |
+| sitemap.xml / robots.txt | **缺失** | ❌ 抓取与收录效率低 |
+| 结构化数据 JSON-LD | **缺失**(无 Organization/FAQ/Product schema) | ❌ 无缘富结果(FAQ 手风琴/价格展示) |
+| hreflang | **缺失** | ❌ 4 语言重复内容权重分散 |
+| 渲染模式 | 全站 `ƒ` 动态渲染(仅 /admin 静态) | ⚠️ 首屏与抓取成本高,应 SSG 静态化 |
+| 性能基线 | 未测量(Lighthouse/CWV) | ⚠️ 待建基线 |
+| 域名 | doTouch.AI(.AI 对 AI 主题天然加分) | ✅ |
+| 关键词 | 页面文案已含(API/价格/模型名)但无系统化标题策略 | ⚠️ 待结构化 |
+
+---
+
+## 二、技术 SEO(P1 · 优先级最高)
+
+### 2.1 完整 Metadata 体系(Next.js Metadata API)
+- **每页独立 metadata**:`title`(品牌+关键词,60 字内)+ `description`(150-160 字)+ `canonical`(自引用,带 locale)
+- **多语言 metadata**:`metadataBase` 设 `https://dotouch.ai`;每 locale 独立 title/description(vi 用越南语撰写,非翻译腔)
+- **OG/Twitter 卡**:`openGraph`(title/description/type=website/locale)+ `twitter` card;OG 图用 B1 品牌图(assets 已有)
+- 页面清单:首页 / models / models/[id]×4 / pricing / pricing/catalog / docs / console(console 无索引 `robots: noindex`,登录后应用)
+
+### 2.2 hreflang(4 语言 + x-default)
+```
+<link rel="alternate" hreflang="vi" href="https://dotouch.ai/vi/..."/>
+<link rel="alternate" hreflang="en" .../>
+<link rel="alternate" hreflang="zh-CN" .../>
+<link rel="alternate" hreflang="zh-TW" .../>
+<link rel="alternate" hreflang="x-default" href="https://dotouch.ai/vi/..."/>
+```
+- 实现:layout 内按当前 locale 输出全部 4 个 alternate + x-default(默认 vi,与站点默认语言一致)
+
+### 2.3 sitemap.xml + robots.txt(App Router 文件约定)
+- `app/sitemap.ts`:全路由 × 4 语言 + models/[id]×4 动态条目;`lastModified` 随内容更新;`changefreq`/`priority`(首页 1.0 / 模型与定价 0.8 / 文档 0.5)
+- `app/robots.ts`:`User-agent: *` + `Allow: /` + `Disallow: /admin /api` + `Sitemap: https://dotouch.ai/sitemap.xml`
+
+### 2.4 结构化数据 JSON-LD
+- **Organization**(全站):品牌名/URL/Logo(B1 SVG→PNG)/sameAs(后续社媒)
+- **WebSite**(全站):SearchAction 预留
+- **FAQPage**(docs 页 FAQ 手风琴 + 首页 FAQ):问题/答案对(4 语言各输出)
+- **Product/SoftwareApplication**(models/[id] 详情页):模型名/价格(USD per 1M)/聚合评分预留——与网关真实定价联动(后续)
+- **BreadcrumbList**(各子页)
+
+### 2.5 静态化(SSG)改造
+- `[locale]/layout.tsx` 与各页加 `generateStaticParams()`(4 locale)
+- 目标:全站 `○` 静态预渲染(除 /console 动态 + /admin),显著降低抓取成本与 TTFB
+- 注意:当前 layout 用 `await params` 的 Promise 模式,静态化需 `dynamicParams` 语义确认后改造
+
+### 2.6 性能基线(Core Web Vitals)
+- 用 perfection 规则集方法:Playwright + Lighthouse(mobile/desktop ×3-5 轮取中位数)建基线
+- 目标:LCP < 2.5s、CLS < 0.1、INP < 200ms、Lighthouse 四类 ≥ 90
+- 已知优化点:Hero SVG 动画(GPU 合成已合规)、字体(系统字体栈已最优)、路由级代码分割(Next 默认)
+
+---
+
+## 三、内容 SEO(P2)
+
+### 3.1 关键词策略(越南语优先)
+| 意图 | 关键词(vi) | 落地页 |
+|---|---|---|
+| 品牌 | doTouch.ai / API dotouch | 首页 |
+| 高购买意图 | API giá rẻ / API Trung Quốc giá rẻ | 定价页 |
+| 模型长尾 | deepseek api giá / glm api / qwen api | models/[id] 详情页 |
+| 场景 | API cho chatbot / AI cho doanh nghiệp nhỏ | 首页+文档 |
+| 英文 | affordable LLM API / DeepSeek API Vietnam | 英文页 |
+
+### 3.2 页面标题模式
+- 首页:`DoTouch.AI – API AI giá rẻ cho Việt Nam (DeepSeek, GLM, Qwen)`
+- 模型页:`{模型名} API – Giá rẻ 30%, OpenAI Compatible | DoTouch.AI`
+- 定价页:`Bảng giá API AI | Giá bằng 70% Trung Quốc | DoTouch.AI`
+
+### 3.3 内容计划(后续阶段)
+- 博客/知识库(vi+en):"如何选择 LLM API"、"DeepSeek vs Qwen 对比"、"越南开发者 API 指南"(长尾入口)
+- 文档增强:模型对比表、价格计算器(交互内容=外链磁铁)
+
+---
+
+## 四、出海与本地化 SEO(P3)
+
+- **越南市场**:Google Search Console(越南区)+ Bing Webmaster;越南语内容质量优先于数量
+- **本地化信号**:越南盾价格展示(已有)、越南语客服(Zalo)→ 信任与停留信号
+- **域名**:doTouch.AI 的 .AI 后缀对 AI 行业关键词有正面信号
+- **多语言重复内容**:hreflang + canonical 双保险(P1 已含)
+- 合规提示:越南 PDPD 对用户数据要求 → 隐私政策页纳入索引(信任信号)
+
+---
+
+## 五、监控与测量(P4)
+
+| 工具 | 用途 |
+|---|---|
+| Google Search Console | sitemap 提交、收录监控、关键词表现、hreflang 报错检查 |
+| Bing Webmaster Tools | 次要搜索引擎覆盖 |
+| Lighthouse/PageSpeed Insights | CWV 持续基线(CI 门禁可选) |
+| 分析(GA4 或自托管 Plausible) | 流量/转化(注册→充值漏斗) |
+
+---
+
+## 六、分阶段执行计划(确认后执行)
+
+| 阶段 | 内容 | 预估 |
+|---|---|---|
+| **P1 技术 SEO** | metadata 全页 + hreflang + sitemap/robots + JSON-LD + SSG 静态化 + 性能基线 | 1-2 天 |
+| **P2 内容 SEO** | 标题/描述 4 语言落地 + 关键词映射校验 | 0.5-1 天 |
+| **P3 出海 SEO** | GSC/Bing 接入、sitemap 提交、监控看板 | 0.5 天 |
+| **P4 持续** | CWV 优化、内容更新节奏、博客(另行立项) | 持续 |
+
+**验收标准**:sitemap 全收录、hreflang 零报错、全站 SSG、Lighthouse ≥90、GSC 关键词开始出现
+
+---
+
+## 七、待确认决策点
+
+1. **OG/分享图**:用现有 B1 品牌图(Seedream 质感稿)还是重新设计 1200×630 OG 专用图?
+2. **/console 与 /admin**:确认 noindex(登录后应用,不应收录)?
+3. **sitemap 更新频率**:模型/价格变化时手动触发 or 定时(后续接 CI)?
+4. **博客**:是否纳入本方案范围(当前列为 P4 之后独立立项)?
+5. **分析工具**:GA4(免费)还是自托管 Plausible(隐私友好,符合越南/欧盟偏好)?
+
+---
+
+*参考:frontend skill perfection 规则集(Lighthouse 真实浏览器审计方法);Next.js Metadata/Sitemap/JSON-LD 官方约定*
+
+---
+
+## 八、GitHub 头部 SEO 技能学习成果(2026-08-09)
+
+> 来源:AgriciDaniel/claude-seo(13.7k⭐,SEO 专用全集)、AgriciDaniel/claude-blog(1.6k⭐,多语言内容引擎)、coreyhaines31/marketingskills(43.5k⭐,营销全集)等
+
+### 8.1 关键认知修正(影响方案)
+| 学习点 | 对方案的影响 |
+|---|---|
+| **FAQPage schema 于 2026-05-07 停止 Google 富结果**(HowTo 更早已废弃) | ❌ 原 2.4 节 FAQPage 计划**取消**(保留 QAPage 仅用于真实问答页);富结果价值转向 Product/SoftwareApplication |
+| **GEO/AEO = SEO 的重新包装**(Google AI Optimization Guide) | 不做独立"AI SEO"体系;在内容维度加入 **AI 引用就绪**评分(见 8.2) |
+| **llms.txt 不是引用杠杆**(有主要来源证据) | 不做 llms.txt 优化(避免无效投入) |
+| **机器翻译漂移是 Google 质量问题**(2025-01 QRG) | 多语言站必须做**翻译质量 QA**(非直译),纳入 P2 |
+
+### 8.2 新增:AI 搜索引用优化(GEO 维度,融入 P2)
+- **段落可引用性**:每个关键段落写成 134-167 词的自包含答案块(问题-答案结构)
+- **基于问题的标题层级**(H2/H3 用疑问句/关键词短语,AI 系统可直接引用)
+- **归因密度**:数据点给出处(价格表引用百炼来源、兼容性声明引用 OpenAI 规范)
+- **实体存在**:品牌/模型名在外部平台(Wikipedia/Reddit/GitHub/社媒)的一致性
+- 与 claude-blog 的 AI 引用评分(0-100,AI Overview/Perplexity/ChatGPT 视角)对齐
+
+### 8.3 新增:E-E-A-T 落地(Trust 权重最高)
+| 信号 | 落地项 |
+|---|---|
+| Trust(最高) | 联系信息页(邮箱/社媒/Zalo)、HTTPS(部署时)、透明纠错(更新日志公开)、页面日期戳 |
+| Experience | 实测价格/延迟数据(我们跑真实基准)、客户案例(后续) |
+| Expertise | 作者/团队介绍(文档署名)、技术深度(API 文档质量) |
+| Authority | 外链(GEO/博客合作)、GitHub 开源、社区(Zalo/Telegram) |
+
+### 8.4 新增:IndexNow(Bing 等快速收录)
+- sitemap 之外接入 **IndexNow**(Bing/Yandex/Seznam/Naver):内容更新后 API 即时通知,秒级收录
+- 实现简单(GET/POST 一个 URL),纳入 P1
+
+### 8.5 多语言 QA(对齐 claude-blog locale-audit 方法论)
+- **hreflang 对校验**:每页 4 语言互指无缺失
+- **内容 parity**:4 语言信息完整度一致(翻译缺失检测)
+- **本地化深度**:非直译——货币/案例/关键词本地化(我们已有 VND 展示)
+- **新鲜度同步**:模型/价格更新时 4 语言同步刷新(接入 CI 提示)
+
+### 8.6 建议的可证伪性(falsifiability)
+每条优化建议附带验证方式(claude-seo 方法论):
+- metadata/hreflang → GSC 覆盖率与索引状态
+- AI 引用 → Perplexity/AI Overview 抽查品牌名+关键词
+- CWV → CrUX 现场数据周报
+- 关键词 → GSC 查询位置跟踪
+
+### 8.7 可复用工具模式(后续按需)
+- 内容衰减检测(GSC 20% QoQ 下降 → 刷新/合并/删除)
+- 主题聚类(hub-and-spoke:文档/博客围绕模型页聚簇)
+- 5 门禁交付(若建博客:质量分 90 才发布)
+
+---
+
+## 九、已确认决策(2026-08-09)
+
+| 决策点 | 结论 |
+|---|---|
+| P1 执行范围 | ✅ **完整 P1**:metadata 全页 + hreflang + sitemap/robots + JSON-LD(Organization/WebSite/Product/Breadcrumb,无 FAQPage)+ SSG 静态化 + IndexNow + 性能基线 |
+| GEO/AI 引用优化 | ✅ **纳入 P2**(段落答案块化 134-167 词 + 问题式标题 + 归因密度) |
+| OG 分享图 | ✅ **复用现有** B1 质感稿(logo-b1-seedream-v1.png),专用 1200×630 后续迭代 |
+| 分析工具 | ✅ **GA4**(免费、与 GSC 联动;数据出境 Google 已接受) |
+| FAQPage schema | ✅ **不实施**(Google 2026-05-07 停止富结果,学习成果修正) |
+| llms.txt | ✅ **不做**(无引用杠杆证据) |
+
+**下一步**:待用户指令后执行 P1(完整技术 SEO 落地)。