shaul1991/seo-orchestrator

SEO 조합 시작점

이 Skill은 직접 모든 규칙을 담지 않습니다. 대상 채널을 정한 뒤 아래 하위 Skill을 순서대로 불러 조합합니다.

하위 Skill	다루는 것
google-search	Google 크롤링·색인·제목·스니펫·사이트맵·canonical·사이트 이름·AI 기능·스팸 정책·Search Console
naver-search	네이버 서치어드바이저: Yeti, robots.txt, 소유 확인, 메타·오픈그래프, RSS·사이트맵 제출, 수집 요청, 파비콘, 스팸
structured-data	JSON-LD 템플릿(Event, Organization/sameAs, WebSite, BreadcrumbList)과 Google·네이버 차이
daum-search	Daum(카카오) 검색: Daum/Daum-Preview 로봇, 검색등록, 웹마스터도구 PIN, 연관 채널, 카카오톡 채널·카카오맵
other-search-engines	Bing(Edge·Copilot), Brave Search(Brave 브라우저), DuckDuckGo, Apple(Safari·Spotlight·Siri)
ai-crawlers	ChatGPT·Perplexity·Claude·Meta AI·Apple·Google·Bing의 AI 검색·학습 크롤러 정책
social-preview	Open Graph, X(Twitter) 카드, 카카오톡, Meta(Facebook·Instagram·Threads), Daum 미리보기
indexnow	IndexNow로 네이버·Bing 등에 변경 URL 알리기
scaled-pages	지역·날짜·카테고리 조합 페이지를 대량으로 만들 때의 품질 기준(얇은 페이지·도어웨이 회피)
browser-compat	Brave Shields·De-AMP, 파비콘·theme-color·manifest, 브라우저별 표시·측정

다른 Skill과의 경계

SEO(발견·색인·표시·AI 검색 노출)는 이 저장소가 맡습니다. 아래처럼 성격이 다른 일은 다루지 않으며, 필요하면 그 Skill을 따로 씁니다.

일	이 저장소	다른 Skill 예시
크롤링·색인·메타·구조화 데이터·공유 미리보기·AI 크롤러·검색엔진 등록	✅	—
대상 사용자·차별점·고객 언어·브랜드 톤(마케팅 문맥)	읽기만	marketingskills product-marketing
무엇을 만들지·주제 묶음·발행 일정(콘텐츠 기획)	읽기만	marketingskills content-strategy
UI 디자인	—	Impeccable 등

• 프로젝트에 마케팅 문맥 문서(예: .agents/product-marketing.md, PRODUCT.md)나 콘텐츠 계획이 있으면 먼저 읽고 제목·설명 문구와 색인할 페이지 판단에 씁니다. 없으면 만들지 않고 진행합니다.
• 같은 기술 SEO 점검 Skill(예: marketingskills seo-audit)과 함께 켜면 지시가 겹칩니다. 하나만 씁니다.
• scaled-pages는 "만든 페이지를 색인할지"까지만 다룹니다. "어떤 페이지를 만들지"는 콘텐츠 기획 쪽입니다.

1. 먼저 정할 것

질문은 최대 3개. 코드에서 알 수 있는 것은 묻지 않습니다.

1. 대상 채널: 검색(Google·네이버·Daum·Bing·Brave·Apple), AI 검색(ChatGPT·Perplexity·Claude 등), 공유(카카오톡·X·Meta) 중 무엇이 중요한가. 기본값: 한국 서비스면 Google + 네이버 + Daum + 카카오톡 + X + Meta, AI 검색(ChatGPT·Claude·Grok·Gemini·Copilot·Perplexity) 노출 허용이 기본, 학습 차단은 운영자 결정.
2. 사이트 상태: 아직 코드만 있음 / 배포됨(URL 있음) / Search Console·서치어드바이저 등록됨.
3. 페이지 유형: 홈, 목록, 상세(행사·상품·글), 지역·월별 모음 등. 대량 생성 페이지가 있으면 scaled-pages를 반드시 포함.

2. 조합 순서

