programmatic-seo

개요

programmatic-seo 스킬로 할 수 있는 일

programmatic-seo 스킬은 템플릿과 구조화된 데이터를 활용해 대규모로 SEO에 최적화된 페이지를 설계하도록 도와줍니다. 모든 페이지를 하나씩 작성하는 대신, 이 스킬을 사용해 "[keyword] + [city]" 페이지, 업종별 랜딩 페이지, 비교 페이지, 연동(Integration) 페이지, 디렉터리, 프로필 페이지 등 반복 가능한 페이지 유형을 기획하면서도 각 페이지마다 고유한 가치를 담을 수 있습니다.

이 스킬은 전략과 구조에 초점을 두며, 글 작성이나 코드 배포를 대신해 주는 도구가 아닙니다. 주요하게 도와주는 부분은 다음과 같습니다:

• 실행 가능한 programmatic SEO 기회를 발굴
• 적합한 플레이북 선택(템플릿, 지역, 비교, 연동, 디렉터리 등)
• 각 페이지가 얇지 않고 실제 가치를 가지도록 데이터 요건 정의
• URL 구조, 내부 링크, 인덱싱 전략 계획
• 검색 성과가 떨어지는 중복 또는 유사 콘텐츠를 피하도록 설계

이 스킬이 적합한 사용자

다음과 같은 경우 programmatic-seo 스킬 사용을 고려하세요:

• SEO 담당자 및 그로스 마케터로서 제품이나 마켓플레이스를 위해 수백~수천 개의 랜딩 페이지를 준비 중인 경우
• 콘텐츠 및 프로덕트 마케터로서 확장성 있고 전환 중심의 콘텐츠(예: "CRM for [industry]" 페이지, "best [category]" 허브, 연동 디렉터리)를 만들고 싶은 경우
• 창업자 및 프로덕트 팀으로서 대규모 콘텐츠 팀 없이 리드 생성용 programmatic SEO를 탐색 중인 경우

단순히 상위 레벨 SEO 전략이나 일반 콘텐츠 기획이 필요하다면 먼저 seo-audit 또는 content-strategy를 사용하는 것이 좋습니다. programmatic-seo는 특히 템플릿 기반, 데이터 중심 랜딩 페이지를 대규모로 만들고자 할 때 적합합니다.

programmatic-seo 스킬이 해결하는 문제

이 스킬은 programmatic SEO에서 자주 발생하는 대표적인 문제들을 해결하도록 설계되었습니다:

• Thin 콘텐츠 리스크 – 각 페이지마다 고유한 가치를 정의하도록 유도해, 템플릿 안에서 도시명이나 업종명만 바꾸는 수준에 그치지 않도록 합니다.
• 무엇을 만들어야 할까? – references/playbooks.md에 정리된 검증된 programmatic SEO 플레이북(템플릿, 지역, 비교, 페르소나, 연동, 디렉터리, 프로필 등)을 활용해, 보유 자산과 타깃 오디언스를 패턴에 맞춰 매칭합니다.
• 이 많은 URL과 링크를 어떻게 구조화하지? – /templates/[type]/, /best/[category]/, /locations/[city]/와 같은 깔끔한 URL 패턴과 내부 링크 전략을 제안합니다.
• 실제로 어떤 데이터가 필요할까? – 각 페이지를 정말 유용하게 만드는 독자적 또는 큐레이션된 데이터가 무엇인지 식별하도록 돕습니다.

주요 목표가 전략이나 고유 데이터 없이 텍스트만 대량 생산하는 것이라면, 이 스킬은 적합하지 않습니다. 이 스킬은 양보다 품질과 실질적 유용성을 우선시하도록 설계되어 있습니다.

핵심 개념과 리포지토리 구조

programmatic-seo 스킬 디렉터리 안에는 다음과 같은 파일들이 포함됩니다:

• SKILL.md – 핵심 플레이북으로, 다음 내용을 담고 있습니다:
  • 비즈니스, 타깃, 전환 목표 등 초기 진단 질문
  • 기회 발굴 및 경쟁 분석을 위한 프롬프트
  • 페이지별 고유 가치, 독자적 데이터 활용 등 핵심 원칙
• references/playbooks.md – 실제 사례 패턴을 담은 "The 12 Programmatic SEO Playbooks":
  • Templates (예: resume templates, invoice templates)
  • Curation (예: "best [category]")
  • Comparisons (예: "Notion vs Asana")
  • Locations, Personas, Integrations, Directory, Profiles 등
