프로그래매틱 SEO 플래너 — pSEO 청사진 설계 — Claude Skill

프로그래매틱 SEO 페이지 플래너

프로그래매틱 SEO는 스타트업이 템플릿으로 높은 의도의 페이지 수백 개를 만드는 방식입니다. 예: "{Your Product} vs {Competitor}", "Best {Category} for {Industry}", "{Integration} + {Your Product}". 이 스킬은 어떤 패턴을 구축할 가치가 있는지 판단하고, 템플릿을 설계하고, 구축 우선순위를 정합니다.

핵심 원칙: pSEO는 콘텐츠를 대량 회전시키는 일이 아닙니다. 페이지마다 달라지는 데이터 축을 찾고, 각 변형에 실제 검색 수요가 있으며 제품이 진짜 답을 갖고 있는지 확인하는 일입니다. 이 스킬은 구축에 투자하기 전에 두 가지를 모두 검증합니다.

사용 시점

• "각 페이지를 수동으로 쓰지 않고 SEO 페이지를 어떻게 확장할까?"
• "vs/ 비교 페이지를 만들어야 할까?"
• "SaaS에 어떤 프로그래매틱 SEO 패턴이 효과적일까?"
• "수백 개 long-tail 키워드에서 어떻게 순위를 잡을까?"
• "pSEO 전략을 계획해줘"

도구 강화(선택)

이 스킬은 기존 기능만으로도 작동하지만, 수백 개 long-tail 변형의 대량 검색량 조회를 위한 키워드 데이터 API와 함께 쓰면 훨씬 더 좋은 결과를 냅니다.

사용자에게 보낼 에이전트 프롬프트

"기존 도구로 프로그래매틱 SEO 전략을 계획할 수 있습니다. 다만 최상의 결과, 특히 수백 개 키워드 변형에 대한 정확한 검색량 데이터가 필요하다면 키워드 데이터 API 연결을 추천합니다."

추천: DataForSEO (사용량 기반 과금, ~$0.01/keyword, 월 최소 비용 없음)

• dataforseo.com에서 가입 → API login + password 발급
• DATAFORSEO_LOGIN 및 DATAFORSEO_PASSWORD env vars 설정

대안:

• Keywords Everywhere API ($1 per 10 credits = 100K keywords, 매우 저렴) → KEYWORDS_EVERYWHERE_API_KEY 설정
• SEMrush API (구독이 있는 경우) → SEMRUSH_API_KEY 설정
• Ahrefs API (구독이 있는 경우) → AHREFS_API_TOKEN 설정

"이 중 하나를 사용할까요, 아니면 baseline mode로 진행할까요? Baseline도 작동합니다. 상위 수준 데이터에는 Apify 기반 SEO 도구를 사용하지만, 개별 long-tail 패턴의 검색량 추정은 덜 정밀합니다."

모드 선택

• Enhanced mode — DataForSEO / Keywords Everywhere / SEMrush / Ahrefs로 대량 키워드 검색량 조회. 각 패턴 변형의 정확한 월 검색량, 키워드 난이도, CPC를 얻습니다. 우선순위를 자신 있게 정할 수 있습니다.
• Baseline mode — 도메인 수준 지표는 seo-domain-analyzer(Apify), 패턴 검증은 web_search를 사용합니다. 검색량 추정은 방향성만 있고 정확하지 않습니다. 그래도 좋은 청사진은 만들 수 있지만, 변형별 수요 세분성은 낮습니다.

Phase 0: 접수

1. 제품 — URL + 한 문장 설명
2. 카테고리 — 어떤 카테고리/시장에 있나요?
3. 경쟁사 — 경쟁사 URL 3-5개(그들의 pSEO 플레이를 분석)
4. ICP — 누가 제품을 검색하나요? (역할, 산업, 회사 단계)
5. 기존 콘텐츠 — 이미 블로그/리소스 섹션이 있나요? (있다면 URL)
6. CMS/기술 스택 — 사이트를 무엇으로 운영하나요? (Webflow, WordPress, Next.js 등) — 템플릿 실행 가능성 판단에 필요
7. 도구 선호 — 키워드 API가 있는 enhanced mode 또는 baseline? (위 도구 강화 참조)

Phase 1: 패턴 발견

1A: 경쟁사 pSEO 분석

각 경쟁사에 대해 site-content-catalog를 실행합니다.

python3 skills/site-content-catalog/scripts/catalog_site.py \
  --url "<competitor_url>" \
  --output json

