콘텐츠 브리프 팩토리 — 작성자가 실제로 필요로 하는 브리프 — Claude Skill

콘텐츠 브리프 팩토리

대부분의 콘텐츠 브리프는 쓸모없습니다. "이 키워드를 7번 언급하라"고 말하고 그것을 전략이라고 부릅니다. 이 스킬은 경쟁 분석, 실제 고객이 말하는 방식에서 채굴한 고유 각도, SERP 기능 타깃팅, 차별화된 개요가 포함된 브리프를 만듭니다. 그래서 작성자는 무엇을 만들어야 하는지, 왜 그것이 순위에 오를 수 있는지 정확히 압니다.

핵심 원칙: 훌륭한 브리프는 단지 "X에 대해 쓰라"고 말하지 않습니다. "이미 순위에 오른 것은 이것이고, 그것이 이기는 이유는 이것이며, 그들이 놓친 격차는 이것이고, 그 격차가 중요하다는 고객 언어는 이것이며, 그들을 이기는 페이지를 정확히 이렇게 구성하라"고 말합니다.

배치 모드: 한 번 실행으로 10-50개 키워드를 처리합니다. 각 브리프는 강화 모드에서 약 30초, 기본 모드에서 약 60초가 걸립니다.

사용 시점

• "이 키워드들에 대한 콘텐츠 브리프를 만들어줘"
• "2분기 콘텐츠 캘린더용 브리프가 필요해"
• "프로그래매틱 SEO 템플릿용 브리프를 작성해줘"
• "이 키워드 목록에서 브리프 20개를 생성해줘"
• "[주제]에 대해 무엇을 써야 할까? 전체 브리프를 줘."

도구 보강(선택)

브리프는 추정 분석보다 실제 SERP 데이터(실제로 순위에 오른 것, 표시되는 SERP 기능)를 사용할 때 훨씬 좋아집니다.

사용자에게 보여줄 에이전트 프롬프트

"경쟁 조사와 고객 언어 채굴을 사용해 강력한 콘텐츠 브리프를 만들 수 있습니다. 최상의 결과, 특히 정확한 SERP 분석과 키워드 지표를 원한다면 SERP 데이터 API 연결을 권장합니다."

권장: SerpAPI(월 100회 무료 검색, 5,000회는 월 $50)

• serpapi.com에서 가입 → API 키 받기
• SERPAPI_KEY 환경 변수 설정

함께 사용할 수 있는 대안:

• Serper.dev(2,500회 무료 검색, 이후 50K에 월 $50) → SERPER_API_KEY 설정
• DataForSEO SERP(사용량 기반, 검색당 약 $0.01) → DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD 설정
• ValueSERP(무료 등급 제공) → VALUESERP_API_KEY 설정

"이 중 하나를 사용할까요, 아니면 기본 모드로 진행할까요? 기본 모드는 웹 검색으로 경쟁 페이지를 분석합니다. 여전히 훌륭한 브리프를 만들지만 SERP 기능과 검색량 데이터의 정확도는 낮습니다."

모드 선택

• 강화 모드 — 키워드별 실제 SERP 데이터: 정확한 순위 페이지, 표시되는 SERP 기능(추천 스니펫, 관련 질문, 동영상 캐러셀), 검색량, 키워드 난이도. 브리프에는 구체적인 "이 SERP 기능을 차지하라" 타깃팅이 포함됩니다.
• 기본 모드 — web_search로 상위 노출 페이지를 식별하고 seo-domain-analyzer로 도메인 지표를 봅니다. SERP 기능 감지는 추정입니다. 그래도 훌륭한 브리프를 생성합니다. 경쟁 분석과 고객 언어 구성 요소는 SERP API가 없어도 됩니다.

0단계: 접수

1. 키워드 — 대상 키워드 목록(1-50개). 다음 형태가 가능합니다:
   • 붙여넣은 목록
   • CSV 파일
   • seo-opportunity-finder 또는 search-ad-keyword-architect의 출력
   • programmatic-seo-planner의 출력(템플릿 키워드)
2. 자사 사이트 URL — 기존 커버리지를 확인하기 위함
3. 이상 고객 프로필 — 이 콘텐츠를 누가 읽나요? (역할, 고통, 목표)
4. 브랜드 보이스 — 격식 있는/캐주얼한/기술적인 톤? (또는 브랜드 보이스 문서 링크)
5. 콘텐츠 유형 선호 — 블로그 글, 랜딩 페이지, 가이드, 용어집 항목?
6. 브리프 깊이 — 표준(개요 + 각도 + 경쟁사) 또는 심층(위 모든 항목 + 고객 인용 + SERP 기능 타깃팅 + 내부 링크)?
7. 도구 선호 — SERP API를 쓰는 강화 모드 또는 기본 모드? (위의 도구 보강 참고)

1단계: 기존 커버리지 확인

자사 사이트에서 site-content-catalog를 실행합니다:

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

각 대상 키워드에 대해 확인합니다:

