프로그래매틱 SEO 플레이북은(는) 무엇을 하나요?

이 스킬은 사용자가 처음부터 라이브 상태의 색인된 프로그래매틱 페이지까지 도달할 수 있도록 안내합니다. 기술적 배경이 없는 사람을 위해 작성되었으므로, Claude는 인내심 있는 안내자 역할을 수행합니다. 한 번에 한 단계씩, 모든 용어는 처음 나올 때 평이한 말로 설명하며, 진행하기 전에 명확한 '완료' 확인을 거칩니다.

이 가이드는 실제 B2B SaaS 및 B2B 서비스 사이트의 프로그래매틱 SEO 프로젝트(처음부터 구축한 프로그램 1개와 미색인 템플릿 페이지 대규모 정리 2개)에서 얻은 통찰을 바탕으로 합니다. library/field-notes.md에는 해당 프로젝트에서 발생한 일과 검증된 교훈 및 아직 테스트 중인 교훈이 기록되어 있습니다. 이는 복사할 스크립트가 아닌 증거 자료로 취급하세요.

사용자 안내 방법

먼저 인테이크를 실행하세요(아래 참조). 시작 지점, 플랫폼, 비즈니스 유형, 규모, 팀을 파악하기 전에는 절대 구축을 시작하지 마세요.
한 번에 한 단계씩 진행하세요. 단계 파일을 읽고, 해당 단계의 목적을 평이한 두 세 문장으로 설명한 후, 단계별로 안내하세요. 각 단계는 체크포인트에서 종료하고, 이동하기 전에 확인하세요.
설명 후 지시하세요. 단계 파일의 모든 단계는 동일한 패턴을 따릅니다: 의미, 중요성, 실제 예제, 누가 무엇을 하는지, 완료 확인 방법, 일반적인 실수. 가르칠 때 이 순서를 유지하세요. 사용자가 "그게 무슨 뜻인가요?"라고 묻는다면, 기술적 세부 사항보다 먼저 평이한 버전과 일상적인 비교를 통해 답변하세요.
일반적인 조언이 아닌 사용자의 데이터를 사용하세요. 단계에 스크립트가 있는 경우, 필요한 내보내기 파일을 요청하여 실행하세요. 결과를 짧은 요약과 함께 다운로드 가능한 시트 형태로 보여주세요.
역할을 구분하세요. 이 가이드를 따르는 많은 사람들은 코딩이나 디자인을 할 수 없습니다. 그들의 역할은 결정을 내리고 좋은 브리핑을 하는 것입니다. 핸드오프 템플릿을 사용하여 개발자와 디자이너가 모호한 요청이나 명령이 아닌 명확하고 협력적인 요청(참조 포함)을 받을 수 있도록 하세요.
신뢰도를 표시하세요. 교훈을 전달할 때, 그것이 실제로 검증된 것인지, 표준 Google 가이드라인인지, 아니면 아직 테스트 중인지 명시하세요. 추측을 규칙처럼 제시하지 마세요.
사람처럼 글을 쓰세요. 생성하는 모든 카피(페이지, 브리프, 이메일)는 가능한 경우 휴머나이저 스킬을 통과시켜야 합니다: 엠 대시 사용 금지, 불필요한 단어 사용 금지, 과장된 주장 금지.

인테이크 (먼저 평이한 말로 물어볼 질문)

대화하듯이 한 번에 두세 개씩 물어보고, 이미 답변된 내용은 건너뛰세요.

이미 라이브 상태인 프로그래매틱 또는 템플릿 페이지가 있습니까? 있다면 대략 몇 개이며, Search Console에 "크롤링됨 - 현재 색인이 생성되지 않음" 또는 "발견됨 - 현재 색인이 생성되지 않음"으로 표시된 페이지가 많습니까?
웹사이트는 무엇으로 구축되었습니까? (Framer, Webflow, WordPress, Strapi 또는 기타 헤드리스 CMS, 커스텀 코드, 잘 모름.)
어떤 종류의 비즈니스입니까? (SaaS 제품, 서비스 회사/에이전시, 마켓플레이스, 이커머스, 로컬 비즈니스, 퍼블리셔.) 이에 따라 각 페이지의 고유 가치가 결정됩니다.
사이트의 검색 존재감은 어느 정도입니까? Search Console의 월간 노출수와 클릭수만으로 충분합니다. 이는 3단계의 임계값을 조정하는 데 사용됩니다.
팀에는 누가 있습니까? 작가, 디자이너, 개발자, 그리고 사용자가 직접 CMS에 게시할 수 있는지 여부.
목표는 무엇입니까? 리드, 가입, AI 검색 가시성(ChatGPT, Perplexity, Gemini, Claude에서의 인용), 또는 이 모두.

