작성자 주석: Agent에게 말 한마디를 거는 것에서 시작해서, Agent-Reach를 손수 설치해 봅니다. Claude Code, Codex 같은 Agent가 샤오홍슈 노트, X 타임라인, B站 자막을 읽을 수 있게 만들고, 채널 표와 명령어 대조표, 문제 해결 방법, 비용 추정까지 곁들였어요.
Agent에게 경쟁사 조사를 시키면 금방 벽에 부딪혀요. “샤오홍슈에서 사람들이 이 헤드폰을 어떻게 평가하는지 좀 봐줘”라고 하면, 기본 내장된 웹 검색은 짜깁기한 글 몇 편만 가져올 뿐 샤오홍슈 노트 자체는 아예 찾지 못해요. “이 X 계정이 이번 주에 뭘 올렸는지 요약해줘”라고 하면 로그인 벽 뒤에 있는 타임라인을 열 수가 없죠.
영상 콘텐츠는 상황이 더 나빠요. 40분짜리 B站 기술 공유 영상에서 진짜 값진 정보는 전부 말로 풀어내는 부분에 들어 있어요. 범용 검색은 B站 자막을 가져오지 못하니, Agent는 제목과 소개만 보고 짐작하는 수밖에 없어요. 쉐이추(雪球), V2EX 같은 중국어 플랫폼도 범용 검색에서 커버리지가 형편없고, 가져온 웹페이지에는 내비게이션과 광고가 잔뜩 섞여 있죠.
바로 이 문제를 풀기 위한 오픈소스 프로젝트가 Agent-Reach예요. GitHub에서 이미 10만 개 넘는 스타를 받았고, 포지션은 “AI Agent가 스스로는 올라갈 수 없는 인터넷에 손이 닿게 해준다”예요. 이건 또 명령어를 파고들어야 하는 도구가 아니에요: 이 튜토리얼의 주된 흐름은 Agent에게 말 한마디 해서 설치를 끝내는 것이고, 그다음의 채널 추가, 계정 전환, 업그레이드도 전부 평범한 말로 해결해요.
핵심 가치: 이 글을 다 읽고 나면 여러분의 Agent가 X, Reddit, B站, 샤오홍슈 같은 플랫폼의 콘텐츠를 읽을 수 있게 되고, 각 단계를 어떻게 검증해야 하는지, 오류가 나면 어떻게 찾아야 하는지, 조사 한 번에 대략 얼마가 드는지도 알게 돼요.
Agent-Reach 튜토리얼 핵심 요점
본격적으로 시작하기 전에, 표 하나로 Agent-Reach의 핵심 사실을 먼저 정리해 볼게요. 아래 정보는 2026-10-26 기준으로 프로젝트 저장소를 직접 확인한 내용이에요.
| 요점 | 설명 | 여러분에게 주는 가치 |
|---|---|---|
| 프로젝트 인기도 | Star 10만 개 이상, Trendshift GitHub Trending 당일 1위 기록 | 커뮤니티가 활발하고 이슈에 대응이 붙어요 |
| 라이선스와 환경 | MIT 오픈소스, Python 3.10+ 로 작성 | 무료로 쓸 수 있고, 코드를 직접 검토할 수 있어요 |
| 플랫폼 비용 | 자체는 무료, 플랫폼 API 비용이 전혀 없어요 | 실제 비용은 Agent의 모델 token뿐이에요 |
| 작동 방식 | 읽기 전용: 검색과 읽기만 하고, 게시·댓글·좋아요·DM은 하지 않아요 | 플랫폼에서 대신 “말”하지 않아요 |
| 출력 형식 | 1.6 이후 버전은 명령마다 JSON 객체 하나를 출력 | Agent가 ok / result / error.hint만 읽으면 성공 여부를 판단할 수 있어요 |
Agent-Reach가 해결하는 네 가지 “닿지 못하는” 영역
Claude Code, Codex, Hermes Agent, OpenClaw 같은 CLI Agent는 검색과 웹 읽기 기능을 기본으로 갖추고 있지만, 원래 접근할 수 없는 콘텐츠가 네 가지 있어요. 첫 번째는 로그인해야 쓸 수 있는 기능이에요. 샤오홍슈에서 노트를 검색하거나, X에서 계정 활동을 확인하거나, 채용 공고 상세를 읽는 것 같은 거죠. 두 번째는 영상 속 콘텐츠예요. B站(빌리빌리)과 YouTube 자막, 그리고 YouTube 영상과 샤오위저우 팟캐스트의 음성-텍스트 변환이 여기에 포함돼요.
세 번째는 중국어 플랫폼이에요. B站, 샤오홍슈, V2EX, 쉐이추는 범용 검색에서 커버리지가 아주 떨어져요. 네 번째는 깔끔한 구조화 데이터예요. 쉐이추 시세, V2EX 게시글과 댓글, GitHub 저장소와 이슈 같은 것들이요. Agent-Reach가 가져오는 건 잘 정리된 콘텐츠이지, HTML 페이지 통째가 아니에요. 그래서 Agent가 소비하는 token을 곧바로 줄여줘요.
Agent-Reach의 설계 방식: 우선 선택과 대체 선택
Agent-Reach는 각 플랫폼의 각 동작을 “순서대로 시도하는 도구 목록”으로 설계했어요. 예를 들어 B站 영상을 읽을 때는 먼저 bili-cli를 쓰고, 실패하면 자동으로 B站 공개 인터페이스로 전환해요. 웹페이지를 읽을 때는 Jina Reader를 먼저 쓰고, 그다음 Exa를 써요. 플랫폼 개편과 도구 무효화는 일상적인 일이라, 관리자는 이 목록만 조정하면 되고 여러분과 Agent의 사용법은 전혀 바뀌지 않아요.
Agent-Reach가 지원하는 채널
현재 버전은 채널을 세 등급으로 나눠요. 기본 채널은 설치만 하면 바로 쓸 수 있고, 선택 채널은 Agent에게 “XX도 추가해줘”라고 한마디만 하면 열리면서 필요한 소프트웨어가 자동으로 설치돼요. 실험 채널은 쓸 수는 있지만 플랫폼의 크롤링 차단이 더 엄격해서 언제든 작동이 멈출 수 있어요. 아래 표는 저장해 두시길 권해요. “무엇을 할 수 있는지”와 “무엇이 필요한지”라는 가장 흔한 두 가지 질문에 답해 주거든요.
| 채널 | 등급 | 할 수 있는 것 | 필요한 것 |
|---|---|---|---|
| bilibili | 기본 | 검색, 영상 정보, 인기 영상, 자막 | 자막은 QR 코드 로그인 필요 |
| v2ex | 기본 | 인기글, 노드, 게시글과 댓글, 사용자 | 로그인 불필요 |
| github | 기본 | 저장소 검색, 저장소와 README 읽기, issue와 PR 읽기(댓글 포함) | 로그인 불필요 |
| youtube | 기본 | 영상 정보, 검색, 자막, 음성-텍스트 변환 | 텍스트 변환은 Groq 또는 OpenAI 키 필요 |
| web | 기본 | 웹 검색, 웹 읽기(최후의 수단 채널) | 로그인 불필요 |
| xiaohongshu | 선택 | 노트 검색, 본문 읽기, 댓글 보기 | 로그인 필요 |
| xueqiu | 선택 | 실시간 시세, 주식 검색, 인기 게시글, 인기 종목 | 시세는 로그인 불필요, 인기 게시글·인기 종목은 로그인 필요 |
| boss | 선택 | 직무와 JD 검색 | 로그인 필요 |
| xiaoyuzhou | 선택 | 팟캐스트 텍스트 변환 | Groq 키 필요 |
| 선택 | 직무 검색, 직무 상세 읽기 | 공개 직무는 로그인 불필요, 사이트 내 검색은 로그인 필요 | |
| 선택 | 게시글 검색, 본문 읽기, 댓글 보기, 게시판 보기 | 로그인 필요 | |
| twitter(X) | 실험 | 트윗 검색, 사용자 프로필, 사용자 트윗, 트윗 스레드 읽기 | 로그인 필요 |
| 실험 | 검색, 페이지 프로필 | 로그인 필요 | |
| 실험 | 사용자 검색, 프로필, 사용자 게시글 | 로그인 필요 |
한 가지 눈여겨볼 점이 있어요. 기본 채널은 원하지 않으면 제거할 수 있는데, 제거한 뒤에는 업데이트해도 다시 자동으로 추가되지 않아요. 제목에서 언급한 X는 현재 실험 채널에 속해서 가끔 조회하기에는 적합하지만, 매일 의존하는 안정적인 데이터 소스로 삼기에는 적합하지 않아요.
Agent-Reach 빠른 시작: Agent에게 한마디만 하면 돼요
전체 설치 과정에서 터미널을 열 필요가 없어요. 아래 각 단계에는 “검수 기준”이 함께 붙어 있으니, 통과를 확인한 뒤 다음 단계로 넘어가세요. 문제가 생기면 뒤에 나오는 문제 해결 표를 바로 참고하면 됩니다.
1단계: Agent 설정에서 “명령 실행 허용” 켜기
Agent-Reach는 Agent가 터미널 명령을 실행할 수 있어야 해요. 사용 중인 Agent의 그래픽 설정 화면에서 “명령 실행 허용” 같은 스위치를 찾아 켜면 됩니다. Agent마다 명칭이 조금씩 다를 수 있어요. 컴퓨터에 uv가 없어도 걱정 마세요. Agent가 먼저 uv를 자동으로 설치해 주거든요. 명령 한 줄이면 되고, 관리자 비밀번호도 필요 없어요.
- 검수 기준: Agent에게 “현재 있는 디렉터리를 알려줘”라고 말했을 때, “명령을 실행할 수 없어요”라고 답하는 대신 실제로 명령을 실행하고 경로를 반환해야 해요.
2단계: 설치 문장을 Agent에게 보내기
이것은 공식에서 권장하는 가장 간편한 방법이에요. 아래 문장을 그대로 복사해서 Agent에게 보내면 됩니다:
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
Agent는 설치 안내를 읽은 뒤 두 가지 일을 스스로 처리해요. 먼저 uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip를 실행하고, 이어서 agent-reach setup을 실행하죠. 모든 파일은 ~/.agent-reach/라는 폴더 하나에 통일해서 저장되기 때문에, 나중에 업그레이드하거나 관리하고 삭제하기가 아주 편해요.
- 검증 기준: Agent가 설치 완료를 보고하고,
agent-reach channels를 실행했을 때 반환되는 JSON에서ok가 true이며,result에 채널 목록이 나열되어 있어야 해요.
3단계: Agent에게 채널 상태 확인시키기
Agent에게 “Agent Reach 상태 좀 봐줘”라고 말해보세요. 그러면 각 채널이 지금 사용 가능한지, 그리고 지난번에는 괜찮았는데 지금은 고장 난 채널이 어떤 것인지 알려줄 거예요. 이 단계는 일종의 건강검진 같은 것이라서, 나중에 이상한 문제가 생겼을 때도 먼저 이걸 해보는 걸 권장해요.
- 검증 기준: bilibili, v2ex, github, youtube, web 다섯 개 기본 채널이 사용 가능으로 표시되어야 해요. Bilibili 자막이나 YouTube 텍스트 변환처럼 추가 조건이 필요한 기능에 “로그인 필요” 또는 “Key 필요”라는 안내가 뜨는 것은 정상이에요.
4단계: 선택 채널 추가하고 로그인 마무리하기
샤오홍슈를 예로 들어, Agent에게 “샤오홍슈도 추가해줘”라고 말하면 필요한 소프트웨어를 알아서 설치해요. 로그인이 필요한 플랫폼은 Agent-Reach에 내장된 전용 브라우저가 처리하는데, 백그라운드에서 실행되고 팝업도 뜨지 않으며, 이 전용 브라우저는 이 컴퓨터에서만 열려요. 대신 로그인해주는 일은 절대 없고, 비밀번호를 물어보지도 않아요.
일부 플랫폼은 컴퓨터에 이미 있는 로그인 상태를 재사용하는데, 해당 사이트의 로그인만 복사하고 원래 브라우저는 그대로 두며 비밀번호 저장소도 읽지 않아요. 여기서는 꼭 다음 섹션의 위험 안내를 끝까지 읽어보세요. 만약 재사용한 게 메인 계정이라면 Agent에게 “다른 계정으로 바꿔줘”라고 말해 서브 계정으로 전환하세요.
- 확인 기준: 다시 “Agent Reach 상태 보여줘”라고 말했을 때 xiaohongshu가 사용 가능으로 표시되어야 해요. 이어서 Agent에게 키워드 하나를 검색하게 하면, 반환 결과에 노트 제목과 본문 일부가 포함되어야 해요.
5단계: 첫 크로스 플랫폼 리서치 작업 실행하기
목표를 자연어로 설명하면 돼요. 예를 들어 “Agent Reach로 어떤 기계식 키보드에 대한 평가를 조사해줘. 샤오홍슈 노트, Bilibili 리뷰 영상 자막, Reddit 토론을 각각 살펴보고, 마지막으로 플랫폼별로 따로 정리해줘”라고 하면, Agent가 스스로 여러 개의 agent-reach <채널> <동작> [파라미터] 명령으로 나눠서 실행해요.
- 확인 기준: Agent의 요약이 플랫폼별로 나뉘어 나열되고, 각 의견이 구체적인 노트, 영상, 게시물과 연결되어야 해요. 만약 특정 채널이 실패하면 조용히 건너뛰는 대신
error.hint에 있는 안내를 그대로 전달해야 해요.
🚀 빠른 시작 팁: Agent-Reach는 콘텐츠를 가져오는 역할만 하고, 내용을 이해하고 요약하는 건 Agent 뒤에 있는 대규모 언어 모델이 담당해요. 사용하는 Agent가 사용자 정의 모델 인터페이스를 지원한다면, APIYI apiyi.com를 통해 API 키 하나로 Claude, GPT, Gemini 같은 모델을 연결할 수 있어요. 신규 사용자에게는 무료 테스트 크레딧이 있어서 첫 리서치 작업을 저비용으로 먼저 진행해보기에 좋아요.
Agent에 APIYI 모델 인터페이스를 구성하는 방법
사용하는 Agent가 OpenAI 호환 인터페이스를 지원한다면 구성 방식은 아래와 같아요. 구체적인 필드 이름은 여러분이 쓰는 Agent 설정 화면을 기준으로 하세요:
- 인터페이스 주소(base_url):
https://api.apiyi.com/v1 - API 키: APIYI 콘솔에서 생성한 키
-
모델 이름: 일상적인 조사에는
claude-sonnet-5-5를 권장하고, 대량의 가벼운 작업에는claude-haiku-5-5를 선택하세요 -
검수 기준: Agent에 “안녕하세요, 당신은 어떤 모델인가요?”라고 한마디 보내면 정상적으로 내용이 반환되고, APIYI 콘솔에 해당 호출 기록이 나타나야 해요.
Agent-Reach 자주 쓰는 명령 대조표
일상에서 쓸 때는 왼쪽 칸의 말을 Agent에게 그대로 하면 충분해요. 오른쪽 명령은 Agent가 뒤에서 무슨 일을 하는지 이해하거나, 직접 터미널에서 문제를 점검할 때 참고하세요.
| Agent에게 하는 말 | Agent가 뒤에서 실행하는 명령 | 용도 |
|---|---|---|
| “채널이 어떤 게 있고 각각 뭘 할 수 있어” | agent-reach channels |
채널과 기능 확인 |
| “Bilibili에서 대규모 언어 모델 검색해줘” | agent-reach bilibili search "대규모 언어 모델" |
통일 형식: 채널 + 동작 + 파라미터 |
| “이 링크 읽어줘” | agent-reach read <링크> |
링크에 따라 채널 자동 선택 |
| “Agent Reach 업그레이드해줘” | agent-reach update |
프로그램, 각 채널 도구, skill을 한 번에 업데이트 |
| “설치했는데 명령을 찾을 수 없다고 나와” | uv tool update-shell 후 새 shell 열기 |
명령 경로 수정 |
| (터미널에서 직접) | agent-reach configure groq-key |
음성-텍스트 변환에 필요한 키 입력 |
| “Agent Reach 삭제해줘” | 삭제할 항목을 먼저 나열하고, 확인 후 삭제 | 안전한 제거 |
이 외에도 “샤오홍슈 빼줘”, “샤오홍슈 로그인이 만료됐어”, “로그아웃해줘”, “다른 AI도 쓸 수 있게 해줘” 같은 말도 그대로 Agent에게 하면 돼요. 명령을 외울 필요는 없어요.
Agent-Reach 위험 안내 (사용 전 필독)
⚠️ Agent-Reach를 사용하기 전에 이 섹션을 꼼꼼히 읽어 주세요
- 이것은 커뮤니티 오픈소스 도구이며, 어떤 플랫폼의 공식 인증 API도 아니에요. 저희는 이 프로젝트를 추천할 뿐, 안정성, 보안성, 준법성에 대해 어떠한 보증도 하지 않아요.
- 계정이 속도 제한되거나 차단될 가능성이 있어요. X, 샤오홍슈(小红书), Reddit 같은 플랫폼은 자동화 접근을 비정상 행위로 판단할 수 있어요. 공식 README에서도 부계정 사용을 분명히 권장하고 있으니, 중요한 계정으로 Agent를 돌리지 마세요.
- 로컬 로그인을 재사용하면 메인 계정이 딸려 나올 수 있어요. 일부 채널은 컴퓨터에 이미 있는 로그인 상태를 재사용하는데, 평소 로그인하는 계정은 보통 메인 계정이에요. 채널을 켠 뒤에는 지금 어떤 계정을 쓰고 있는지 먼저 확인하고, 필요하면 Agent에게 “계정 바꿔줘”라고 말해서 부계정으로 전환하세요.
- 결과에 대한 책임은 본인에게 있어요. 계정 정지, 속도 제한, 데이터 수집과 사용의 준법 문제 등 모든 결과는 독자가 스스로 판단하고 감당해야 하며, APIYI 플랫폼 및 이 글의 작성자와는 무관해요.
- 설치 출처를 꼭 확인하세요. PyPI에 있는 agent-reach라는 패키지는 이 프로젝트가 아니며, 반드시 GitHub 주소에서만 설치할 수 있어요. 이 프로젝트에는 어떤 공식 토큰, 코인, 투자 상품, 지갑 연결도 없으며, 이 이름을 빌린 암호화폐 프로젝트는 모두 이 저장소와 무관해요.
Agent-Reach 트러블슈팅 표
아래 다섯 가지는 처음 시작할 때 가장 자주 마주치는 상황이에요. 각 항목은 그대로 따라 하면 돼요. 문제를 살펴보기 전에 Agent에게 “Agent Reach 상태를 확인해줘”라고 한 번 실행하게 하고, error.hint 원문을 그대로 알려달라고 하는 게 좋아요.
| 증상 | 원인 | 해결 방법 |
|---|---|---|
설치 후 agent-reach 명령을 찾을 수 없다는 메시지가 나와요 |
uv 도구 디렉터리가 아직 명령 경로에 추가되지 않았어요 | Agent에게 uv tool update-shell을 실행하게 한 뒤, 새 셸을 열고(또는 Agent를 재시작하고) 다시 시도해요 |
| Agent가 “명령을 실행할 수 없어요”라고 답해요 | 명령 실행 권한이 꺼져 있어요 | 1단계로 돌아가서 Agent 설정에서 “명령 실행 허용”을 켜요 |
| 1.5에서 업그레이드한 뒤 온갖 오류가 나요 | 1.5 및 이전 버전은 pipx/pip로 설치했어요 | Agent에게 uv tool install --force와 GitHub 설치 주소를 실행하게 하고, 이어서 agent-reach setup을 실행해요. API 키와 설정은 그대로 유지돼요 |
| 샤오홍슈에서 갑자기 검색이 안 되고 로그인하라는 메시지가 나와요 | 로그인 상태가 만료됐어요 | Agent에게 “샤오홍슈 로그인이 만료됐어”라고 말하고, 안내에 따라 다시 로그인해요(부계정 사용을 권장해요) |
| X 채널이 될 때도 있고 안 될 때도 있어요 | twitter는 실험 채널이라 플랫폼의 크롤링 방지가 더 엄격해요 | 먼저 상태를 확인해서 실제로 안 되는지 봐요. 안 되면 프로젝트 업데이트를 기다렸다가 agent-reach update를 실행하고, GitHub Issues에 피드백을 남겨도 좋아요 |
Agent-Reach 비용과 모델 선택
Agent-Reach 자체는 무료이고 플랫폼 API 비용도 없어요. 실제로 비용이 발생하는 부분은 Agent-Reach를 실행하는 Agent가 대규모 언어 모델을 호출할 때 소모하는 토큰이에요. 아래는 2026-10-26에 APIYI apiyi.com 문서 센터에서 확인한 세 모델의 가격으로, 단위는 달러/백만 토큰이에요. 모델과 가격은 플랫폼의 모델 목록을 기준으로 해요.
| 모델 | 입력 | 출력 | 캐시 읽기 | 적합한 Agent-Reach 작업 | 사용 가능 플랫폼 |
|---|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | 장문 리서치 보고서, 다중 출처 정보 교차 검증 | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | 일상적인 크로스 플랫폼 리서치의 주력 선택 | APIYI |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | 대량 요약, 단순 검색, 상태 점검 | APIYI |
대략적인 추정치를 하나 들어볼게요(실측은 아니에요). 4개 플랫폼에 걸친 리서치 한 번에 Agent가 긴 게시글 5개와 검색 결과 20개를 읽는다면, 입력은 약 3만~6만 토큰, 출력은 약 3천~6천 토큰 정도예요. claude-sonnet-5-5 기준으로 계산하면 1회당 대략 0.1달러 안팎이고, claude-haiku-5-5로 바꾸면 1센트가 조금 안 되며, claude-opus-5-5로 바꾸면 약 0.2~0.35달러 사이가 돼요.
선택 기준은 아주 간단해요. 먼저 sonnet으로 전체 흐름을 돌려보고, 결과 품질을 보고 opus로 올릴지 결정하세요. 반복적인 대량 작업은 haiku에 맡기면 돼요. Agent-Reach가 돌려주는 건 이미 정리된 구조화 콘텐츠라서, Agent가 원본 웹페이지를 직접 읽게 하는 것보다 토큰을 아낄 수 있어요. 오래 쓸수록 캐시 읽기 가격 덕분에 절약되는 부분도 있으니 참고하세요.
자주 묻는 질문 FAQ
Q1: Agent-Reach는 정말 완전히 무료인가요?
Agent-Reach 자체는 무료이고 MIT 오픈소스이며, 각 플랫폼도 API 요금을 받지 않아요. 여러분이 지불해야 할 것은 Agent가 대규모 언어 모델을 호출하는 토큰 비용뿐인데, 앞서 추정한 대로 4개 플랫폼을 넘나드는 리서치 한 번에 sonnet급 모델을 쓴다면 대략 0.1달러 안팎이에요. 우선 가볍게 시험해보고 싶다면 APIYI apiyi.com에서 신규 사용자 무료 테스트 크레딧을 받아 첫 번째 작업을 돌려볼 수 있어요.
Q2: Agent가 제 계정으로 글을 올리거나, 좋아요를 누르거나, DM을 보내나요?
아니요. Agent-Reach는 읽기 전용 도구라서 검색하고 읽기만 할 뿐, 게시글이나 댓글, 좋아요, DM은 전혀 하지 않아요. 다만 읽기 전용이라고 해서 위험이 전혀 없는 건 아닌데, 플랫폼이 빈번한 읽기를 비정상 접근으로 판단할 수 있기 때문에 여전히 부계정 사용을 권장해요. 자세한 내용은 위험 안내 섹션을 참고하세요.
Q3: YouTube와 샤오위저우(小宇宙)의 음성-텍스트 변환은 어떻게 켜나요? Key를 Agent에게 보내야 하나요?
YouTube 음성 변환에는 Groq 또는 OpenAI Key가 필요하고, 샤오위저우에는 Groq Key가 필요해요. **Key를 채팅에 그대로 보내지 마세요.** 공식 요구사항에 따라 여러분의 터미널에서 `agent-reach configure groq-key`를 실행해 입력해야 해요. 확인 방법은 Agent에게 YouTube 영상 하나를 텍스트로 변환하게 했을 때, 반환된 JSON의 `ok`가 true이고 텍스트 내용이 있으면 성공이에요.
Q4: Agent-Reach는 어떤 모델과 조합할 때 가장 효과가 좋나요?
일상적인 리서치라면 claude-sonnet-5-5로 시작하는 걸 권장해요. 여러 출처의 내용을 이해하는 능력과 비용 통제 사이에서 비교적 균형이 잡혀 있거든요. 더 깊은 분석이 필요할 때는 claude-opus-5-5로 전환하면 돼요. APIYI apiyi.com을 통하면 Key 하나로 이 모델들 사이를 오갈 수 있고, 모델 이름만 바꾸면 되지 인터페이스 주소는 바꿀 필요가 없어서 같은 리서치 작업을 그대로 두고 효과를 비교하기 편해요.
Q5: 이미 Claude Code에 설치했는데, 다른 Agent도 쓰게 하려면 어떻게 하나요?
이미 설치가 끝난 Agent에게 “다른 AI도 쓸 수 있게 해줘”라고 말하면 공유 설정을 알아서 처리해줘요. 모든 파일이 `~/.agent-reach/` 폴더에 통일해서 들어가 있기 때문에, 다른 Agent도 마찬가지로 명령 실행 권한이 켜져 있기만 하면 호출할 수 있어요. 확인 방법은 새 Agent에게 “Agent Reach 상태 확인해줘”라고 했을 때, 기존 Agent와 동일한 채널 목록이 반환되면 성공이에요.
Agent-Reach 튜토리얼 핵심 요점 Key Takeaways
- 한 줄 정의: Agent-Reach는 에이전트가 로그인 장벽 뒤에 있는 콘텐츠, 영상 속 콘텐츠, 그리고 중국 플랫폼의 콘텐츠까지 읽을 수 있게 해줘요.
- 설치 방법: 공식 install.md 링크를 에이전트에게 보내면, 에이전트가 알아서 uv와 agent-reach를 설치해요.
- 3단계 채널: 기본 5개는 바로 사용 가능하고, 선택형 6개는 한마디로 활성화할 수 있으며, 실험형 3개는 언제든 작동이 중단될 수 있어요.
- 읽기 전용 설계: 게시글이나 좋아요, DM을 보내지 않으며, 출력은 항상
ok필드가 포함된 JSON으로 통일돼요. - 계정 보안: 커뮤니티 도구는 비공식 API이므로 속도 제한이나 계정 정지가 발생할 수 있으니, 반드시 부계정을 사용하세요.
- 비용 통제 가능: 플랫폼 API 비용은 0이고, 주요 비용은 모델 토큰이며, APIYI apiyi.com을 통해 사용량 기반 요금제로 접속할 수 있어요.
정리
Agent-Reach 튜토리얼의 핵심 요점은 다음과 같아요:
- 실제 불편함을 해결: 일반 검색으로는 찾을 수 없는 샤오홍슈 노트, X 계정 동향, Bilibili 자막을 이제 에이전트가 직접 읽을 수 있어요.
- 진입 장벽 제로: 에이전트에게 한마디만 하면 설치가 끝나고, 이후 채널 추가, 계정 전환, 업그레이드도 모두 일상적인 말투로 가능해요.
- 위험은 스스로 인지해야: 이건 커뮤니티 오픈소스 도구이므로 부계정을 사용하고, 재사용되는 계정을 잘 확인하며, 결과에 대한 판단과 책임은 본인이 져야 해요.
먼저 기본 채널로 Bilibili나 GitHub 조사를 한 번 돌려보고, 각 단계의 검증이 모두 통과되는 걸 확인한 뒤에 필요에 따라 샤오홍슈, Reddit처럼 로그인이 필요한 채널을 추가하는 걸 권장해요.
모델이 필요하다면 APIYI apiyi.com을 이용하면 돼요.
📚 참고 자료
- Agent-Reach GitHub 저장소: 프로젝트 소스 코드, README 및 채널 안내
- 링크:
github.com/Panniantong/Agent-Reach -
설명: 유일하게 신뢰할 수 있는 설치 소스로, 채널 목록과 보안 안내는 이곳을 기준으로 해요
-
Agent-Reach 공식 설치 안내: Agent가 읽을 수 있도록 제공된 설치 문서
- 링크:
raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md -
설명: 이 글의 2단계에서 Agent에게 보내는 주소가 바로 이곳이에요
-
Agent-Reach GitHub Issues: 문제 피드백 채널
- 링크:
github.com/Panniantong/Agent-Reach/issues - 설명: 실험 채널이 작동하지 않거나 설치 오류가 발생할 때 여기서 검색하거나 피드백을 남길 수 있어요
작성자: APIYI 기술팀
기술 교류: APIYI 웹사이트 홈페이지에서 저희에게 연락해 주세요. 더 많은 자료는 docs.apiyi.com 문서 센터에서 확인할 수 있어요
