/fireauto-seo-guide

name: fireauto-seo-guide
description: >
  "SEO 감사", "SEO audit", "기술 SEO", "technical SEO", "구조화 데이터",
  "schema markup", "JSON-LD", "robots.txt", "sitemap", "메타 태그",
  "검색엔진 최적화", "pSEO", "Rich Results", "Core Web Vitals" 등
  SEO 관련 최적화나 감사 시 사용하세요.

SEO 감사 방법론

Next.js 프로젝트에 대한 포괄적 SEO 감사를 수행하기 위한 방법론. 실제 프로덕션 프로젝트 감사 경험에서 축적된 패턴 기반.

감사 원칙

1. **코드 기반 감사**: 소스 코드 분석으로 빌드 전 이슈 발견 2. **프레임워크 인식**: Next.js App Router 패턴에 최적화 3. **심각도 기반 우선순위**: P0(Critical) ~ P3(Low) 4. **실행 가능한 피드백**: 각 이슈에 구체적 수정 코드 제시

감사 순서 (의존성 기반)

1. robots.txt / sitemap — 크롤링 기반 2. 메타 태그 — 인덱싱 기반 3. JSON-LD 구조화 데이터 — Rich Results 4. pSEO 라우트 — 대량 페이지 품질 5. 리다이렉트 체인 — 크롤 버짓 낭비 6. 성능 SEO — Core Web Vitals

핵심 체크리스트

robots.txt

• 파일 존재 (public/robots.txt 또는 app/robots.ts)
• 프로덕션에서 Disallow: / 아닌지 확인
• 민감 경로 차단 (admin, api, dashboard)
• Sitemap 지시자 포함

Sitemap

• 모든 공개 라우트 포함
• lastmod 정확성
• 다국어 alternate 링크 (hreflang)

JSON-LD 구조화 데이터

• 홈페이지: Organization + WebSite
• 블로그: Article (headline, datePublished, author, image)
• 상품: Product + Offer (name, price, availability)
• FAQ: FAQPage + Question
• 네비게이션: BreadcrumbList
• 중복 블록 없음

메타 태그

• title (30-60자), description (120-160자)
• og:title, og:description, og:image
• canonical URL, hreflang

성능 SEO

• loading.tsx 존재 (주요 라우트)
• next/image 사용
• 불필요한 "use client" 없음

자주 발견되는 이슈 패턴 (Next.js)

1. **metadata export 누락**: 동적 라우트에서 특히 흔함 2. **JSON-LD 중복**: layout.tsx + page.tsx 양쪽에서 렌더링 3. **sitemap에서 동적 라우트 누락**: DB 조회 없이 정적 URL만 나열 4. **canonical URL 불일치**: 다국어 사이트에서 기본 언어만 지정 5. **OG 이미지 미설정**: SNS 공유 시 이미지 없이 노출 6. **클라이언트 컴포넌트 과다**: page.tsx에 "use client" → SSR 이점 상실

커맨드

`/fireauto-seo` 실행으로 전체 감사를 시작한다.

추가 리소스

• JSON-LD 필수 속성 참조표: `references/json-ld-schemas.md`
• 도구 활용 가이드: `references/tools-guide.md`