Community연구 & 데이터 분석github.com

Jibbithy/reddit-research

Arctic Shift 아카이브 API를 통한 레딧 리서치 — 서브레딧 분석, 참여 지표, 사용자 활동, 삭제/제거된 게시물 복구, 톤 평가, 규칙 및 주제 발견. 이 환경에서는 reddit.com 직접 접근이 차단되어 있으므로, 스킬은 웹 검색으로 대체하지 않고 답변할 수 없는 질문을 명확히 알려줍니다. 사용자가 특정 주제에 대한 레딧의 의견을 묻거나, 서브레딧이나 사용자 분석을 원하거나, 레딧 스레드에서 감정이나 수요 신호가 필요하거나, 삭제/제거된 게시물 복구를 요청할 때 사용하세요.

reddit-research란 무엇인가요?

이 스킬은 레딧 데이터를 가장 신뢰할 수 있는 방법인 Arctic Shift API를 통해 리서치하는 전문 도구입니다. reddit.com에 대한 직접 접근(WebFetch, 웹 검색, Playwright 등)은 환경 수준에서 차단되어 있지만, Arctic Shift는 삭제되거나 제거된 게시물까지 포함한 기록 데이터에 접근할 수 있는 유일한 경로입니다. 주요 기능으로 서브레딧 분석(참여 지표, 톤 평가), 사용자 활동 추적, 특정 주제의 스레드 발견, 서브레딧 탐색, 삭제된 게시물 복구 등이 있으며, 이 모든 기능은 단일 베이스 URL에 대한 일반 curl 호출로 작동합니다. 또한, 답변할 수 없는 질문(예: 실시간 순위, 현재 구독자 수, 로그인 필요 정보)은 웹 검색으로 조용히 대체하지 않고 명확히 '답변 불가'로 표시하여 잘못된 정보를 제공하지 않도록 설계되었습니다. 이 스킬은 Claude Code, Cursor, Codex 등 대부분의 터미널 기반 AI 에이전트에서 실행 가능한 READ-ONLY 연구 도구입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jibbithy/claude-code-skills/tree/HEAD/skills/reddit-research

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Reddit Research Skill

가장 신뢰할 수 있는 방법을 통해 포괄적인 Reddit 리서치를 라우팅합니다. 어떤 도구가 작동하고, 어떤 도구가 작동하지 않으며, 언제 각 도구를 사용해야 하는지 정확히 알고 있습니다.

트리거

/reddit-research analyze r/homelab engagement
/reddit-research what subs does u/example_user post in
/reddit-research find deleted posts in r/SUBNAME
/reddit-research discover subreddits about topic X
search reddit for discussions about X
check reddit metrics for these subreddits

방법 순위 — 한 가지 경로만 작동하고 나머지는 모두 막혔습니다

2026-09-19 재테스트 완료. Arctic Shift가 유일하게 작동하는 소스입니다. 그 외 모든 것은 차단되었습니다. 아래 사다리는 우아한 대체 체인이 아닙니다. 네 개의 사다리 중 세 개가 사라졌으며, 중요한 오류 모드는 죽은 사다리를 웹 검색으로 조용히 대체하고 그 결과를 Reddit 데이터로 제시하는 것입니다.

경로2026-09-19 상태증거
Arctic Shift API작동 — 유일한 경로curl .../api/posts/search?subreddit=selfhosted → 200, 전체 게시물 객체 반환
curl을 통한 reddit.com .json죽음 — 403환경 수준 차단; 브라우저 User-Agent로도 해결 불가
reddit.com에 대한 WebFetch / WebSearch죽음WebSearch가 400 domains not accessible 반환
old.reddit.com에 대한 Playwright사용 불가Playwright MCP 서버 필요, 일반적으로 연결 실패

Arctic Shift — 기본 경로이자 사실상 유일한 경로

  • 베이스: https://arctic-shift.photon-reddit.com/api
  • 일반 curl. 인증, 브라우저, 작업 증명 장벽 없음.
  • 삭제, 제거 및 스팸 필터링된 게시물을 볼 수 있음 — 다른 경로로는 절대 할 수 없는 유일한 기능.

