Agent-Reach — CLI 하나로 AI 에이전트에 웹 검색·읽기 기능 연결하기

AI 요약

Agent-Reach는 AI 에이전트가 웹을 검색하고 콘텐츠를 읽도록 연결 환경을 준비하는 CLI입니다. 여러 플랫폼의 도구를 하나씩 찾아 설치하고 설정하는 대신, 현재 사용할 수 있는 경로를 선택하고 설치 상태를 진단합니다. 실제 데이터 수집을 감싸는 별도 추상화 계층을 만들지는 않습니다. 에이전트가 Jina Reader, gh CLI, yt-dlp 같은 상위 도구를 직접 실행합니다.

설치와 진단

README는 Claude Code, OpenClaw, Cursor, Windsurf 등 셸 명령을 실행할 수 있는 에이전트에서 사용할 수 있다고 안내합니다. 설치는 에이전트에게 제공된 설치 문서 링크를 전달하는 방식으로 시작합니다. 기본 설치 명령은 환경만 검사하며 시스템 패키지를 설치하거나 설정 파일을 쓰지 않습니다. 외부 도구 설치와 에이전트 설정 변경은 --system을 명시해야 진행합니다. --dry-run으로 작업 내용을 미리 확인하고, agent-reach doctor로 플랫폼별 연결 상태와 현재 사용 중인 백엔드를 점검합니다.

각 플랫폼에는 우선 경로와 대체 경로를 순서대로 지정합니다. 진단 과정에서 명령어가 있는지만 확인하지 않고 후보 백엔드가 실제로 작동하는지 시험합니다. 우선 경로가 고장 나면 대체 경로를 확인하고, 복구 방법을 안내합니다. 백엔드를 바꿀 때는 채널별 목록 순서를 조정하는 방식이며, README는 연결 방식이 바뀌어도 사용자가 다시 설정할 필요를 줄이는 것을 설계 목표로 제시합니다.

플랫폼별 연결 경로

별도 설정 없이 쓸 수 있는 경로로는 Jina Reader를 이용한 웹페이지 읽기, yt-dlp를 이용한 YouTube 자막 추출과 검색, feedparser를 이용한 RSS·Atom 처리 등이 있습니다. 공개 GitHub 저장소는 gh CLI로 읽고 검색합니다. Exa를 통한 전체 웹 의미 검색은 mcporter의 MCP 연결을 이용하며, README는 별도 API 키 없이 설정한다고 안내합니다.

로그인 상태나 추가 설정이 필요한 플랫폼도 있습니다. Twitter/X는 단일 게시물 읽기와 검색·타임라인 접근을 구분하며, 검색에는 쿠키 설정이 필요합니다. Reddit은 익명 접근 경로가 막혀 로그인 상태가 필요하다고 설명합니다. Facebook과 Instagram은 데스크톱에서 OpenCLI가 기존 Chrome 로그인 세션을 사용합니다. 샤오홍슈는 OpenCLI가 사용자가 이미 보유한 Chrome 세션을 이용하거나, 다른 도구에 Cookie-Editor로 직접 내보낸 쿠키를 설정하는 경로를 안내합니다. LinkedIn, Boss直聘, 雪球, 小宇宙播客 등도 각각 별도 설정이 필요한 기능을 포함합니다.

보안과 제약

쿠키와 토큰은 ~/.agent-reach/config.yaml에 저장하고 파일 권한을 소유자만 읽고 쓸 수 있는 600으로 설정한다고 README는 설명합니다. 자격 증명을 서버로 보내지 않는다는 점도 명시합니다. 다만 쿠키를 이용해 로그인하는 플랫폼은 스크립트나 API 호출을 탐지해 계정을 제한할 수 있고, 쿠키 자체가 로그인 권한과 같으므로 전용 계정을 쓰라고 경고합니다. Twitter 쿠키는 설정 확인 용도로 저장되며, 상위 Twitter 명령을 실행할 때는 현재 프로세스 환경에 TWITTER_AUTH_TOKEN과 TWITTER_CT0를 명시해야 한다고 안내합니다.

OpenClaw에서는 셸 실행 권한이 필요합니다. 기본 도구 설정으로 명령을 실행하지 못하면 tools.profile을 coding으로 바꾸고 Gateway를 재시작해야 합니다. 또한 README는 Bilibili에서 yt-dlp가 차단된 사례를 들어 bili-cli 등을 대체 경로로 제시합니다. 플랫폼 정책이나 차단 방식이 바뀌면 연결 방법도 달라질 수 있으므로, 진단 명령으로 현재 상태를 확인하는 구조입니다.

원문: GitHub / 번역·요약: Trawling