agent-reach

Agent Reach(agent-reach)는 AI Agent를 위한 인터넷 접속 기능 계층으로, Agent가 한 문장의 자연어 명령으로 도구 선정, 설치, 점검, 라우팅 구성을 완료하는 것을 목표로 합니다. 프로젝트는 MIT 라이선스로 오픈소스이며 Python 3.10+를 요구합니다. 핵심 사상: Agent Reach 자체는 각 플랫폼의 읽기 로직을 직접 캡슐화하지 않고, Agent가 상위 도구(예: yt-dlp, gh CLI, feedparser, Jina Reader, OpenCLI, twitter-cli, bili-cli 등)를 직접 호출하며, Agent Reach는 "각 플랫폼에서 현재 사용 가능한 접속 방식"을 유지 관리하고 SKILL.md를 생성하여 Agent가 사용하도록 합니다. 각 채널은 "우선 + 대체"의 순서 있는 백엔드 목록으로 설계되어, 설치 또는 진단 시 실제로 가용성을 탐지하고, 특정 선행 백엔드가 실패하면 다음으로 전환하며, 사용자는 `agent-reach doctor`를 통해 각 채널 상태와 현재 적용된 라우팅을 확인할 수 있습니다. 빠른 사용: 설치 지침(docs/install.md 읽기)을 shell 명령 실행을 지원하는 Agent(예: Claude Code, OpenClaw, Cursor, Windsurf)에게 보내면, Agent가 단계별로 agent-reach CLI를 설치하고 Node.js, gh CLI, mcporter 등 기본 의존성을 확인하며, 명시적 승인 하에 Agent의 skills 디렉터리에 기록합니다. 기본 안전: `agent-reach install`은 환경을 읽기 전용으로 점검하고 시스템을 자동 수정하거나 구성을 기록하지 않습니다. 명시적으로 `--system`을 전달해야만 시스템 의존성을 설치하고 구성을 기록하며, 별도로 `--dry-run`으로 모든 작업을 미리 볼 수 있습니다. 업데이트 역시 한 문장의 명령으로 완료할 수 있습니다. 이미 연동된 채널은 다음과 같습니다: 웹 읽기(Jina Reader), YouTube 자막 추출 및 영상 검색(yt-dlp), RSS/Atom 읽기(feedparser), 전역 시맨틱 검색(Exa via mcporter), GitHub(gh CLI, 저장소 읽기, 검색 포함, 구성 후 비공개 저장소, Issue/PR 지원), Twitter/X 트윗 읽기 및 검색, B站 검색 및 영상 상세(bili-cli 등), Reddit 검색 및 게시물 읽기, Facebook 페이지 및 Feed, Instagram 사용자 및 게시물, 小红书 검색 및 읽기, LinkedIn 프로필 및 채용 검색, V2EX, 雪球, 小宇宙 팟캐스트(Whisper 전사) 등. 일부 채널은 제로 구성으로 바로 사용 가능하며, 로그인 상태가 필요한 채널은 Agent가 사용자를 안내하여 구성을 완료합니다. 예를 들어 Cookie-Editor를 통해 수동으로 Cookie를 내보내거나, 데스크톱 브라우저의 기존 로그인 세션을 재사용합니다. 보안 및 개인정보: Cookie/Token은 로컬 `~/.agent-reach/config.yaml`(파일 권한 600)에 저장되며, 업로드되거나 외부로 전송되지 않습니다. 코드와 의존 도구는 모두 오픈소스로 검토 가능합니다. 프로젝트는 명확히 경고합니다: Cookie 로그인을 사용하는 플랫폼은 플랫폼에 탐지되어 계정이 정지될 위험이 있으므로, 주 계정이 아닌 전용 부계정을 사용할 것을 권장합니다. `agent-reach uninstall`은 로컬 구성, 각 Agent의 skill 파일 및 MCP 구성을 제거할 수 있으며, `--dry-run` 미리보기와 `--keep-config`로 구성을 보존하여 재설치를 지원합니다. 설계 정체성에서 Agent Reach는 "기능 계층"이지 또 하나의 구체적 도구가 아닙니다: 하위 읽기는 Agent가 상위 도구를 직접 호출하여 완료하고, Agent Reach는 선정, 설치, 점검, 라우팅을 담당하여 플랫폼 인터페이스, 안티 크롤링 전략 및 CLI 도구가 지속적으로 변화하는 상황에 대응합니다.