← 블로그로
Ai약 12 분 읽기

Agent Reach는 에이전트가 스스로 들어가지 못하는 인터넷을 건네줍니다

게시일 2026년 11월 14일
Agent Reach는 에이전트가 스스로 들어가지 못하는 인터넷을 건네줍니다

검색 도구를 가진 코딩 에이전트는 블로그 글 하나는 찾아냅니다. 그런데 Xiaohongshu에서 어떤 스킨케어 제품에 대한 반응이 어떤지 물으면 실패하거나 답을 지어냅니다. Bilibili 영상 첫 4분에 무슨 말이 나왔는지 물으면 읽을 텍스트가 없습니다.

Agent Reach는 바로 그 틈을 겨냥해 만든 프로젝트입니다. 이번 주 GitHub trending 1위에 올랐고 지금 9,500 스타에 가깝습니다. 영어 한 줄 소개는 "give your agent eyes to see the entire internet"입니다. 중국어 소개가 더 정확한데, 에이전트가 혼자서는 닿지 못하는 인터넷의 일부에 손을 뻗게 한다는 뜻입니다.

MIT 라이선스이고 Python 3.10 이상이 필요하며 PyPI에는 없습니다. 마지막 항목이 README에 굵은 글씨로 적혀 있는 이유는 `agent-reach`라는 이름을 다른 사람이 PyPI에 먼저 등록했기 때문입니다.

실제로 무엇을 감싸고 있나

이 도구의 정체는 채널 라우터입니다. 나열된 플랫폼 뒤에 있는 스크레이퍼와 API 클라이언트를 설치하고 동작을 확인한 다음, 하나의 명령 형태로 묶어 줍니다.

agent-reach channels
agent-reach bilibili search "大模型"
agent-reach read https://www.v2ex.com/t/123

`read` 명령은 URL을 보고 어느 채널로 갈지 스스로 판단합니다. 실제로 써 보면 타이핑이 줄어드는 부분이 주로 여기입니다.

목록에는 채널이 14개 있습니다. 기본으로 켜져 있고 계정도 필요 없는 것이 6개입니다. Bilibili(검색, 영상 메타데이터, 인기, 자막. 자막은 로그인 필요), V2EX(인기, 노드, 글과 답글, 사용자), GitHub(저장소 검색, 저장소와 README 읽기, 이슈와 PR 및 댓글), YouTube(메타데이터, 검색, 자막, Groq나 OpenAI 키가 있으면 오디오 전사), 그리고 마지막 안전판으로 범용 웹 검색과 리더가 있습니다.

재미있는 데이터는 선택 채널 쪽에 있습니다. Xiaohongshu의 노트, 본문, 댓글. Xueqiu의 실시간 시세와 인기 글. BOSS Zhipin의 채용 공고와 직무 기술. Xiaoyuzhou의 팟캐스트 전사. LinkedIn의 공개 채용 글. Reddit의 글, 본문, 댓글, subreddit. X, Facebook, Instagram에는 experimental이라고 적혀 있는데, 스크레이핑 업계에서 이 단어는 플랫폼이 뭔가를 바꿀 때까지는 작동한다는 뜻입니다.

설치는 에이전트에게 보내는 한 문장

이 대목에서 이 프로젝트가 누구를 위한 것인지 드러납니다. README는 pip 한 줄로 시작하지 않습니다. 에이전트에 붙여 넣을 문장 하나로 시작합니다.

帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md

에이전트는 그 문서를 읽고 알아서 일합니다. `uv`가 없으면 설치하고, 그다음 프로그램과 각 채널 도구를 설치하고, 마지막으로 어떤 채널이 살아 있는지, 어떤 선택 채널을 더 붙일 수 있는지 보고합니다. 나중에 Xiaohongshu를 추가하는 것도 한 문장입니다. "add Xiaohongshu". 빼는 것도 한 문장이고, 뺄 때는 그 채널의 로그인과 도구까지 함께 지웁니다.

모든 것은 `~/.agent-reach/` 아래에 있습니다. 이 하나의 디렉터리에 모으는 것은 의도한 설계입니다. 에이전트는 열몇 군데에 절반만 설치된 의존성을 흩뿌려 두기 마련이고, 확실히 지우는 방법은 새 기기를 쓰는 것뿐입니다. 폴더가 하나면 업그레이드도 점검도 삭제도 명령 하나로 끝납니다. 두 번째 에이전트에 같은 폴더를 가리키게 하는 것만으로 같은 능력을 주는 것도 같은 이유입니다.

세션 문제, 솔직하게 적어 두면

사람들이 실제로 쓰고 싶은 플랫폼은 대부분 로그인 뒤에 있습니다. Agent Reach가 이걸 다루는 방식은 요약으로는 부족하고 원문을 읽어야 합니다.

어떤 사이트를 처음 쓸 때, 그 사이트에 대해 Chrome에 이미 있는 세션을 전용 브라우저로 복사합니다. 그 브라우저는 백그라운드에서 돌고 창을 띄우지 않습니다. 비밀번호 관리자는 읽지 않습니다. 원래 쓰던 브라우저는 건드리지 않습니다.

