Guide 12 · 설치 가이드
Agent Reach 설치 가이드 — 채널 14개 한글 정리 + 유튜브·깃허브 조사 프롬프트 30개
클로드 코드는 유튜브 링크를 줘도 영상 속 내용을 거의 못 읽어요. Agent Reach(에이전트 리치)를 깔면 유튜브 자막을 통째로 가져와서 긴 영상도 바로 요약하고, 깃허브 저장소·이슈, 웹페이지도 깔끔하게 읽어 와요. 깃허브 별 10.9만 개(109,237개, 2026-11-06 기준), MIT 라이선스 무료 도구예요.
이 페이지에 채널 14개 한글 정리, README 공식 설치 명령어, 실제로 돌려 본 결과, 바로 붙여 넣는 조사 프롬프트 30개를 정리했어요.

한눈에 보기
| 항목 | 내용 |
|---|---|
| 무엇 | 클로드 코드 같은 AI 에이전트가 혼자서는 못 읽는 곳(영상 자막, 깃허브 이슈, 로그인이 필요한 사이트 등)을 읽게 해 주는 도구 |
| 비용 | 무료 (MIT 오픈소스). 음성 받아쓰기만 Groq·OpenAI 키 필요 |
| 로그인 없이 바로 | 깃허브 · 유튜브 · 웹페이지 · V2EX (빌리빌리는 검색·영상 정보까지) |
| 쓰는 곳 | 클로드 코드, Codex 등 터미널에서 명령을 실행할 수 있는 에이전트 |
| 설치 | 클로드 코드에 설치 링크 한 줄 붙여 넣기 (아래) |
채널 14개 한글 정리
| # | 채널 | 단계 | 할 수 있는 일 | 로그인 |
|---|---|---|---|---|
| 1 | 깃허브 (github) | 기본 | 저장소 검색, 저장소·README 읽기, 이슈·PR을 댓글까지 읽기 | 필요 없음 |
| 2 | 유튜브 (youtube) | 기본 | 영상 정보, 검색, 자막 전체 가져오기, 음성 받아쓰기 | 필요 없음 (받아쓰기만 Groq/OpenAI 키) |
| 3 | 웹 (web) | 기본 | 웹 검색, 웹페이지 본문 읽기 | 필요 없음 |
| 4 | V2EX | 기본 | 인기 글, 게시판, 글과 댓글, 사용자 | 필요 없음 |
| 5 | 빌리빌리 (bilibili) | 기본 | 검색, 영상 정보, 인기 영상, 자막 | 자막만 로그인(QR) |
| 6 | 레딧 (reddit) | 선택 | 글 검색, 본문·댓글 읽기, 서브레딧 둘러보기 | 필요 |
| 7 | 링크드인 (linkedin) | 선택 | 채용 검색, 채용 공고 읽기 | 공개 공고는 없음, 사이트 검색은 필요 |
| 8 | 샤오홍슈 (xiaohongshu) | 선택 | 노트 검색, 본문 읽기, 댓글 보기 | 필요 |
| 9 | 쉐에추 (xueqiu) | 선택 | 실시간 시세, 종목 검색, 인기 글·종목 | 시세는 없음, 인기 글·종목은 필요 |
| 10 | BOSS직빈 (boss) | 선택 | 채용·직무 설명 검색 | 필요 |
| 11 | 샤오위저우 (xiaoyuzhou) | 선택 | 팟캐스트 받아쓰기 | Groq 키 |
| 12 | X·트위터 (twitter) | 실험 | 트윗 검색, 프로필, 사용자 트윗, 스레드 | 필요 |
| 13 | 페이스북 (facebook) | 실험 | 검색, 프로필 | 필요 |
| 14 | 인스타그램 (instagram) | 실험 | 사용자 검색, 프로필, 게시물 | 필요 |
- 기본: 설치하면 바로 켜져요. 선택: 클로드에게 "레딧 추가해 줘"처럼 말하면 켜 줘요(
agent-reach add reddit). 실험: 되긴 하지만 사이트가 자동화를 막아서 언제든 안 될 수 있어요. - 로그인이 필요한 채널은 내 크롬의 로그인을 복사해서 써요. 계정이 제한될 수 있으니 본 계정 말고 보조 계정을 권해요. 이 가이드는 로그인 없이 쓰는 깃허브·유튜브·웹 위주로 정리했어요.

설치 — 링크 한 줄
클로드 코드에 이 한 줄을 그대로 붙여 넣으세요 (README 공식 방법)
text
Install Agent Reach: https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md클로드가 설치 안내서를 읽고 uv 설치 → Agent Reach 설치 → 기본 채널 켜기 → 클로드 코드용 스킬 설치까지 알아서 해요. 실제로 돌려 보니 약 1분 만에 "Agent Reach 1.6.1 설치가 끝났어요", 기본 기능 5/5 준비 완료가 나왔어요.

