Reddit Researcher

Reddit Researcher — 시장 조사 + 리드 스코어링

Reddit 공개 데이터를 수집하여 잠재 고객을 찾고, 리드를 스코어링하고, Pain Point를 분류합니다. WebSearch와 WebFetch만으로 동작하며, 별도 API 키가 필요 없습니다.

적용 시점

• /reddit-researcher 명시적 실행
• "시장 조사해줘", "Reddit에서 고객 찾아줘", "수요 조사" 요청 시

Setup (최초 1회)

이 스킬은 config.json에 설정이 필요합니다.

1. config.json을 읽는다 (skills/reddit-researcher/config.json 또는 현재 CLI의 글로벌 스킬 경로)
2. 빈 필드가 있으면 현재 CLI의 질문 방식으로 사용자에게 질문한다
3. 답변을 config.json에 저장한다
4. 이후 실행 시에는 config.json에서 자동으로 읽는다

Setup 로직:

config.json 읽기
  ├─ target_subreddits 비어있음? → "기본으로 조사할 서브레딧을 입력해주세요 (쉼표 구분, 예: SaaS,startups,webdev)"
  │                                 → 입력 없으면 기본값(r/SaaS, r/startups 등) 사용
  ├─ keywords 비어있음? → "기본 검색 키워드를 입력해주세요 (쉼표 구분, 건너뛰려면 Enter)"
  ├─ language 확인 → "리포트 언어를 선택해주세요 (ko / en, 기본값: en)"
  └─ 답변 수집 후 config.json에 저장 → 이후 자동 사용

config.json 값은 Step 1에서 사용자 입력의 기본값으로 사용됩니다. 사용자는 실행 시 항상 덮어쓸 수 있습니다.

Step 1: 사용자 입력 수집

필수 입력

사용자에게 아래를 질문합니다. 이미 제공된 정보는 다시 묻지 않습니다.

1. 타겟 키워드 (쉼표 구분)

예: "SaaS boilerplate, starter kit, landing page template"

2. 서브레딧 목록 (기본값 제공, 사용자가 추가/변경 가능)

기본값:
  r/SaaS, r/startups, r/Entrepreneur, r/webdev,
  r/nextjs, r/reactjs, r/indiehackers, r/microsaas,
  r/smallbusiness, r/nocode

3. ICP (Ideal Customer Profile)

예: "비개발자 창업자, 1-5인 팀, MVP 빠르게 런칭하고 싶은 사람"

선택 입력

Step 2: 데이터 수집

수집 방법 (우선순위 순)

2026-07 기준: Reddit .json 엔드포인트(www/old/api.reddit.com 모두)는 비로그인 CLI 요청에 대부분 403을 반환합니다 (브라우저 User-Agent를 붙여도 차단). 반면 old.reddit.com HTML 페이지는 정상(200) 응답합니다. JSON API는 프로브 1회만 시도하고, 차단이면 즉시 HTML 경로로 전환하세요. 요청마다 재시도하면 대기 시간이 누적되어 스킬이 멈춘 것처럼 보입니다.

방법 0: 차단 프로브 (필수, 최초 1회)

수집 시작 전 JSON API에 딱 1회 테스트 요청:

https://www.reddit.com/r/{첫 subreddit}/search.json?q={첫 keyword}&restrict_sr=1&limit=1

• 200 → 방법 1 (JSON API) 사용
• 403/429/기타 실패 → 이번 실행 전체에서 JSON API를 건너뛰고 방법 2로 전환 (요청별 재시도 금지)

방법 1: Reddit JSON API (프로브 통과 시에만)

URL: https://www.reddit.com/r/{subreddit}/search.json?q={keyword}&restrict_sr=1&sort=relevance&t=month&limit=25

WebFetch로 호출하여 JSON 파싱. 응답 구조:

{
  "data": {
    "children": [
      {
        "data": {
          "title": "포스트 제목",
          "selftext": "본문",
          "subreddit": "서브레딧",
          "author": "작성자",
          "created_utc": 1234567890,
          "ups": 42,
          "num_comments": 15,
          "permalink": "/r/sub/comments/..."
        }
      }
    ]
  }
}

방법 2: old.reddit.com HTML 검색 (기본 경로, 2026-07 동작 검증)

URL: https://old.reddit.com/r/{subreddit}/search?q={keyword}&restrict_sr=1&sort=relevance&t=month

WebFetch로 호출하여 HTML에서 추출. 검색 결과 1건당 아래 마커가 포함됩니다:

• 페이지네이션: 결과 하단 next 링크의 after= 파라미터 (25건 단위)
• 본문(selftext)은 검색 결과 페이지에 없음 → 필터 통과 + 예비 점수 상위 후보만 permalink를 old.reddit.com 도메인으로 WebFetch하여 본문 확보 (전건 fetch 금지, 호출 수 절약)

방법 3: 검색 엔진 폴백 (HTML까지 차단된 경우)

Tavily MCP(mcp__tavily__*)가 연결되어 있으면 우선 사용하고, 없으면 WebSearch:

site:reddit.com/r/{subreddit} "{keyword}"

이 경로는 upvote/댓글 수를 얻지 못하는 경우가 많습니다 → Step 3의 데이터 결측 규칙으로 스코어링을 보정합니다.

Rate Limiting 규칙