모든 작업에 사용: 기록 연구, 지표, 사용자 활동, 규칙, 톤, 삭제된 게시물 복구.

실행을 조용히 망칠 네 가지 주의사항. 모두 라이브 호출로 확인됨.

  1. 매개변수 이름이 직관적이지 않으며 잘못된 추측 시 하드 오류 발생. 전체 텍스트 검색은 /posts/search에서 title= 또는 selftext=, /comments/search에서 body=를 사용. q는 {"error":"Unknown query parameter: 'q'"} 반환. sort는 asc/desc만 허용.
  2. 1초 이내에 {"error":"Timeout. Maybe slow down a bit"} 반환은 느린 쿼리가 아닌 RATE LIMIT입니다. 페이스 없는 4번의 호출로도 트리거됩니다. 더 긴 -m이나 더 좁은 창으로 재시도해도 효과 없음. 호출 간 ~4초 간격 유지, 해당 오류 발생 시 지수 백오프(8→120초).
  3. 오류 발생 시 응답은 {"data":null,...}. json.data.length를 바로 확인하는 코드는 요율 제한 응답에서 오류를 보고하는 대신 예외를 발생시킵니다. data를 사용하기 전에 null 체크를 하고, error가 설정된 경우 이를 표면화하십시오.
  4. 약 36시간 이내의 게시물은 hide_score:true 및 score:1을 가짐 — 지표 계산 전에 필터링하지 않으면 숫자가 가짜입니다. 점수별 정렬 기능 없음: 넓게 가져와서 클라이언트 측에서 정렬.

Reddit이 진정으로 답변할 수 없는 경우

질문에 실시간 순위, 현재 구독자 수 또는 로그인된 보기가 필요한 경우 Arctic Shift가 제공할 수 없으며 다른 것도 불가능합니다. 결과물에 그렇게 명시하십시오. 워크플로우가 감정 제로를 반환하고 "찾을 수 없음"으로 읽히도록 두지 마십시오. — 이전 두 번의 리서치 실행에서 이 문제가 진단되기 전까지 206개의 에이전트가 Reddit 데이터 없이 소모되었습니다.

다음 대체 소스는 작동이 확인되었으며, Reddit이 아닌 소스임을 명확히 표시한다면 "실무자들이 X에 대해 뭐라고 말하는가"에 대한 정직한 대체 수단입니다.

  • Hacker News (최고 대체): https://hn.algolia.com/api/v1/search?query=<terms>&tags=story (또는 &tags=comment), 그런 다음 https://hn.algolia.com/api/v1/items/<objectID>로 전체 댓글 트리 확인. 모든 인용문은 해당 댓글 ID를 포함하고 문자열 존재를 확인하기 위해 다시 가져와야 함.
  • Lobsters: https://lobste.rs/search?q=<terms>&what=stories&order=relevance
  • Stack Exchange: https://api.stackexchange.com/2.3/search/advanced?order=desc&sort=votes&q=<terms>&site=stackoverflow

작동하지 않는 방법 — 절대 시도하지 마십시오

방법이유결과
curl / WebFetch to reddit.com (모든 경로, .json 포함)환경 수준 차단; 브라우저 User-Agent로도 해결 불가403
site:reddit.com 또는 allowed_domains:["reddit.com"]를 사용한 WebSearch도메인 허용되지 않음400 domains not accessible
curl을 통한 Reddit RSS (.rss)특별히 차단됨403
토큰 없는 oauth.reddit.comHTML로 리디렉션301 → HTML
redlib / safereddit / libreddit 미러Anubis 작업 증명 인터스티셜, JS 필요챌린지 페이지, 0개 게시물
api.pullpush.io (Pushshift 후속)다운502
old.reddit.com 앞의 r.jina.ai 프록시프록시가 Reddit 자체 403을 감싸서 200 반환403 본문

이것들을 다시 발견하기 위해 실행을 낭비하지 마십시오. Arctic Shift가 답변할 수 없다면 여기 있는 어떤 것도 할 수 없습니다.


API 참조