• evals/evals.json – CRM for [industry] 페이지, 다수 경쟁사 비교 페이지 등, 일반적인 상황에서 이 스킬이 어떻게 추론하고 답변해야 하는지 보여주는 예시 프롬프트와 기대 동작

이 파일 구조를 이해하면, 이 스킬이 여러분의 programmatic SEO 목표와 맞는지 빠르게 판단하는 데 도움이 됩니다.

사용 방법

설치 및 설정

1. programmatic-seo 스킬 설치

에이전트 환경에 이 스킬을 추가하려면 다음 명령을 실행하세요:

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

이 명령은 coreyhaines31/marketingskills에서 programmatic-seo 설정과 관련 참조 파일들을 가져와 스킬 환경에 추가합니다.

2. 핵심 가이드 파일 검토

설치가 끝나면, 먼저 아래 파일들을 열어 스킬의 동작 방식을 이해하세요:

• SKILL.md – 처음부터 끝까지 정독하는 것을 추천합니다. 여기에는 programmatic SEO 전문가로서 에이전트의 역할과 다음과 같은 내용이 정의되어 있습니다:
  • 프로덕트 마케팅 컨텍스트 확인 방법
  • 비즈니스 및 검색 기회 평가 방식
  • thin 콘텐츠를 피하기 위한 원칙
• references/playbooks.md – 12가지 programmatic SEO 플레이북을 훑어보고, 비즈니스와 잘 맞는 패턴(templates, curation, locations, personas, comparisons, integrations, glossary, directory, profiles 등)을 체크하세요.
• evals/evals.json – "CRM for [industry]" 페이지, 여러 경쟁사 비교 페이지 등 예시 프롬프트를 보면서, 이 스킬이 어떤 방식으로 사고하고 응답해야 하는지 파악하세요.

리포지토리에 .agents/product-marketing-context.md(또는 구 버전에서는 .claude/product-marketing-context.md)가 있다면, 내용이 정확하고 최신인지 반드시 확인하세요. 이 스킬은 추천을 정교하게 만들기 위해 가장 먼저 이 파일을 참고합니다.

새 프로젝트에서 programmatic-seo 실행하기

1. 제품 및 타깃 오디언스 컨텍스트 정리

에이전트에게 programmatic SEO 전략 설계를 요청하기 전에, 다음 내용을 정리해 두면 좋습니다:

• 제품/서비스에 대한 간단한 설명
• 주요 타깃 오디언스 또는 세그먼트
• 핵심 전환 목표(체험 신청, 데모 요청, 구매, 뉴스레터 구독 등)

이 입력값들은 SKILL.md에서 정의된 방식대로 사용되어, 천편일률적인 페이지 템플릿이 아니라 실제 퍼널에 맞춘 아이디어를 제안하도록 돕습니다.

2. programmatic SEO 기회 정의

명확한 확장 패턴이 있을 때 이 스킬을 호출하는 것이 좋습니다. 예를 들어:

• "20개 업종에 대해 'CRM for [industry]' 페이지를 만들고 싶다."
• "15개 경쟁사에 대해 '[Our product] vs [Competitor]' 비교 페이지를 만들고 싶다."
• "'[service] providers in [city]' 형식의 디렉터리를 만들고 싶다."
• "'invoice template', 'quote template' 같은 템플릿 페이지를 대규모로 만들고 싶다."

이 경우 스킬은 다음을 수행합니다:

• 어떤 플레이북(Personas, Comparisons, Locations, Templates, Directory 등)에 해당하는지 식별
• 부족한 컨텍스트가 있다면 추가 질문 제시
• 키워드 패턴, 데이터 요구사항, 템플릿 섹션, 내부 링크 구조, 인덱싱 접근법을 포함한 구조화된 계획 제안

3. 플레이북 선택 및 정교화

references/playbooks.md를 바탕으로 이 스킬은 다음을 수행할 수 있습니다:

• 아이디어에 맞는 하나 이상의 플레이북을 선택
• 특정 패턴이 해당 니치에 적합한 이유 설명
• 각 패턴에 필요한 가치 요소 정리(예: Templates의 경우 실제로 활용 가능한 다운로드, 다수의 변형, 높은 품질 등 / Curation의 경우 명확한 평가 기준과 정기 업데이트 등)

그 후 방향성을 다음과 같이 다듬을 수 있습니다:

• 단순 "Locations"에서 Locations + Directory 조합으로 확장(예: 도시별 서비스 제공업체 디렉터리)
• Comparisons + Conversions를 결합(예: 강력한 CTA로 체험 신청을 유도하는 비교 페이지)

4. 데이터 및 콘텐츠 구조 설계

programmatic-seo의 핵심 목표 중 하나는 페이지별 고유 가치 확보입니다. 이를 위해 스킬은 다음과 같은 작업을 도와줍니다:

• 각 페이지에 대해 수집 또는 생성해야 할 데이터 포인트 정의(예: 업종별 페인 포인트, 도시 단위 통계, 버티컬별 기능 사용 데이터 등)
• 이 데이터 포인트를 템플릿 섹션(히어로, 사회적 증거, 비교 표, FAQ, 지역·세그먼트별 상세 정보 등)에 매핑
• 단순 키워드 치환형 문구가 아닌, 독자적 데이터·실제 사례·큐레이션 인사이트가 어디에 들어가야 하는지 설계

이 단계는 이 스킬을 설치할지 결정하는 데도 중요합니다. programmatic SEO를 시도할 만큼 충분히 구조화된 데이터가 있는지를 판단하는 데 큰 도움을 줍니다.

5. URL 및 내부 링크 전략 수립

references/playbooks.md의 예시를 바탕으로 이 스킬은 다음과 같은 제안을 할 수 있습니다:

• URL 구조 예시:
  • /templates/[type]/ 또는 /templates/[category]/[type]/
  • /best/[category]/
  • /locations/[city]/
  • /integrations/[tool]/
• 내부 링크 패턴:
  • 각 업종 페이지에서 코어 "Industries" 허브로 링크
  • 비교 페이지에서 메인 제품 페이지와 가격 페이지로 연결
  • 디렉터리 상세 페이지와 도시별 페이지를 상호 링크

이 단계에서 미리 설계해 두면, 나중에 대규모 URL 구조를 갈아엎는 비용을 크게 줄일 수 있습니다.

6. eval 시나리오로 검증

evals/evals.json의 예시를 체크리스트처럼 활용하세요:

• 기존 product marketing 컨텍스트를 확인하고 있는가?
• 고유 가치, 독자적 데이터, 깔끔한 URL 등 핵심 원칙을 적용하고 있는가?
• 각 변형별 키워드 리서치와 데이터 수집 계획이 있는가?
• 내부 링크 전략과 thin 콘텐츠에 대한 경고가 포함되어 있는가?

계획이 이 eval 기준을 통과하지 못한다면, 데이터 모델을 재검토하거나 범위를 축소해 각 페이지가 진정한 독립 가치를 갖도록 다시 설계해야 합니다.

이 스킬이 적합한 경우와 그렇지 않은 경우

programmatic-seo 스킬을 사용하는 것이 좋은 경우:

• 동일한 유형의 페이지를 지역, 업종, 연동, 사용 사례, 템플릿, 프로필 등 다양한 변형으로 대규모 확장할 수 있는 패턴이 있는 경우
• 각 변형을 의미 있게 차별화할 수 있는 구조화 데이터에 접근하거나 생성할 수 있는 경우
• 전환 의도가 높은 랜딩 페이지를 위한 전략적 청사진이 필요한 경우

적합하지 않을 수 있는 경우:

• 소수의 단발성 랜딩 페이지만 필요한 경우(일반 랜딩 페이지 스킬 또는 수작업 제작으로도 충분)
• 고유한 데이터나 차별화 포인트 없이, 단순히 "AI가 1,000개의 페이지를 생성해주길" 원하는 경우 – 이 스킬은 이런 접근을 명시적으로 경고하도록 설계되어 있습니다.
• 사이트 전체의 기술 SEO 진단이나 구조적 문제 해결이 주요 목적일 경우(seo-audit 스킬 사용 권장)

자주 묻는 질문(FAQ)

programmatic-seo 스킬의 핵심 목적은 무엇인가요?

programmatic-seo 스킬은 programmatic SEO 프로젝트(템플릿 기반, 데이터 중심의 대규모 랜딩 페이지 세트)를 기획하고 구조화하는 데 초점을 맞추고 있습니다. 검색 순위와 전환 모두를 고려하면서도, thin·저품질 콘텐츠를 최소화하도록 설계되어 있습니다. 자동으로 페이지를 발행하는 도구라기보다는, 전략·데이터 설계·페이지 구조 설계에 중점을 둡니다.