• 이미 이 키워드를 타깃팅하는 페이지가 있나요? → 업데이트 브리프(새 페이지가 아님)
• 이 페이지로 링크해야 하는 관련 페이지가 있나요? → 내부 링크 후보
• 어떤 콘텐츠 격차가 있나요? → 이 키워드를 타깃팅할 가치가 있는지 확인

2단계: 키워드별 분석(배치)

각 키워드에 대해 가능한 경우 병렬로 실행합니다:

2A: SERP 분석

강화 모드(SerpAPI / Serper / DataForSEO):

# SerpAPI 예시
GET https://serpapi.com/search?q={keyword}&api_key={key}&num=10

키워드별로 추출합니다:

• 상위 10개 순위 URL
• 표시되는 SERP 기능(추천 스니펫, 관련 질문, 동영상, 지식 패널, 이미지)
• 추천 스니펫 보유자(있는 경우) + 스니펫 내용
• 관련 질문 상위 5개
• 관련 검색어
• 검색량 + 키워드 난이도(API에서 제공되는 경우)

기본 모드:

각 키워드에 web_search를 사용합니다:

• 상위 5-10개 결과 기록
• 결과 형식에서 명확한 SERP 기능 식별
• 검색량/난이도 추정에 seo-domain-analyzer 사용

2B: 경쟁 페이지 분석

키워드별 상위 3-5개 순위 페이지를 fetch_webpage로 가져옵니다:

각 페이지를 분석합니다:

• 단어 수 — 순위 페이지의 길이는 어느 정도인가?
• 구조 — H1, H2 개요, 콘텐츠 흐름
• 콘텐츠 유형 — 방법론, 리스트형 글, 비교, 가이드, 정의
• 고유 데이터 — 자체 조사, 설문, 스크린샷이 포함되어 있는가?
• 최신성 — 마지막 업데이트가 언제였는가?
• 깊이 점수 — 얕은 개요인가, 포괄적 자료인가?
• 누락 주제 — 다뤄야 했지만 다루지 않은 것은 무엇인가?

2C: 고객 언어 채굴

해당 주제에 대해 review-scraper + reddit-scraper를 실행합니다:

# 리뷰 — 이상 고객이 이 문제를 어떻게 말하는지 찾기
python3 skills/review-scraper/scripts/scrape_reviews.py \
  --product "<relevant_product>" \
  --platforms g2,capterra \
  --output json

# Reddit — 실제 질문과 고통 언어 찾기
python3 skills/reddit-scraper/scripts/scrape_reddit.py \
  --query "<keyword/topic>" \
  --subreddits "<relevant_subs>" \
  --sort relevance --time year --limit 30

추출합니다:

• 이 주제에 대해 사람들이 실제로 묻는 질문 → 포함할 섹션
• 고통 언어 → 도입부 후킹 각도
• 오해 → 통념 반박 섹션 기회
• 구체적 사용 사례 → 포함할 실제 예시
• 인용문 → 콘텐츠에 엮어 넣을 증거

3단계: 브리프 생성

각 키워드에 대해 다음을 생성합니다:

# 콘텐츠 브리프: [대상 키워드]

## 메타데이터
- **대상 키워드:** [주요 키워드]
- **보조 키워드:** [자연스럽게 포함할 관련 키워드 2-5개]
- **검색량:** [월간, 제공되는 경우] | **난이도:** [점수, 제공되는 경우]
- **콘텐츠 유형:** [블로그 글 / 가이드 / 비교 / 용어집 / 랜딩 페이지]
- **목표 단어 수:** [X-Y단어] (경쟁 페이지 기준)
- **우선순위:** [P0/P1/P2]

---

## 검색 지형

### 현재 순위에 오른 페이지
| # | 페이지 | 도메인 | 유형 | 단어 수 | 강점 | 약점 |
|---|------|--------|------|-------|-----------|------------|
| 1 | [제목] | [도메인] | [유형] | [수] | [잘하는 점] | [놓치는 점] |
| 2 | ... | | | | | |
| 3 | ... | | | | | |

### 표시되는 SERP 기능
- 추천 스니펫: [예/아니요 — 현재 보유자 + 내용]
- 관련 질문: [PAA 질문 목록]
- 동영상 캐러셀: [예/아니요]
- 이미지: [예/아니요]
- 지식 패널: [예/아니요]

### SERP 기능 목표
- [ ] **추천 스니펫 획득** — H2 "[제목]" 아래에 [형식]으로 답변 구성
- [ ] **PAA 질문 답변** — 다음을 다루는 섹션 포함: [목록]
- [ ] **이미지 팩** — [이미지/다이어그램 유형] 포함

---

## 차별화 각도

**기존 콘텐츠의 격차:** [순위 페이지 전체가 놓치거나 약하게 다루는 것]

**자사의 고유 각도:** [고객 언어, 제품 포지셔닝, 또는 경쟁사에게 없는 자사 데이터에 기반해 다르게 접근할 방법]

**고객 목소리 증거:**
> "[리뷰/Reddit에서 가져온, 격차를 보여주는 인용문]" — [출처]
> "[또 다른 인용문]" — [출처]