엔드포인트, 응답 필드 및 두 소스에 대한 주의사항: references/api.md. 호출을 구성하기 전에 읽으십시오; 메모리에서 엔드포인트를 재구성하지 마십시오.

참여 지표

4가지 지표 (Arctic Shift 데이터에서 계산)

지표공식측정 대상
댓글/업보트 비율 (cmtRatio)avgCmts / avgScore토론 깊이
업보트 비율upvote_ratio 필드 (0-1)커뮤니티 승인
게시물당 평균 댓글 수sum(num_comments) / count활동 수준
게시물당 평균 점수sum(score) / count도달/가시성

계산

const posts = data.data.filter(p => !p.hide_score && p.score > 1);
const avgScore = posts.reduce((s, p) => s + p.score, 0) / posts.length;
const avgCmts = posts.reduce((s, p) => s + p.num_comments, 0) / posts.length;
const cmtRatio = avgCmts / avgScore;
const avgUpvoteRatio = posts.reduce((s, p) => s + p.upvote_ratio, 0) / posts.length;

토론 깊이 등급

등급임계값의미
S>= 0.70매우 대화형
A>= 0.25강한 토론
B>= 0.10 또는 평균 댓글 >= 10보통, 참여 가치 있음
C0.05-0.10대부분 수동적 / 도달 서브
D< 0.05낮은 참여
E평균 댓글 < 1죽었거나 엄격한 게이트

톤 평가

이미 가져온 게시물 데이터(추가 호출 없음)에서 평가:

  1. link_flair_text 값 - 테마 데이, 카테고리, 명시적 지표
  2. 제목 패턴 - 언어 스타일, 규범
  3. 최고 점수 게시물의 selftext - 문화 신호
  4. 점수 분포 - 커뮤니티가 실제로 보상하는 것

가져온 게시물을 클라이언트 측에서 점수별로 정렬. 상위 10-20개가 커뮤니티 가치를 드러냅니다.


표준 워크플로우

반복 요청당 최소 호출 레시피 — 서브레딧 리서치, 사용자 조사, 스레드 찾기, 서브 발견, 일괄 확인, 삭제된 게시물 복구, 섀도우밴 감지: references/workflows.md.

결정 흐름도

Reddit 데이터가 필요합니까?
|
+-- 기록 게시물, 댓글, 지표, 사용자 활동, 규칙, 삭제된 콘텐츠?
|     --> Arctic Shift. 이것은 이 스킬이 실제로 답변할 수 있는 모든 질문입니다.
|
+-- 실시간 순위, 현재 구독자 수 또는 로그인된 보기?
|     --> 사용 불가. reddit.com은 curl 및 WebFetch에 403, WebSearch는 도메인을
|         거부하며, Playwright에는 일반적으로 다운된 MCP 서버가 필요합니다.
|         결과물에 그렇게 명시하십시오. 웹 검색을 조용히 대체하지 마십시오.
|
+-- 섀도우밴 확인?
|     --> 같은 이유로 사용 불가 (/user/NAME/about.json 필요).
|
+-- "실무자들이 X에 대해 뭐라고 말하는가?" (Reddit이 수단일 뿐인 경우)?
|     --> HN Algolia / Lobsters / Stack Exchange, Reddit이 아님을 표시.
|
+-- 게시, 댓글, DM, 모드메일?
      --> 리서치 도구로는 불가능. Reddit 자체 인터페이스를 사용하십시오.

정직한 공백 규칙: 이 스킬이 답변할 수 없는 질문은 이유와 함께 답변 불가로 보고됩니다. Reddit 데이터를 반환하지 않으면서 이유를 말하지 않는 실행은 "찾을 수 없음"으로 읽히는데, 이는 다르고 잘못된 주장입니다.


범위 경계

  • 이 스킬은 읽기 전용 리서치입니다. 게시, 댓글 또는 쓰기 작업은 없습니다.
  • 작업에 게시 또는 계정 작업이 필요한 경우, 사용자에게 Reddit 인터페이스 또는 인증된 클라이언트를 통해 수행해야 함을 알립니다.

관련 스킬