📚 Itinerario YinyangSEO Academy · 수업 1 — 에이전틱 웹과 효율적인 SEO. 이 스킬은 수업 1 저장소의 일부입니다. 전체 저장소를 클론하거나 다운로드하여 실행 전에 에이전트에게 컨텍스트로 제공하세요. 저장소는 과정 중에 업데이트됩니다.
랜딩 생성기 · 서비스 × 지역
청사진을 가져와 고객 웹 저장소에 실제 파일을 생성합니다. 기본적으로 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 스키마 추가.
internal-linking.yaml에 따라 내부 링크 계산.- 저장소의 올바른 경로에 파일 작성.
- 변수 (
- 필러 페이지 (
/servicios/{slug}/) 생성 — 해당 지역 목록 포함. sitemap.xml생성 (또는@astrojs/sitemap설정) — 우선순위 포함.- 일관된
robots.txt생성. - 변경 사항 커밋 — 새 브랜치:
feat/landings-{servicio}-{N}-barrios. - 요약 표시: 생성된 페이지 수, 총 HTML 용량, 스키마 검증 결과, 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-dts로 검증됨
품질 / QA
- 콘텐츠 고유성: 각 랜딩 페이지는 형제 페이지와 30% 이상의 서로 다른 토큰을 가져야 함 (Jaccard 유사도 < 0.7). 그렇지 않으면 가변 블록 재생성.
- 스키마 검증: JSON-LD가 유효하지 않으면 어떤 파일도 작성되지 않음.
- 내부 링크 필수: 각 랜딩 페이지는 같은 서비스의 다른 지역으로 최소 3개의 내부 링크 + 1개의 필러 링크를 가져야 함.
- Lighthouse budget: 생성 후
landing-qa-runner에 위임. - 비용/시간: 한 번의 실행에 50개 이상의 조합이면 경고.
이후 사용
→ landing-qa-runner의 입력으로, 생성된 모든 URL에 대해 Playwright + Lighthouse-CI를 실행하고 상위 3개에서 상속된 예산을 충족하지 않으면 병합을 차단합니다.