programmatic-seo 스킬은 어떻게 설치하나요?

Skills CLI를 통해 설치할 수 있습니다:

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

그 후 skills/programmatic-seo 디렉터리 안의 SKILL.md, references/playbooks.md, evals/evals.json 파일을 검토해, 이 스킬이 에이전트의 동작을 어떻게 형성하는지 이해하세요.

programmatic-seo로 어떤 유형의 페이지를 설계할 수 있나요?

references/playbooks.md에 있는 플레이북을 활용하면 다음과 같은 패턴에 특히 잘 맞습니다:

• Templates (예: "invoice template", "resume template")
• Curation 리스트(예: "best [category]", "top [number] [tools]")
• Comparisons (예: "[Product] vs [Competitor]")
• Locations (예: "[service] in [city]")
• Personas 또는 업종별 페이지(예: "CRM for [industry]")
• Integrations (예: "[Product] + [Tool]" 페이지)
• Directories 및 Profiles(마켓플레이스, 전문가 디렉터리 등)

이 스킬은 제품과 보유 데이터를 고려해, 위 패턴들을 단독 또는 조합하여 사용하는 방법을 함께 설계해 줍니다.

이 스킬은 programmatic SEO에서 thin 콘텐츠를 어떻게 방지하나요?

SKILL.md에서는 특히 각 페이지의 고유 가치를 강조합니다. 독자적 데이터, 실제 사례, 의미 있는 큐레이션 등으로 차별화해야 한다는 원칙이 명시되어 있으며, evals/evals.json에서는 다음을 기준으로 스킬을 평가합니다:

• 각 페이지를 차별화할 데이터 요구사항을 제대로 식별하는지
• 템플릿 안에서 키워드나 도시명만 바꾸는 방식에 대해 경고하는지
• 명확한 목적을 가진 URL 구조와 내부 링크 구조를 장려하는지

계획이 이 기준을 충족하지 못하면, 범위를 줄이거나 데이터를 강화하라는 방향으로 스킬이 재조정을 유도합니다.

이미 저성과 페이지가 많은 사이트에도 programmatic-seo를 사용할 수 있나요?

가능합니다. 다만 이 스킬은 기술적 이슈 진단보다는 구조화된 페이지 유형의 설계·재설계에 초점을 맞추고 있습니다. 예를 들어 다음과 같이 활용할 수 있습니다:

• 기존 지역 페이지, 업종 페이지 등 반복 패턴을 플레이북 기준으로 재검토
• 각 템플릿과 데이터 요구사항을 다시 정의해, 페이지별 가치를 높이도록 리스펙(re-spec)

크롤링 문제, 인덱싱 이슈, 전체 사이트 건강 상태 점검 등이 필요하다면, seo-audit 스킬과 함께 사용하는 것이 좋습니다.

programmatic-seo는 일반적인 콘텐츠 전략 스킬과 무엇이 다른가요?

content-strategy는 주로 전체적인 에디토리얼 전략(주제, 포맷, 콘텐츠 캘린더 등)에 집중합니다. 반면 programmatic-seo는 디렉터리, 비교 페이지, 지역 페이지 등 반복 가능한 데이터 기반 템플릿과 이를 대규모로 운영하기 위한 시스템 설계에 특화되어 있습니다. 즉, "이번 분기에 무엇을 블로그에 쓸까?"보다는 "실제로 유용한 SEO 랜딩 페이지를 수백 개 만들려면 어떻게 설계해야 할까?"가 핵심 질문일 때 programmatic-seo를 선택하는 것이 적합합니다.

programmatic-seo를 제대로 활용하려면 무엇을 준비해야 하나요?

다음 요소들이 어느 정도 갖춰져 있을 때 이 스킬의 효과를 최대화할 수 있습니다:

• 명확한 제품 정의와 타깃 오디언스
• 반복 가능한 페이지 패턴(예: 업종, 도시, 경쟁사, 템플릿 등) 최소 1개 이상
• 구조화된 데이터(또는 이를 수집할 수 있는 능력) – 내부 지표, 마켓플레이스 리스트, 큐레이션 리스트, 리서치 데이터 등

이 요소들이 아직 충분하지 않더라도, 스킬을 설치해 어떤 부분이 부족한지 파악하는 데 활용할 수 있습니다. 다만, 본격적인 programmatic SEO 구축을 실행하기 전에는 추가 작업이 필요할 수 있습니다.