📚 Itinerario YinyangSEO Academy · Clase 1 — 智能网站与高效 SEO。 此技能属于第一课仓库的一部分。在执行前，请克隆或下载整个仓库并将其作为上下文提供给您的智能体。仓库内容会在课程期间更新。
落地页生成器 · 服务×区域
接收蓝图并生成客户网站仓库中的物理文件。默认使用 Astro（简单的文件路由，默认 SSG，SEO 友好），但输出也可适配 Next.js 或纯 MDX。
输入
blueprint/{negocio-slug}/← 来自web-blueprint-generator。- 目标文件夹 ·
src/pages/（Astro）或app/（Next.js）。 - 语言区域 · 默认
es-ES。 - 模式 ·
dry-run（列出将要生成的内容）或apply（写入 + 提交）。
流程
- 加载蓝图并验证存在
url-map.yaml、page-templates 和 schema-templates。 - 针对
url-map.yaml中每一对服务×区域组合：- 使用真实业务数据解析变量（
{servicio},{barrio},{ciudad}等）。 - 为每个区域注入最少量的独特内容（禁止重复；参见 QA）。
- 添加对应的 JSON-LD Schema。
- 根据
internal-linking.yaml计算内部链接。 - 将文件写入仓库中正确的路径。
- 使用真实业务数据解析变量（
- 生成支柱页面 (
/servicios/{slug}/) ，列出所覆盖的区域。 - 生成
sitemap.xml（或配置@astrojs/sitemap）并设置优先级。 - 生成
robots.txt保持一致。 - 提交更改到新分支：
feat/landings-{servicio}-{N}-barrios。 - 显示摘要： 创建的页面数、HTML 总大小、Schema 验证结果、是 dry-run 还是已应用。
工具
- 文件系统（读取/写入/编辑）操作客户仓库。
- Git 用于提交。
- Astro +
@astrojs/sitemap+astro-seo。 - LLM 用于生成每个区域的独特内容块（包含长度和唯一性的保护措施）。
- schema-dts 用于在写入前验证 JSON-LD。
输出
src/pages/{servicio}/{barrio}.astro ← 每对组合一个
src/pages/servicios/{servicio}.astro ← 支柱页面
src/data/areas-served.json ← 服务区域的权威数据源
public/sitemap.xml ← 重新生成
public/robots.txt
以及一个干净的提交，包含以下消息：
feat(landings): 生成 N 个服务×区域落地页
- 服务: cerrajero-24h
- 区域数: 12
- 支柱页面已更新
- 站点地图已重新生成（条目数: 13）
- JSON-LD Schema 已通过 schema-dts 验证
质量保证 / QA
- 内容唯一性： 每个落地页必须至少有 30% 的令牌与其兄弟页面不同（Jaccard 相似度 < 0.7）。否则，重新生成变量块。
- Schema 验证： 如果 JSON-LD 验证不通过，则不写入任何文件。
- 强制内部链接： 每个落地页至少有 3 个指向同一服务其他区域的内部链接 + 1 个指向支柱页面的链接。
- Lighthouse 预算： 生成后委托给
landing-qa-runner执行。 - 成本/时间： 如果单次执行超过 50 个组合，则发出提醒。
后续用途
→ 作为 landing-qa-runner 的输入，后者使用 Playwright + Lighthouse-CI 对所有生成的 URL 进行测试，如果不符合继承自前三名的预算，则阻止合并。