---

## 권장 개요

### 제목 옵션(하나 선택)
1. [제목 옵션 A — SEO 최적화]
2. [제목 옵션 B — 호기심 유도]
3. [제목 옵션 C — 결과 중심]

### 메타 설명
[155자, 키워드 포함, 명확한 가치 제안 포함]

### 콘텐츠 구조

**H1: [정확한 H1]**

**H2: [섹션 1 — 후킹/문제 제기]**
- 다룰 내용: [구체적 지침]
- 길이: [약 X단어]
- 포함: [후킹용 고객 고통 인용]

**H2: [섹션 2 — 핵심 콘텐츠]**
- 다룰 내용: [구체적 지침]
- 길이: [약 X단어]
- 포함: [비교 표 / 단계별 절차 / 프레임워크]

**H2: [섹션 3 — 차별화 각도]**
- 다룰 내용: [경쟁사가 놓친 것]
- 길이: [약 X단어]
- 이것이 자사의 경쟁 우위입니다

**H2: [섹션 4 — 실무 적용]**
- 다룰 내용: [구체적 예시, 사용 사례]
- 포함: [스크린샷, 템플릿 또는 데이터]

**H2: [섹션 5 — FAQ / PAA 답변]**
- [PAA 질문 1] — [짧은 답변 지침]
- [PAA 질문 2] — [짧은 답변 지침]
- [PAA 질문 3] — [짧은 답변 지침]

**H2: [섹션 6 — CTA / 다음 단계]**
- 다룰 내용: [자사 제품으로 자연스럽게 이어지는 전환]

---

## 내부 링크 계획
- **이 페이지에서 링크할 대상:** [관련 기존 페이지]
- **이 페이지로 링크할 출처:** [이 페이지를 언급해야 하는 기존 페이지]
- **앵커 텍스트 제안:** [각 링크별 구체적 앵커 텍스트]

---

## 콘텐츠 요구 사항
- [ ] 최소 [N]개의 자체 예시/스크린샷 포함
- [ ] 고객 언어 사용: "[본문에 반영할 구체적 표현]"
- [ ] 구조화 데이터 포함: [FAQ 스키마 / HowTo 스키마 / 기타]
- [ ] 최신성 신호를 위해 마지막 업데이트 날짜 추가
- [ ] 목표 가독성: [학년 수준 / 읽는 시간]

---

## 경쟁 우위 체크리스트
- [ ] 상위 3개 페이지가 다루는 모든 내용을 포함
- [ ] 그들이 모두 놓친 [고유 각도] 추가
- [ ] 일반적인 마케팅 문구가 아니라 실제 고객 언어 사용
- [ ] 최적화된 형식으로 [SERP 기능] 타깃팅
- [ ] 경쟁사보다 강한 내부 링크 구성
- [ ] 경쟁사에 없는 자체 [데이터/이미지/템플릿] 포함

4단계: 배치 출력

배치 실행(10개 이상 브리프)의 경우:

# 콘텐츠 브리프 배치 — [제품/고객] — [날짜]

## 요약
- 생성된 브리프: [N]
- 전체 대상 검색량: 월 [X]
- 콘텐츠 유형: 블로그 글 [N]개, 가이드 [N]개, 비교 [N]개 등

## 우선순위 순서
| # | 키워드 | 검색량 | 난이도 | 콘텐츠 유형 | 고유 각도 | 상태 |
|---|---------|--------|-----------|-------------|-------------|--------|
| 1 | [키워드] | [검색량] | [난이도] | [유형] | [각도 요약] | 준비 완료 |
| 2 | [키워드] | [검색량] | [난이도] | [유형] | [각도 요약] | 준비 완료 |
...

## 개별 브리프
[브리프 1]
---
[브리프 2]
---
...

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

배치 모드에서는 요약 CSV도 내보냅니다: clients/<client-name>/content/briefs/brief-summary-[YYYY-MM-DD].csv

비용

필요한 도구

• Apify API 토큰 — APIFY_API_TOKEN 환경 변수
• 상위 스킬: site-content-catalog, seo-domain-analyzer, review-scraper, reddit-scraper, fetch_webpage
• 선택(강화 모드): SerpAPI(SERPAPI_KEY), Serper.dev(SERPER_API_KEY), DataForSEO(DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD) 또는 ValueSERP(VALUESERP_API_KEY)

일정 운영

지속적인 콘텐츠 운영에서는 매주 실행합니다:

• 입력: seo-opportunity-finder 또는 콘텐츠 캘린더의 키워드
• 출력: 작성팀을 위한 최신 브리프
• 일정: 편집 기획 전 월요일 아침

트리거 문구

• "이 키워드들에 대한 콘텐츠 브리프를 만들어줘"
• "[키워드]에 대해 브리핑해줘"
• "콘텐츠 브리프 20개를 생성해줘"
• "[주제]에 대해 무엇을 써야 할까?"
• "우리 콘텐츠 캘린더용 브리프를 만들어줘"
• "이 키워드들을 배치로 브리핑해줘"