📚 Itinerario YinyangSEO Academy · 第 1 課 — 代理式網站與高效 SEO。 此技能屬於第 1 課儲存庫的一部分。請先複製或下載整個儲存庫，並在執行此技能前將其提供給您的代理作為上下文。該儲存庫會在課程期間持續更新。
Web Blueprint Generator 是做什麼的？
從 偵測到的模式 到 網站藍圖。在生成頁面之前，先定義有哪些頁面、各自的結構、Schema 以及內部連結方式。缺少此層，代理每次都會即興產生落地頁，導致結果不一致。
輸入
data/patterns/{kw}/{date}/hypotheses.md← 來自local-seo-pattern-aggregator。- 目標商家 · 名稱、NAP、USP、實際服務清單、要覆蓋的區域清單。
- 技術棧 · 預設為 Astro（也可用：Next.js、純 MDX）。
- 限制條件 · 語言、最大頁面數、Lighthouse 預算。
流程
- URL 地圖 從模式 + 區域生成：
- 首頁 (
/) - 核心服務頁 (
/servicios/{slug}/) - 服務 × 區域 (
/{servicio}/{barrio}/) — 在地 SEO 的核心 - 關於我們、聯絡我們、法律頁面
- 部落格（可選）
- 首頁 (
- 為每種頁面類型定義：
- Title 模式 和 Meta Description 模式（包含變數：
{servicio}、{barrio}、{ciudad}、{telefono}）。 - H1、H2、H3 模式。
- 強制區塊（從聚合器的 HIGH 假設中提取）。
- 各類型的 JSON-LD Schema：
- 首頁 →
LocalBusiness+Organization。 - 核心服務頁 →
Service+BreadcrumbList。 - 服務 × 區域 →
Service加上areaServed: PostalAddress+BreadcrumbList+FAQPage。
- 首頁 →
- CTA（如果勝出者都有，則電話號碼始終可見）。
- Title 模式 和 Meta Description 模式（包含變數：
- 內部連結計畫：
- 首頁 → 所有核心服務頁。
- 核心服務頁 → 其所有區域。
- 服務 × 區域 → 同服務的其他區域 + 核心服務頁 + 相關服務。
- 一致的
nearby areas區塊。
- 每頁最低內容計畫： 長度、強制 FAQ、社交證明、NAP。
- Lighthouse 預算（繼承自前三名的模式）：LCP、CLS、TBT、JS bundle。
工具
- 用 LLM 來撰寫包含變數的模式。
- schema-dts 用於驗證 JSON-LD 是否符合官方類型。
- astro-seo 或
next-sitemap（作為自動生成 Sitemap 的參考）。
輸出
blueprint/{negocio-slug}/
├── url-map.yaml ← 要生成的完整 URL 清單
├── page-templates/
│ ├── home.md ← 包含 {{...}} 變數的範本
│ ├── service-pillar.md
│ └── service-area.md
├── schema-templates/
│ ├── home.jsonld
│ ├── service-pillar.jsonld
│ └── service-area.jsonld
├── internal-linking.yaml
├── lighthouse-budget.json
└── README.md ← 如何使用此藍圖
url-map.yaml 範例：
home: /
services:
- slug: cerrajero-24h
barrios: [centro, sant-oleguer, can-rull, gracia]
- slug: aperturas-puertas
barrios: [centro, sant-oleguer, can-rull]
legales:
- aviso-legal
- politica-privacidad
- cookies
品質 / QA
- 確認每個
service-area在首頁點擊 ≤ 3 次內可達。 - 不要生成超出使用者限制的服務 × 區域組合（應發出警告並要求優先排序）。
- 在傳遞給生成器之前，使用 schema-dts 驗證 JSON-LD。
後續用途
→ 直接作為 landing-generator-servicio-barrio（生成實際程式碼）和 landing-qa-runner（驗證預算）的輸入。