AI 에이전트에 인터넷 능력 한 번에 붙이는 오픈소스 '에이전트 리치' 깃허브 주목

AI 에이전트에 인터넷 접근 능력을 한 번에 붙여 주는 오픈소스 도구 '에이전트 리치(Agent Reach)'가 깃허브 트렌딩에 올랐다. 코드 작성이나 문서 수정은 잘하지만 웹에서 무언가를 찾아오라고 하면 막히는 AI 에이전트의 한계를 메우려는 프로젝트다.

개발자가 에이전트에 웹페이지 읽기, 유튜브 자막 추출, 트위터·레딧 검색 같은 기능을 붙이려면 플랫폼마다 유료 API, 차단 우회, 로그인 계정, 데이터 정제라는 문턱을 하나씩 넘어야 한다. 에이전트 리치는 이 선정·설정 작업을 대신 끝내 두어, 사용자가 에이전트에게 설치 안내 문서 링크를 한 줄 건네면 몇 분 만에 설정이 끝나도록 했다.

클로드 코드, 오픈클로, 커서, 윈드서프 등 명령줄을 실행할 수 있는 에이전트면 무엇이든 쓸 수 있다. 모든 도구가 오픈소스이고 모든 API가 무료라 완전 무료를 표방하며, 비용이 들 수 있는 부분은 서버에 배포할 때 필요한 월 1달러가량의 프록시뿐이고 개인 PC에서는 필요 없다.

별도 설정 없이 바로 쓸 수 있는 채널로는 임의의 웹페이지 읽기, 유튜브 자막 추출과 영상 검색, RSS·Atom 구독, 그리고 MCP로 연결돼 키가 필요 없는 전체 웹 의미 검색이 있다. 추가 설정을 하면 깃허브 비공개 저장소와 이슈·PR 작성, 트위터 검색·타임라인·게시, 레딧, 샤오훙수, 더우인, 링크드인, 비리비리 등이 풀린다.

레딧은 2024년부터 인증을 요구해 설치 후 쿠키 로그인이 필요하고, 쿠키가 필요한 플랫폼은 크롬 확장 프로그램으로 내보낸 쿠키를 에이전트에 전달해 설정한다. 쿠키와 토큰은 사용자 PC의 설정 파일에만 소유자만 읽고 쓸 수 있는 600 권한으로 저장되며 외부로 전송되지 않는다.

에이전트 리치는 프레임워크가 아니라 '스캐폴딩(발판)'을 표방한다. 설치가 끝나면 에이전트는 래퍼 계층을 거치지 않고 yt-dlp, twitter-cli, rdt-cli, gh CLI 같은 상위 도구를 직접 호출한다. 플랫폼마다 독립된 채널 파일 하나가 대응해, 마음에 들지 않으면 그 파일만 바꿔 끼우면 된다.

채널별로 쓰이는 상위 도구는 모두 기존 오픈소스 프로젝트다. 웹페이지는 9,800개 스타의 지나 리더, 영상 자막은 유튜브와 비리비리 등 1,800개 사이트를 다루는 15만 4,000 스타의 yt-dlp, 트위터는 2,100 스타의 twitter-cli, 레딧은 304 스타의 rdt-cli, RSS는 2,300 스타의 feedparser, 샤오훙수는 1,500 스타의 xhs-cli, 링크드인은 1,200 스타의 linkedin-scraper-mcp가 쓰인다.

설치 과정에서 에이전트의 스킬 디렉터리에 사용 안내를 담은 SKILL.md를 등록해, 이후 '트위터 검색'이나 '영상 보기' 같은 요청이 들어오면 에이전트가 어떤 상위 도구를 불러야 하는지 스스로 안다. agent-reach doctor 명령으로 각 채널의 연결 상태를 점검할 수 있고, 시스템을 자동으로 건드리지 않는 안전 모드(--safe)와 변경 없이 미리 보는 드라이런(--dry-run)도 제공한다.

다만 쿠키 로그인을 쓰는 트위터·샤오훙수 등은 스크립트 호출이 플랫폼에 탐지돼 계정이 정지될 위험이 있어, 주 계정 대신 전용 부계정을 쓰라고 권고한다. 제작자는 이 프로젝트가 순전히 '바이브 코딩'으로 만들어졌다며 자신이 매일 쓰고 있어 계속 유지보수하겠다고 밝혔다.