Files
game-fe-agent/skills/verify-seo-geo/SKILL.md

3.8 KiB

name, description
name description
verify-seo-geo Nuxt 프로젝트를 SEO · AEO · GEO 3계층으로 자동 감사하고 useSeoMeta, useSchemaOrg 기반 메타/구조화 데이터 코드를 자동 생성합니다. AI 검색(ChatGPT, Perplexity, Google AI Overview) 대응까지 포함합니다. 다음 상황에서 반드시 사용하세요: - "SEO 검증해줘", "메타 태그 확인해줘", "AEO/GEO 대응해줘" - Schema.org 구조화 데이터가 필요할 때 - AI 검색 노출을 높이고 싶을 때

SEO · GEO · AEO 검증 (verify-seo-geo)

Nuxt 프로젝트 → SEO / AEO / GEO 3계층 자동 감사 → 메타 + Schema 코드 생성.

언제 사용하는가

  • 배포 전 SEO 메타 누락 여부를 확인할 때
  • AI 검색 엔진(ChatGPT, Perplexity 등)에 콘텐츠 인용률을 높이고 싶을 때
  • Schema.org 구조화 데이터를 처음 적용할 때

3계층 정의

계층 목표 핵심 기술
SEO 전통 검색 엔진 노출 메타 태그, Open Graph, sitemap
AEO (Answer Engine Optimization) 검색 결과 직접 답변(Featured Snippet) FAQ Schema, HowTo Schema
GEO (Generative Engine Optimization) AI 검색 인용 구조화 데이터, 명확한 문서 구조

작업 순서

Phase 1: 현황 감사

  1. 대상 페이지 파일을 읽어 아래 항목을 체크한다.

SEO 기본 체크리스트

  • useSeoMeta() 사용 여부
  • title, description 설정 여부 (title 5060자, description 150160자)
  • ogTitle, ogDescription, ogImage 설정 여부
  • canonical URL 설정 여부
  • <NuxtImg> 사용 + alt 텍스트 여부
  • H1 태그 존재 및 키워드 포함 여부
  • 페이지 로딩 속도 (verify-perf 연계)

AEO / GEO 체크리스트

  • FAQ, HowTo, Article 등 Schema.org 적용 여부
  • 구조화 데이터 JSON-LD 유효성
  • 콘텐츠 답변 가능성 (질문 → 명확한 답변 구조)

Phase 2: SEO 코드 생성

// pages/product/[id].vue
useSeoMeta({
  title: `${product.name} | 브랜드명`,
  description: product.description.slice(0, 155),
  ogTitle: `${product.name} | 브랜드명`,
  ogDescription: product.description.slice(0, 155),
  ogImage: product.imageUrl,
  ogType: 'product',
  twitterCard: 'summary_large_image',
})

useHead({
  link: [{ rel: 'canonical', href: `https://example.com/product/${product.id}` }],
})

Phase 3: Schema.org 구조화 데이터

FAQ Schema (AEO)

useSchemaOrg([
  defineQuestion({
    name: '자주 묻는 질문 1',
    acceptedAnswer: { text: '답변 내용' },
  }),
])

HowTo Schema

useSchemaOrg([
  defineHowTo({
    name: '사용 방법',
    step: [
      { name: '1단계', text: '설명' },
      { name: '2단계', text: '설명' },
    ],
  }),
])

Article Schema (GEO)

useSchemaOrg([
  defineArticle({
    headline: article.title,
    description: article.summary,
    datePublished: article.publishedAt,
    dateModified: article.updatedAt,
    author: [{ name: article.author }],
  }),
])

Phase 4: GEO 콘텐츠 구조 개선 제안

AI 검색 인용을 높이기 위한 콘텐츠 구조 권고:

  • 명확한 소제목(H2/H3)으로 콘텐츠 분절
  • 핵심 개념은 첫 단락에 요약
  • 테이블/리스트로 스캔 가능한 정보 구조화
  • 정의·비교·절차 형식의 콘텐츠 우선 작성

출력 형식

## SEO/GEO/AEO 검증 리포트: <페이지명>

### SEO 현황
- title: 있음 / 없음 / 글자수 초과
- description: 있음 / 없음
- OG 태그: NN/6 항목 적용
- Schema.org: 없음 / FAQ / Article / ...

### 🚨 Critical
- [누락된 필수 메타 항목]

### ⚠️ Warning
- [개선 권장 항목]

### 생성된 코드
[useSeoMeta + useSchemaOrg 코드]

### GEO 개선 제안
[콘텐츠 구조 개선 방향]