- 설치 보고서 표가 중국어로 나와요(제작자가 중국 개발자). 클로드에게 "한국어로 설명해 줘"라고 하면 돼요.
- 이 방법은 내 컴퓨터 전체(전역)에 깔려요. 어느 폴더에서 클로드 코드를 열어도 쓸 수 있어요.
직접 터미널에 치고 싶다면 (같은 결과)
Bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup- PyPI(pip)에 있는 같은 이름
agent-reach패키지는 다른 프로젝트예요.pip install agent-reach하지 마세요. - 설치 뒤
agent-reach명령이 안 보이면uv tool update-shell을 치고 터미널을 새로 여세요.
써 보기 — 1시간짜리 유튜브 영상 요약
text
agent-reach로 이 유튜브 영상 영어 자막 가져와서 한국어 5줄로 요약해 줘: https://www.youtube.com/watch?v=9oJySubZRSA1시간 1분짜리 영상의 영어 자막 약 6.5만 자를 통째로 가져와서, 약 1분 만에 단계별 한국어 요약이 나왔어요.


터미널에서 직접 쓰는 명령어
Bash
agent-reach youtube search "claude code" # 유튜브 검색
agent-reach youtube subtitle <영상 링크> --lang ko,en # 자막 전체
agent-reach read https://github.com/anthropics/claude-code # 저장소 + README
agent-reach read <이슈 링크> # 이슈를 댓글까지
agent-reach web read <웹페이지 링크> # 웹페이지 본문
agent-reach channels # 채널 목록바로 쓰는 조사 프롬프트 30개
클로드 코드에 그대로 붙여 넣고 <링크>, <주제>만 바꾸세요.
유튜브 조사 (12개)
text
이 유튜브 영상 자막을 agent-reach로 가져와서 핵심 내용 5줄, 영상에 나온 도구·숫자 목록으로 정리해 줘: <영상 링크>text
이 영상 자막 전체를 가져와서 시간 순서대로 목차를 만들어 줘. 각 목차에 한 줄 요약도 붙여 줘: <영상 링크>text
agent-reach로 유튜브에서 "claude code skills"를 검색해서 상위 10개 영상의 제목·채널·조회수·길이를 표로 정리해 줘text
이 영상 3개 자막을 전부 가져와서 공통으로 말하는 것과 서로 다르게 말하는 것을 표로 비교해 줘: <링크1> <링크2> <링크3>text
이 영상에서 따라 할 수 있는 실습 단계만 뽑아서 체크리스트로 만들어 줘. 명령어가 나오면 코드 블록으로: <영상 링크>text
이 강의 영상 자막으로 복습 퀴즈 10문제(객관식, 정답·해설 포함)를 만들어 줘: <영상 링크>text
이 영상 자막을 읽고 블로그 글 초안(제목 3안, 소제목 4개, 본문)으로 바꿔 줘. 한국어로: <영상 링크>text
이 영상에서 주장하는 내용 중 근거가 약한 부분을 찾아서 확인이 필요한 질문으로 정리해 줘: <영상 링크>text
유튜브에서 "<주제>"를 검색해서 최근 영상 5개 자막을 읽고, 요즘 사람들이 많이 묻는 질문 10개를 뽑아 줘text
이 인터뷰 영상에서 인상적인 문장 10개를 원문 그대로 뽑고 한국어 번역을 옆에 붙여 줘: <영상 링크>text
이 영상 정보(제목·채널·날짜·설명)만 먼저 읽고, 볼 가치가 있는지 3줄로 판단해 줘: <영상 링크>text
이 영상 자막을 쇼츠 대본 30초짜리로 요약해 줘. 첫 문장은 결과를 약속하는 훅으로: <영상 링크>깃허브 조사 (10개)
text
agent-reach로 깃허브에서 "<주제>" 저장소를 검색해서 별 많은 순으로 10개, 한 줄 설명·별 수·마지막 업데이트를 표로 정리해 줘text
이 저장소 README를 읽고 무슨 도구인지, 누구에게 필요한지, 설치 방법을 한국어 5줄로 정리해 줘: <저장소 링크>text
이 저장소 두 개를 읽고 기능·설치 난이도·라이선스·활발한 정도를 표로 비교해 줘: <저장소1> <저장소2>text
이 이슈를 댓글까지 전부 읽고 문제 원인, 지금까지 나온 해결책, 아직 안 풀린 점을 정리해 줘: <이슈 링크>text
이 PR을 댓글까지 읽고 무엇이 바뀌는지, 리뷰어가 걱정한 점이 뭔지 쉬운 말로 설명해 줘: <PR 링크>text
이 저장소 README에 나온 설치 명령어만 그대로 뽑아서 맥·윈도우별로 나눠 줘: <저장소 링크>text
깃허브에서 "claude code skill"을 검색해서 내 직무(<직무>)에 쓸 만한 것 5개를 골라 이유와 같이 추천해 줘text
이 저장소 README를 읽고 내 상황(<상황>)에 맞는지, 비슷한 대안이 있는지 같이 알려 줘: <저장소 링크>text
이 저장소의 최근 이슈 몇 개를 읽고 사람들이 자주 겪는 설치 문제와 해결법을 FAQ로 만들어 줘: <저장소 링크>text
이 오픈소스 도구를 우리 팀에 소개하는 1쪽짜리 메모를 써 줘. 장점·주의점·도입 순서까지: <저장소 링크>웹페이지 조사 (5개)
text
agent-reach로 이 웹페이지를 읽고 광고·메뉴 빼고 본문만 깔끔하게 요약해 줘: <페이지 링크>text
이 문서 페이지 3개를 읽고 처음 쓰는 사람용 시작 가이드 하나로 합쳐 줘: <링크1> <링크2> <링크3>text
웹에서 "<주제> 2026"을 검색해서 상위 5개 글을 읽고, 출처 링크를 단 요약표를 만들어 줘text
이 가격 페이지를 읽고 요금제별 차이를 표로 만들고, 개인이 쓰기엔 어느 게 맞는지 골라 줘: <가격 페이지 링크>text
이 공식 발표 글을 읽고 바뀐 점만 bullet로 정리하고, 내가 지금 해야 할 일이 있는지 알려 줘: <발표 링크>섞어서 쓰기 (3개)
text
"<도구 이름>"을 깃허브 저장소, 유튜브 사용법 영상 2개, 공식 문서 페이지까지 읽고 설치부터 첫 사용까지 한 페이지 가이드로 만들어 줘text
유튜브에서 "<주제>" 영상 3개 자막과 깃허브 관련 저장소 3개를 같이 읽고, 지금 가장 많이 쓰이는 방법 TOP 3를 근거 링크와 함께 정리해 줘text
이 영상에서 소개한 도구들을 깃허브에서 하나씩 찾아서 별 수·설치 명령어·무료 여부를 표로 만들어 줘: <영상 링크>이렇게 쓰면 좋아요
- 프롬프트 앞에 "agent-reach로"를 붙이면 클로드가 이 도구를 확실히 써요. 안 붙이면 그냥 웹 검색으로 대충 넘어갈 때가 있어요.
- 유튜브 자막은 "영어 자막"·"한국어 자막"처럼 언어를 말해 주세요. 결과는 "한국어로 요약"이라고 하면 돼요.
- 영상 여러 개, 저장소 여러 개를 한 번에 묶어서 비교시키면 사람이 하나씩 보는 것보다 훨씬 빨라요.
- 결과를 노션·블로그 초안·퀴즈처럼 바로 쓸 모양으로 달라고 하세요.
자주 묻는 질문
- 유튜브 자막이 "429 Too Many Requests"로 막혀요 → 기본 설정이 중국어 번역 자막부터 시도하는데, 유튜브가 번역 자막 요청을 자주 막아요. "영어 자막으로" 또는
--lang ko,en처럼 원래 언어를 지정하면 돼요. 막히면 Agent Reach가 유튜브 요청을 잠시 쉬어요(보통 몇 분~1시간). - 설치했는데 클로드가 안 써요 → 클로드 코드를 껐다 켜고, 프롬프트에 "agent-reach로"를 붙이세요. 클로드 앱 채팅이 아니라 클로드 코드(터미널 명령을 실행할 수 있는 곳)용이에요.
agent-reach명령을 못 찾아요 →uv tool update-shell을 치고 터미널을 새로 여세요.- pip로 깔았는데 이상해요 → PyPI의
agent-reach는 다른 프로젝트예요.pip uninstall agent-reach후 위 공식 방법으로 다시 까세요. - 레딧·X도 읽고 싶어요 → "레딧 추가해 줘"라고 하면 돼요. 내 크롬 로그인을 복사해 쓰니 보조 계정을 권해요.
- 지우고 싶어요 →
agent-reach uninstall하면 설치한 것만 깔끔하게 지워요.
링크
- 저장소: https://github.com/Panniantong/Agent-Reach
- 영어 README: docs/README_en.md
- 설치 안내서(클로드에게 주는 링크): docs/install.md
담PD가 노션에 공개한 자료를 이미지·글 그대로 옮겨 온 아카이브입니다. 최신 내용과 업데이트는 원문에서 확인하세요.
노션 원문에서 보기 →