1. 크롤링·색인 기반(공통): robots.txt, HTTP 상태 코드, 리다이렉트, canonical, 서버 HTML에 본문이 있는지, <a href> 링크, 사이트맵. → google-search §크롤링, naver-search §수집, daum-search §로봇, other-search-engines 적용. Googlebot 규칙은 Brave·Apple에도 번지므로 특히 조심합니다. 충돌하면 더 엄격한 쪽을 따릅니다(예: 네이버는 JavaScript·meta refresh 리다이렉트를 소유 확인에서 지원하지 않음 → HTTP 301/302 사용).
2. 페이지 메타: 고유 <title>, meta description, og:*, twitter:*, 파비콘, html lang. → google-search §제목·스니펫, naver-search §콘텐츠 마크업, social-preview.
3. 구조화 데이터: 페이지 유형에 맞는 JSON-LD. 보이는 본문과 일치하는 값만. → structured-data.
4. AI 검색 노출(기본 적용): AI 검색·사용자 요청 크롤러 허용, WAF·CDN이 그 IP를 막지 않음, Claude용 Brave 색인·Grok용 X 게시물 확인. 학습 차단은 따로 결정하되 Google-Extended·ai-grounding은 노출과 충돌함을 알림. → ai-crawlers.
5. 대량 페이지 품질: 조합 페이지가 있다면 색인 대상 기준과 noindex 기준. → scaled-pages.
6. 알리기·측정: Google Search Console(사이트맵 제출, URL 검사), 네이버 서치어드바이저(소유 확인, 사이트맵·RSS 제출), IndexNow, 공유 디버거. → google-search §Search Console, naver-search §웹마스터도구, daum-search §검색등록, other-search-engines §Bing·Brave, indexnow, social-preview §캐시.
7. 브라우저 확인: 사용자 비중이 큰 브라우저(Brave Shields 포함)에서 주요 흐름·아이콘·측정 확인. → browser-compat.

3. 자동 점검 스크립트

배포된 URL이나 빌드된 HTML 파일이 있으면 먼저 돌립니다. 이 Skill 폴더의 scripts/seo-check.mjs(의존성 없음, Node 18+)입니다. <skill 폴더>는 이 SKILL.md가 있는 폴더입니다.

node <skill 폴더>/scripts/seo-check.mjs https://example.com/page      # URL (robots.txt·사이트맵 위치도 확인)
node <skill 폴더>/scripts/seo-check.mjs ./out/events/123.html         # 로컬 HTML
node <skill 폴더>/scripts/seo-check.mjs --json https://example.com/   # 기계용 출력

스크립트는 단일 페이지의 마크업만 봅니다. 순위·색인 여부·렌더링 결과는 알 수 없습니다. Search Console·서치어드바이저의 URL 검사로 따로 확인합니다.

4. 보고 형식

## SEO 점검 결과 (<URL 또는 경로>, <확인 시각>)
| 채널 | 항목 | 상태 | 근거 | 조치 |
| --- | --- | --- | --- | --- |
| 공통 | robots.txt | ✅/⚠️/❌ | 관찰값 | 할 일 |
...
### 확인하지 못한 것
- 예: 실제 색인 여부(Search Console 미연결), 카카오톡 미리보기 캐시(공유 디버거 로그인 필요)

• 관찰한 값과 추론을 구분합니다. "순위가 오를 것"처럼 결과를 보장하지 않습니다(Google·네이버 모두 색인·노출을 보장하지 않는다고 명시).
• 이 저장소의 규칙은 2026-11-04 확인 기준입니다. 정책·수치가 판단을 좌우하면 하위 Skill에 적힌 공식 원문을 다시 엽니다.

하지 말 것

• 페이지에 없는 가격·날짜·후기·평점을 구조화 데이터나 메타에 넣기
• 검색 노출만을 위한 키워드 반복, 숨긴 텍스트, 같은 내용의 페이지 대량 생성
• 검색엔진별로 다른 HTML 제공(클로킹)
• 근거 없이 llms.txt 같은 AI 전용 파일을 "필수"라고 안내하기(Google은 AI 기능에 별도 파일·마크업이 필요 없다고 밝힘 — google-search 참고)