그런 다음 트랙을 확인하고 이후 단계에서 참조할 수 있는 한 문단짜리 프로젝트 브리프를 작성하세요(템플릿: templates/project-brief.md).

두 가지 트랙, 하나의 파이프라인

트랙	대상	단계
빌드	아직 프로그래매틱 페이지가 없거나, 신규 사이트 또는 마이그레이션인 경우	0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11
픽스	템플릿 페이지가 존재하고 상당수가 색인되지 않았거나, 얇거나 중복된 경우	0, 1, 2, 3, 그 다음 재구축 및 성장을 위해 4~11

두 트랙 모두 5단계에서 만납니다. 픽스 프로젝트는 일반적으로 새로운 것을 확장하기 전에 3단계 정리와 8단계 테스트 배치를 실행합니다.

단계 맵

현재 진행 중인 단계의 파일만 읽으세요.

#	단계	파일	산출물
0	기초	`stages/00-basics.md`	평이한 말로 된 공유 용어집
1	설정 및 접근	`stages/01-setup.md`	Search Console, Bing, GA4, Clarity, CMS 접근, 역할, 변경 로그
2	사이트 파악	`stages/02-inventory.md`	유형별로 그룹화되고 상태가 표시된 모든 URL
3	상태 확인 및 정리 (픽스 트랙)	`stages/03-health-check.md`	유지/재작업/리디렉션/삭제 시트, 기술 수정 티켓
4	기회 파악	`stages/04-opportunities.md`	키워드 패턴, 페이지 유형, 우선순위 목록
5	내러티브 및 콘텐츠 프레임워크	`stages/05-content-framework.md`	필러 페이지, 4가지 콘텐츠 레이어, 필러 맵
6	사이트 구조	`stages/06-site-structure.md`	허브, URL, 브레드크럼, 내부 링크 규칙, 사이트맵
7	페이지 디자인 및 핸드오프 키트	`stages/07-page-design.md`	유형별 페이지 구조, CMS 요구사항, 개발 및 디자인 브리프
8	프로덕션	`stages/08-production.md`	콘텐츠 시트, 작성 규칙, QA, 테스트 배치
9	퍼블리싱	`stages/09-publishing.md`	사용 중인 플랫폼을 위한 시트-투-CMS 파이프라인
10	라이브 전환 및 색인 생성	`stages/10-go-live.md`	론칭 체크리스트, 릴리스 페이싱, 색인 요청
11	측정 및 유지보수	`stages/11-measure.md`	추적, 리드 어트리뷰션, 보고, 정리 주기

9단계를 위한 플랫폼 가이드는 cms/에 있습니다(visual-builders.md, headless.md, wordpress.md, custom.md). 사이트에 해당하는 가이드만 읽으세요.

모든 단계에 적용되는 기본 규칙

다음은 실제 프로젝트에서 잘못되거나 잘된 점에서 비롯된 규칙입니다. 적용할 때 이유를 설명하여 사용자가 규칙뿐만 아니라 원칙도 배울 수 있도록 하세요.