• 각 WebFetch 호출 사이 최소 2초 대기
• Fast-fail: 같은 방법에서 403/429가 2회 연속 발생 → 그 방법은 이번 실행에서 포기하고 다음 방법으로 전환 (요청별 10초 대기 재시도 금지 — 대기 누적으로 실행이 멈춘 것처럼 보이는 원인)
• 총 API 호출 100회 초과 시 수집 중단

수집 데이터 포인트

Step 3: 리드 스코어링

수집된 각 포스트에 대해 10점 만점으로 스코어링합니다.

스코어링 기준

ICP 적합도 세부 기준 (0~4점)

4점: ICP 완벽 매칭 + 구매 의사 표현 ("돈 내고라도", "유료 서비스 추천")
3점: ICP 매칭 + 명확한 니즈 표현 ("~하는 도구 있나요?", "~가 필요합니다")
2점: ICP 부분 매칭 + 관련 토론 참여
1점: 관련 주제 언급만
0점: ICP 미해당 또는 무관

긴급도 신호 키워드

높음 (2점): "urgent", "ASAP", "today", "this week", "급하게", "지금 당장"
중간 (1점): "soon", "looking for", "need", "찾고 있습니다", "필요합니다"
낮음 (0점): 단순 토론, 비교, 일반 질문

참여도 기준

2점: upvote ≥ 20 또는 댓글 ≥ 10
1점: upvote ≥ 5 또는 댓글 ≥ 3
0점: 그 외

데이터 결측 시 (검색 엔진 폴백 경로): upvote/댓글 수를 얻지 못한 포스트는 참여도 항목을 제외하고, (획득 점수 / 8) × 10을 반올림하여 10점 스케일로 정규화합니다. 리포트에 결측 여부를 표기합니다.

Step 4: 거짓 양성 필터링

아래 패턴에 해당하면 자동 제외합니다:

Step 5: Pain Point 분류

필터링 통과한 포스트들에서 Pain Point를 추출하고 분류합니다:

Step 6: 경쟁사 분석 (선택)

사용자가 경쟁사 이름을 제공한 경우:

• 각 경쟁사 이름이 언급된 포스트 추적
• 언급 맥락 분류: 추천 / 불만 / 비교 / 대안 요청
• 경쟁사별 sentiment 요약 (긍정/부정/중립)

Step 7: 리포트 출력

7-1. CSV 데이터 파일

docs/reddit-research/leads-{날짜}.csv에 저장:

score,title,subreddit,author,ups,comments,date,url,pain_points,icp_match
8,"Need a SaaS boilerplate urgently",SaaS,u/founder123,42,15,2026-03-10,https://reddit.com/...,가격;복잡성,높음
6,"Looking for starter kit recommendations",startups,u/indie_dev,12,8,2026-03-08,https://reddit.com/...,기능부재,중간

7-2. 마크다운 요약 리포트

docs/reddit-research/report-{날짜}.md에 저장:

# Reddit 시장 조사 리포트

**조사일**: {날짜}
**키워드**: {키워드 목록}
**서브레딧**: {서브레딧 목록}
**수집 포스트**: {N}개 → 필터 후 {N}개

---

## 핫 리드 (8~10점)

| 점수 | 제목 | 서브레딧 | 작성자 | URL |
|------|------|---------|--------|-----|
| 9 | ... | r/SaaS | u/... | [링크](...) |

## 웜 리드 (5~7점)

| 점수 | 제목 | 서브레딧 | 작성자 | URL |
...

## 콜드 리드 (1~4점)

(요약만, 개별 목록 생략)

---

## Pain Point 분석

| 카테고리 | 언급 횟수 | 대표 포스트 |
|---------|---------|-----------|
| 가격 | 12건 | "Too expensive for a solo founder..." |
| 복잡성 | 8건 | "Spent 3 days just setting up auth..." |

## 경쟁사 언급 현황

| 경쟁사 | 언급 | 긍정 | 부정 | 대표 의견 |
|--------|------|------|------|----------|
| CompetitorA | 15건 | 8 | 7 | "Great but too expensive" |

---

## 액션 아이템

1. **즉시 접근 가능**: 핫 리드 {N}건에 DM/댓글로 접근
2. **콘텐츠 기회**: Pain Point "{가장 많은 카테고리}"를 다루는 블로그 포스트 작성
3. **기능 로드맵**: "{요청 많은 기능}" 우선 개발 고려

주의사항

• Reddit API rate limit을 반드시 준수합니다 (요청 간 2초)
• 개인정보(이메일, 연락처)를 수집하지 않습니다
• 공개 포스트만 수집합니다 (비공개 서브레딧 접근 불가)
• .json 엔드포인트는 비로그인 클라이언트에 403이 일반적입니다 → 프로브 1회 후 old.reddit.com HTML 경로 사용
• HTML 경로까지 차단되면 검색 엔진 폴백(Tavily 우선, 없으면 WebSearch)으로 대체합니다
• 차단 시 재시도 대기를 누적하지 않습니다 (fast-fail 후 다음 방법으로 전환)

다음 단계 안내

✅ Reddit 시장 조사 완료!

리포트: docs/reddit-research/report-{날짜}.md
데이터: docs/reddit-research/leads-{날짜}.csv

다음 단계 (선택):
  /planner    → 조사 결과 기반으로 PRD 작성
  /chronos    → 발견된 기능 요청 구현