불합리한 문제에 대한 합리적인 엔지니어링 답입니다. 자동화 브라우저를 스크립트로 X나 Xiaohongshu에 로그인시키는 것은 차단으로 가는 지름길이라, 세션 재사용은 모두가 하는 방식입니다. README는 그 결과를 솔직하게 적습니다. 복사되는 것은 보통 주 계정이니 부계정으로 바꿔 넣으라고 권합니다. 방법은 보안 섹션에 있습니다.

여기서 두 가지가 따라옵니다. 첫째, Xiaohongshu 세션을 쥔 에이전트는 채널이 노출하는 범위 안에서 당신의 노트와 저장 항목, DM까지 읽을 수 있습니다. 둘째, 에이전트가 무슨 짓을 하든 속도 제한의 주체는 당신 계정이 됩니다. 검색을 200번 돌리는 루프는 당신 계정이 200번 검색하는 일입니다.

두 문제 모두 이 프로젝트만의 것은 아닙니다. 설치는 에이전트에게 하는 한 문장일 뿐일 때 이 문제들은 더 쉽게 무시됩니다. README가 경고를 놓칠 수 없는 자리에 둔 이유가 그것입니다.

중국 플랫폼이 진짜 목표인 이유

영어권 개발자에게 가장 눈에 띄는 기능은 Reddit일 겁니다. 이 프로젝트의 실제 사용자에게는 목록의 중국 쪽 절반입니다.

범용 웹 검색은 중국 소셜 플랫폼에서 특유의 약점을 보입니다. 공개되어 링크할 수 있는 페이지만 색인하니 사람들이 신경 쓰는 콘텐츠 대부분은 빠집니다. Xiaohongshu 노트에 무슨 내용이 있는지도 모릅니다. 그 콘텐츠는 로그인 장벽 뒤에서 클라이언트가 그려 내기 때문입니다. 중국 소비자 심리를 조사해 달라고 범용 검색에 맡기면 마케팅 블로그 3개를 요약해서 이게 트렌드라고 보고합니다.

나머지 절반은 Bilibili 자막입니다. 40분짜리 중국어 기술 발표는 누군가 전사하지 않으면 에이전트에게 보이지 않습니다. 그런데 플랫폼에는 이미 자막이 있습니다. 그걸 꺼내면 영상이 텍스트가 되고, 텍스트는 에이전트가 추론할 수 있는 유일한 형식입니다.

지난 몇 달 동안 이 블로그를 위해 중국 플랫폼에서 조사를 돌려 왔는데, 표준 도구 조합이 정확히 이 지점들에서 무너집니다. Weibo는 파싱해도 아무것도 남지 않는 HTML을 돌려주고, Zhihu는 인증을 요구하고, Bilibili는 자동화처럼 보이는 요청에 412를 돌려줍니다. 동작하는 클라이언트를 묶어 주고 채널별 상태까지 보고하는 프로젝트라면, 이 일을 해 본 사람은 무엇을 푸는지 즉시 알아봅니다.

슬로건에 없는 트레이드오프

소개 문구에는 "Zero API fees"라고 적혀 있습니다. 좁은 의미에서는 맞습니다. 호출마다 돈을 내지는 않습니다. 대신 다른 화폐로 지불합니다.

스크레이핑은 플랫폼의 관용도를 물려받는다는 뜻입니다. 사이트가 마크업을 바꾸면 채널은 끊깁니다. README가 X, Facebook, Instagram을 experimental로 분류한 이유도 이들의 봇 방어가 계속 움직이기 때문입니다. 스크레이핑 채널 위에 세운 조사 파이프라인의 가용성은 API보다 취미 프로젝트에 가깝고, 하필 가장 필요 없는 순간에 멈춥니다.

답이 긁어온 화면의 편향을 안고 온다는 뜻이기도 합니다. Xiaohongshu 검색은 랭킹이 선호하는 것을 돌려줍니다. 성과를 낸 것의 표본입니다. 여론의 분포와는 다릅니다. 상위 노트 20개를 읽고 요약하는 에이전트는 랭킹에 들어가는 글을 쓰는 사람들의 합의를 보고합니다. 그 집단은 들리는 것보다 좁습니다.

그래서 이 도구는 원료 공급처로 다루는 게 맞습니다. 신탁으로 기대하면 어긋납니다. 그렇게 다뤄야 어떤 채널이 쓰레기를 돌려주기 시작한 것도 알아챌 수 있습니다.

내가 쓴다면 어디에

세 가지입니다. 확신이 큰 순서로 적습니다.

컨퍼런스 발표와 제품 데모에서 자막을 뽑는 일. 전사본은 ground truth이고 플랫폼이 이미 계산해 둔 것입니다.

이미 링크를 가진 특정 스레드나 노트를 읽는 일. 답이 정해진 검색 작업이라 표본 문제가 없습니다.

어떤 주장을 두 시장에서 교차 확인하는 일. 어떤 도구의 반응을 쓴다면 같은 주에 Reddit 스레드와 Xiaohongshu 노트를 읽으면 분포가 두 개 나옵니다. 보통 그 차이가 기사가 됩니다.

하지 않을 일은 열린 질문을 던지고 요약을 믿는 것입니다. 이 채널들은 가져오는 데는 능하고 대표하는 데는 서툽니다. 그리고 에이전트는 자기가 둘 중 무엇을 했는지 알려주지 않습니다.

관련 글