Communitygithub.com

Freskan23/clase-1-agentes-ia-webs — Landing Generator · Servici…

청사진을 기반으로 서비스 × 지역별 방문 페이지를 일괄 생성하여 Astro/MDX 저장소에 파일을 작성하고, JSON-LD 스키마, 내부 링크, 사이트맵을 추가합니다. 사용자가 '랜딩 페이지 생성', '서비스 × 지역 페이지 생성', '청사진 URL 구축', '지역별 웹 확장'을 요청하거나 `web-blueprint-generator` 실행 후에 항상 사용하세요.

clase-1-agentes-ia-webs — Landing Generator · Servici…란 무엇인가요?

이 스킬은 청사진(`url-map.yaml`, 템플릿, 스키마)을 실제 커밋 가능한 코드로 변환하는 전문 생성기입니다. 기본적으로 Astro 프로젝트에 `src/pages/{servicio}/{barrio}.astro` 파일을 생성하며, 필요에 따라 Next.js나 순수 MDX로도 출력을 조정할 수 있습니다. JSON-LD 스키마 검증, 내부 링크(최소 3개 이상의 지역 간 링크 + 1개의 필러 페이지 링크) 자동 계산, 사이트맵 및 robots.txt 생성을 포함합니다. 콘텐츠 중복을 방지하기 위해 Jaccard 유사도 < 0.7을 검사하며, LLM을 활용해 지역별 고유 콘텐츠 블록을 생성합니다. 모든 파일은 `feat/landings-{servicio}-{N}-barrios` 브랜치에 커밋되며, 50개 이상의 조합이면 비용/시간 경고를 띄웁니다. 결과물은 `landing-qa-runner` 스킬로 전달되어 Playwright + Lighthouse-CI로 테스트됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Freskan23/clase-1-agentes-ia-webs/tree/HEAD/03-skills/landing-generator-servicio-barrio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

📚 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 (파일 작성 + 커밋).

프로세스

  1. 청사진 로드 및 url-map.yaml, page-templates, schema-templates 존재 여부 검증.
  2. url-map.yaml의 각 서비스 × 지역 조합에 대해:
    • 변수 ({servicio}, {barrio}, {ciudad} 등)를 실제 비즈니스 데이터로 해석.
    • 지역별 최소 고유 콘텐츠 주입 (중복 금지; QA 참고).
    • 해당 JSON-LD 스키마 추가.
    • internal-linking.yaml에 따라 내부 링크 계산.
    • 저장소의 올바른 경로에 파일 작성.
  3. 필러 페이지 (/servicios/{slug}/) 생성 — 해당 지역 목록 포함.
  4. sitemap.xml 생성 (또는 @astrojs/sitemap 설정) — 우선순위 포함.
  5. 일관된 robots.txt 생성.
  6. 변경 사항 커밋 — 새 브랜치: feat/landings-{servicio}-{N}-barrios.
  7. 요약 표시: 생성된 페이지 수, 총 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개에서 상속된 예산을 충족하지 않으면 병합을 차단합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