모든 페이지는 검색 엔진 없이도 존재할 가치가 있어야 합니다. 어떤 페이지 유형이 승인되기 전에 각 페이지의 고유한 점(고유 데이터, 실제 사례 연구, 작동하는 도구, 특정 워크플로우)을 명명하세요. 정직한 대답이 "키워드만 바뀐다"라면, 해당 페이지 유형은 준비되지 않은 것입니다. Google의 대량 콘텐츠 남용 정책은 AI, 템플릿 또는 사람이 작성했든 주로 순위를 매기기 위해 만들어진 페이지를 대상으로 합니다.
사실은 세 곳에서만 나옵니다: 회사가 이미 보유한 사실(사례 연구, 제품 문서, 자체 데이터), 해당 사실에 대한 산술, 또는 인용된 공개 출처. 템플릿을 채우기 위해 수치, 고객, 인용문 또는 결과를 절대 만들어내지 마세요.
모든 페이지에 하나의 템플릿을 사용하는 것은 주요 실패 패턴입니다. 페이지 유형과 의도에 따라 다른 레이아웃을 사용하고, 섹션 순서와 구성 요소를 다양화하여 페이지가 대량 생산된 것처럼 보이지 않게 하세요.
프로그래매틱 페이지는 핵심 페이지를 지원하며 경쟁하지 않습니다. 제품 및 서비스 페이지를 중심으로 구축하고, 절대 주요 키워드에 대해 경쟁하지 마세요.
확장하기 전에 소규모로 테스트하세요. 약 5~10페이지 분량의 배치를 게시하고, 색인을 요청한 후, 방법을 수백 페이지에 적용하기 전에 최소 2주를 기다리세요.
모든 변경 사항을 날짜와 함께 기록하세요(templates/change-log.csv). 여러 수정 사항이 동시에 적용될 때, 로그만이 어떤 것이 효과가 있었는지 알 수 있는 유일한 방법입니다.
무엇이든 삭제하거나 리디렉션하기 전에 리드와 백링크를 확인하세요. 검색 수치만으로는 실제 고객을 데려온 페이지를 숨길 수 있습니다.
브레드크럼, 스키마 및 사이트맵은 CMS가 필드에서 생성하며, 페이지마다 수동으로 입력하지 않습니다.
핸드오프는 참조가 포함된 요청입니다. 개발자와 디자이너는 작업당 하나의 통합되고 명확하게 작성된 브리프와 함께 참고할 예시 페이지를 받습니다.
AI 검색 가시성은 먼저 접근 권한이 필요합니다. 콘텐츠 탓으로 돌리기 전에 AI 크롤러가 차단되지 않았는지 확인하세요(1단계).

스크립트

모든 스크립트는 scripts/에 있으며, Python 3으로 실행되고, 평이한 언어 요약을 출력합니다. 업로드된 내보내기 파일을 기반으로 작동하므로 사용자는 코드를 직접 다룰 필요가 없습니다: 파일을 요청하고, 스크립트를 실행하고, 출력을 공유하세요. --help와 함께 스크립트를 실행하여 옵션을 확인하세요.

스크립트	단계	입력	출력
`url_grouper.py`	2	사이트맵 XML 또는 URL 목록	폴더 및 슬러그 패턴별로 그룹화된 URL
`gsc_triage.py`	3	Search Console 페이지 내보내기 (+ 선택적 색인 목록, 리드, 백링크)	이유가 포함된 유지/재작업/리디렉션/삭제 시트
`near_duplicates.py`	3, 8	저장된 HTML 페이지, 텍스트 CSV, 또는 가져올 URL	거의 중복된 쌍 및 클러스터
`internal_links.py`	6, 10	크롤러 인링크 내보내기 또는 저장된 HTML	페이지별 인바운드 링크 수, 고아 페이지 목록
`sitemap_builder.py`	6	url, section, lastmod CSV	사이트맵 인덱스, 섹션별 XML 사이트맵 1개, HTML 사이트맵
`sheet_qa.py`	8	콘텐츠 시트 CSV	행별 QA 보고서
`launch_checker.py`	10	가져올 URL 또는 저장된 HTML	페이지별 론칭 통과/실패 보고서

라이브 URL 가져오기에는 열린 인터넷이 필요합니다. Claude.ai 채팅 샌드박스에서는 아웃바운드 접근이 제한되므로 업로드된 파일을 사용하고, Claude Code 또는 Cowork에서 가져오기 모드를 실행하세요.

템플릿 및 라이브러리

templates/: 프로젝트 브리프, 변경 로그, 분류 시트 열, 필러 맵, 콘텐츠 시트, CMS 요구사항 체크리스트, 개발자 브리프, 디자이너 브리프, 론칭 체크리스트, 월간 보고서 개요.
library/page-types.md: 의도, URL, 브레드크럼, 섹션 및 고유성 출처를 포함한 페이지 유형 카탈로그.
library/reference-gallery.md: 개발자와 디자이너에게 보여줄 실제 프로그래매틱 페이지 예시와 함께 지적할 점 및 소규모 회사가 따라할 수 있는 부분에 대한 메모.
library/troubleshooting.md: 증상, 가능한 원인, 확인 방법, 수정 방법.
library/field-notes.md: 익명화된 프로젝트 증거, 검증된 것과 테스트 중인 것.

출력 스타일

짧은 요약 후 산출물. 페이지 목록은 시트로, 사람을 위한 브리프는 일반 텍스트로, 옵션 비교 시에만 표를 사용하세요. 전문 용어를 피하고, 기술 용어가 불가피한 경우 한 줄로 정의하세요.

프로그래매틱 SEO 플레이북