프로그래매틱 패턴을 찾기 위해 URL 구조를 분석합니다.

• /vs/, /compare/, /alternatives/ — 비교 페이지
• /integrations/, /connect/, /apps/ — 통합 페이지
• /for-{industry}/, /solutions/, /use-cases/ — 버티컬/사용 사례 페이지
• /templates/, /examples/, /glossary/ — 리소스 페이지
• /tools/, /calculators/, /generators/ — 도구 페이지

발견한 각 패턴에 대해 기록합니다.

• URL 패턴(regex)
• 추정 페이지 수
• 페이지마다 무엇이 달라지는지("데이터 축")
• 샘플 페이지 제목

1B: 시장 패턴 매핑

제품 카테고리를 기준으로 다음 표준 pSEO 패턴 유형을 평가합니다.

1C: 고객 언어 마이닝

ICP가 문제를 어떻게 말하는지 찾기 위해 reddit-scraper를 실행합니다.

python3 skills/reddit-scraper/scripts/scrape_reddit.py \
  --query "<category> OR <problem keyword>" \
  --subreddits "<relevant_subs>" \
  --sort relevance --time year --limit 50

추출할 항목:

• 사람들이 묻는 질문 → 잠재 glossary/guide 패턴
• "How do I [X] with [tool]?" → integration/use-case 패턴
• "Is there a [X] for [industry]?" → 버티컬 페이지 패턴
• 비교 토론 → vs/ 페이지 패턴

1D: 키워드 검색량 검증

Enhanced mode (DataForSEO / Keywords Everywhere / SEMrush / Ahrefs):

각 후보 패턴에 대해 20-50개의 키워드 변형을 생성하고 정확한 검색량을 가져옵니다.

• "your-product vs {competitor1}", "your-product vs {competitor2}" 등
• "best {category} for {industry1}", "best {category} for {industry2}" 등
• "{your-product} {integration1} integration" 등

패턴 유형별로 집계:

• 모든 변형의 월간 총 접근 가능 검색량
• 변형당 평균 검색량
• 검색량 분포(일부 변형만 높은가, 고르게 퍼져 있는가?)
• 평균 키워드 난이도

Baseline mode:

경쟁사 도메인 지표는 seo-domain-analyzer, 핵심 변형에 실제 수요가 있는지 SERP 결과를 spot-check하는 데는 web_search를 사용하고, 다음을 바탕으로 수동 추정합니다.

• 패턴별 경쟁사 페이지 수(페이지가 많을수록 수요가 있을 가능성)
• 패턴 변형에 대한 Google autocomplete 제안
• Reddit/커뮤니티 질문 빈도

Phase 2: 패턴 평가

각 후보 패턴을 다음 기준으로 점수화합니다.

각 패턴을 0-100점으로 점수화하고 순위를 매깁니다.

패턴별 실행 가능성 확인

50점 이상인 각 패턴에 대해 검증합니다.

1. 데이터 출처 — 변수 데이터가 어디에서 오는가?

   • 경쟁사 이름 → 수동 목록(유한, 높은 가치)
   • 통합/도구 이름 → API marketplace, 앱 디렉터리
   • 산업 이름 → 표준 산업 목록
   • 용어/glossary → 키워드 조사 결과
   • 템플릿 → 제품 기능 매트릭스

2. 콘텐츠 차별화 — 각 페이지가 진짜 가치를 줄 수 있는가, 아니면 얇은 페이지가 되는가?

   • vs/ 페이지에는 단순히 "우리가 더 좋다"가 아니라 실제 기능 비교가 필요합니다
   • 통합 페이지에는 실제 설정 가이드나 사용 사례가 필요합니다
   • 버티컬 페이지에는 산업별 고통 지점과 예시가 필요합니다

3. 기술적 실행 가능성 — CMS가 이를 대규모로 생성할 수 있는가?

   • Static site generators (Next.js, Astro) → pSEO에 매우 좋음
   • Webflow CMS → 좋음, collection당 최대 10K items
   • WordPress → custom post types와 함께 좋음
   • 수동 생성 → pSEO가 아니라 많은 페이지를 손으로 만드는 것

Phase 3: 템플릿 설계

구축할 각 패턴에 대해 설계합니다.

템플릿 청사진

## Pattern: [vs/{competitor}]

### URL Structure
/vs/{competitor-slug}

### Title Template
{Your Product} vs {Competitor} — [Year] Comparison | {Your Brand}

### Meta Description Template
Compare {Your Product} and {Competitor} side-by-side. See pricing, features,
pros/cons, and which is better for {ICP description}.

