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개. 코드에서 알 수 있는 것은 묻지 않습니다.
- 대상 채널: 검색(Google·네이버·Daum·Bing·Brave·Apple), AI 검색(ChatGPT·Perplexity·Claude 등), 공유(카카오톡·X·Meta) 중 무엇이 중요한가. 기본값: 한국 서비스면 Google + 네이버 + Daum + 카카오톡 + X + Meta, AI 검색(ChatGPT·Claude·Grok·Gemini·Copilot·Perplexity) 노출 허용이 기본, 학습 차단은 운영자 결정.
- 사이트 상태: 아직 코드만 있음 / 배포됨(URL 있음) / Search Console·서치어드바이저 등록됨.
- 페이지 유형: 홈, 목록, 상세(행사·상품·글), 지역·월별 모음 등. 대량 생성 페이지가 있으면
scaled-pages를 반드시 포함.
2. 조합 순서
- 크롤링·색인 기반(공통): 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 사용). - 페이지 메타: 고유
<title>,meta description,og:*,twitter:*, 파비콘,html lang. →google-search§제목·스니펫,naver-search§콘텐츠 마크업,social-preview. - 구조화 데이터: 페이지 유형에 맞는 JSON-LD. 보이는 본문과 일치하는 값만.
→
structured-data. - AI 검색 노출(기본 적용): AI 검색·사용자 요청 크롤러 허용, WAF·CDN이 그 IP를 막지 않음, Claude용 Brave 색인·Grok용 X 게시물 확인. 학습 차단은 따로 결정하되
Google-Extended·ai-grounding은 노출과 충돌함을 알림. →ai-crawlers. - 대량 페이지 품질: 조합 페이지가 있다면 색인 대상 기준과 noindex 기준.
→
scaled-pages. - 알리기·측정: Google Search Console(사이트맵 제출, URL 검사), 네이버 서치어드바이저(소유 확인, 사이트맵·RSS 제출), IndexNow, 공유 디버거.
→
google-search§Search Console,naver-search§웹마스터도구,daum-search§검색등록,other-search-engines§Bing·Brave,indexnow,social-preview§캐시. - 브라우저 확인: 사용자 비중이 큰 브라우저(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참고)