### H1
{Your Product} vs {Competitor}: Honest Comparison

### Page Sections (content framework)
1. **TL;DR** — 핵심 차이를 3문장으로 요약(above fold)
2. **빠른 비교 표** — 체크마크가 있는 기능 매트릭스
3. **상세 비교** — 핵심 차원 4-6개, 각 2-3문단
4. **가격 비교** — 플랜별 분석
5. **누가 {Your Product}를 선택해야 하는가** — ICP 적합도 설명
6. **누가 {Competitor}를 선택해야 하는가** — 공정한 평가
7. **실제 사용자의 말** — 양쪽 리뷰 인용
8. **CTA** — 체험/데모 프롬프트

### Data Required Per Page
- competitor_name: string
- competitor_slug: string
- competitor_features: array (from their website/docs)
- competitor_pricing: object (from pricing page)
- competitor_reviews: array (from G2/Capterra)
- your_differentiators: array (per competitor)

### Content Guidelines
- 페이지당 최소 1,500단어
- 고유 인사이트를 최소 하나 포함해야 함(단순 기능 목록이 아님)
- 가능하면 실제 스크린샷 또는 다이어그램 사용
- 분기별 업데이트(가격/기능 변경)

각 패턴 유형에 대해 반복합니다.

Phase 4: 우선순위 및 로드맵

구현 계획을 만듭니다.

우선순위 매트릭스

추천 구축 순서

Month 1: 빠른 성과

• [pattern A] 구축 — [X] pages, [rationale]
• [pattern B] 구축 — [X] pages, [rationale]

Month 2: 확장

• [pattern C] 구축 — [X] pages, [rationale]
• Month 1 패턴 측정, 템플릿 반복 개선

Month 3: 확대

• [pattern D] 구축 — [X] pages, [rationale]
• 성과 데이터로 Month 1 페이지 업데이트

패턴별 데이터 출처 계획

각 패턴에 대해 변수 데이터가 정확히 어디에서 오는지 명시합니다.

• 수동 큐레이션(경쟁사 목록 — 유한하고 품질 높음)
• API 출처(통합 marketplace)
• 스크래핑(리뷰 사이트, 경쟁사 페이지)
• 내부 데이터(제품 기능, 가격)

Phase 5: 출력

# 프로그래매틱 SEO 청사진 — [Product Name] — [DATE]

## 경영진 요약
- [N]개 패턴 평가, [M]개 구축 추천
- 총 접근 가능 검색량: [X]/month
- 구축할 추정 페이지 수: [Y]
- 추천 구축 일정: [Z]개월

---

## 패턴 분석(우선순위순)

### P0: [Pattern Name]
- URL 구조: [pattern]
- 구축할 페이지: [N]
- 총 월간 검색량: [X]
- 템플릿 청사진: [아래 참조]
- 데이터 출처: [변수 데이터 출처]
- 구축 노력: [Low/Medium/High]
- 예상 순위 확보 시간: [2-4 months / 4-8 months / etc.]

[Phase 3의 전체 템플릿 청사진]

### P1: [Pattern Name]
...

---

## 기술 요구사항
- CMS: [필요한 기능]
- 데이터 파이프라인: [변수 데이터를 가져오는 방식]
- 업데이트 주기: [새로고침 빈도]

---

## 빠른 시작 가이드
1. [pattern]부터 시작 — 가장 낮은 노력, 가장 높은 의도
2. 위 템플릿으로 [N]개 페이지 생성
3. 확장 전 [X]주 동안 모니터링
4. ...

clients/<client-name>/seo/pseo-blueprint-[YYYY-MM-DD].md에 저장합니다.

비용

필요한 도구

• Apify API token — APIFY_API_TOKEN env var
• 상위 스킬: site-content-catalog, seo-domain-analyzer, reddit-scraper
• 선택(enhanced): DataForSEO(DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD), Keywords Everywhere(KEYWORDS_EVERYWHERE_API_KEY), SEMrush(SEMRUSH_API_KEY), Ahrefs(AHREFS_API_TOKEN)

트리거 문구

• "프로그래매틱 SEO 전략을 계획해줘"
• "어떤 pSEO 페이지를 만들어야 할까?"
• "우리 제품의 vs/ 비교 페이지를 설계해줘"
• "수백 개 SEO 페이지로 어떻게 확장할까?"
• "[client]용 pSEO 청사진을 만들어줘"
• "어떤 프로그래매틱 패턴을 써야 할까?"