Panniantong/Agent-Reach

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Agent Reach – AI 에이전트를 위한 원클릭 인터넷 접근

무엇인가요 – 어떤 LLM 기반 "에이전트" (Claude Code, OpenClaw, Cursor, Windsurf 등)에도 웹페이지 읽기, YouTube 자막 가져오기, Reddit 질의, GitHub 데이터 추출, Twitter/X 스크래핑 등 다양한 인기 플랫폼에 대해 준비된 최신 방식을 제공하는 Python 기반 명령줄 유틸리티입니다. 이 도구는 크롤링이나 파싱을 직접 구현하지 않습니다. 대신 각 서비스에 최적의 오픈소스 도구를 자동 선택, 설치, 건강 상태 점검하고, 간단한 스킬 파일을 통해 에이전트에 연결합니다.

왜 필요할까 – 현대의 에이전트는 코드를 작성하거나 프로젝트를 관리할 수 있지만, "인터넷에서 찾아봐"라는 요청에는 막막해집니다. 각 사이트마다 일반적으로 다른 CLI 도구, API 키, 로그인 쿠키, 또는 불안정한 대안이 필요합니다. Agent Reach는 이러한 복잡한 설정을 추상화합니다. 단 하나의 자연어 명령어로

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

를 입력하면 에이전트는 필요한 바이너리를 자동으로 설치하고, 쿠키를 제공하면 인증 정보를 설정하며, SKILL.md를 등록하여 에이전트가 특정 요청에 대해 어떤 명령어를 호출해야 하는지 알 수 있도록 합니다.

주요 기능 (README에 설명됨)

제로 구성 채널 – 웹페이지, YouTube 자막, RSS/Atom 피드, 공개 GitHub 저장소 – 즉시 사용 가능.
선택적 로그인 필요 채널 (Twitter/X, Reddit, Facebook, Instagram, 소홍서, LinkedIn 등) – 에이전트가 쿠키 내보내기 또는 로그인 상태 설정을 안내합니다.
자동 백엔드 선택 – 각 플랫폼은 우선순위가 지정된 도구 목록을 가지고 있습니다 (예: twitter-cli → OpenCLI → bird). 첫 번째 기능이 완전한 백엔드가 사용되며, 문제가 생기면 agent-reach doctor에서 대체 방법을 보여줍니다.
자기 진단 기능 – agent-reach doctor는 어떤 채널이 건강한지, 어떤 백엔드가 활성화되어 있는지, 문제를 어떻게 해결할지 보고합니다.
보안 우선 설치 – 기본 install은 환경만 확인합니다. 실제 시스템 변경은 --system을 명시적으로 지정할 때만 발생합니다.
크로스 에이전트 호환성 – 특정 LLM에 종속되지 않고, 쉘 명령어를 실행할 수 있는 모든 에이전트와 호환됩니다.
오픈소스 및 무료 – MIT 라이선스, 하위 모든 도구는 오픈소스입니다. 원격 머신에서 에이전트를 실행하는 경우 유일한 비용은 저렴한 프록시 서버일 수 있습니다.

지원되는 플랫폼 (요약 보기)

플랫폼	즉시 사용 가능	추가 설정
웹페이지	✅	–
YouTube (자막)	✅	–
RSS/Atom	✅	–
GitHub (공개)	✅	–
Twitter/X (1개 트윗)	✅	쿠키 내보내기
Twitter/X (검색, 타임라인)	❌	`agent-reach configure twitter`
Reddit	❌	OpenCLI 또는 `rdt-cli`로 로그인
Facebook / Instagram	❌	OpenCLI (Chrome 세션)로 로그인
Bilibili	✅	–
LinkedIn	✅ (공개)	전체 프로필 접근을 위해 `agent-reach configure linkedin`
소홍서, 소우주 팟캐스트, 셰이큐안, V2EX 등	✅ (기본 기능)	선택적 인증 단계

작동 방식

설치 – pip install -e . (또는 제공된 설치 스크립트)로 agent-reach CLI를 추가합니다.
의존성 확인 – Node, gh CLI, mcporter 등이 설치되어 있는지 확인하고, 누락된 경우 설치를 제안합니다.
채널 등록 – channels/ 아래의 Python 모듈이 각 서비스의 선호 및 대체 백엔드를 선언합니다.
스킬 생성 – agent-reach install을 실행하면 타겟 에이전트의 스킬 디렉터리에 SKILL.md가 생성되어 자연어 의도를 적절한 쉘 명령어로 매핑합니다.
실행 시 – 에이전트는 SKILL.md를 읽고, 호출할 명령어를 결정합니다 (예: YouTube 자막은 yt-dlp), 실행하고 구조화된 결과를 LLM에 반환합니다.

보안 및 프라이버시

쿠키/토큰은 ~/.agent-reach/config.yaml에 로컬에 저장되며 600 권한으로 보호되며, 업로드되지 않습니다.
설치 프로그램은 --system을 명시하지 않으면 시스템 파일을 수정하지 않습니다.
드라이런 모드 (--dry-run)는 모든 작업이 수행되기 전에 표시합니다.
README는 로그인 쿠키 사용이 계정 정지 위험을 초래할 수 있다고 경고하며, 전용 일회용 계정 사용을 권장합니다.

일반적인 워크플로우

사용자: 이 링크를 봐줘
에이전트: (SKILL.md 읽기) → `curl https://r.jina.ai/URL` 실행

사용자: Reddit에서 LLM에 대한 논의를 찾아줘
에이전트: Reddit 설정을 요청 → 당신은 `agent-reach configure reddit` 실행
에이전트: 이후 브라우저 세션을 사용해 `opencli` 실행하고 게시물을 반환.

누가 사용할까

실시간 웹 데이터가 필요한 맞춤형 AI 어시스턴트를 개발하는 개발자.
내부 서버에 에이전트를 배포하는 팀으로, 웹 접근 기능을 단일하고 유지보수 가능한 방식으로 최신 상태로 유지하고 싶은 사람.
개인용 Claude/ChatGPT 스타일 봇에 스크래퍼를 작성하지 않고 인터넷을 탐색하게 하고 싶은 애호가.

시작하기

리포지토리 복제.
agent-reach install --env=auto 실행 (CLI 추가 및 의존성 확인).
1줄 설치 명령어를 에이전트의 채팅에 복사.
각 채널 확인을 위해 agent-reach doctor 사용.

결론 – Agent Reach는 LLM 에이전트가 현실 세계 데이터를 가져오기 위해 필요한 번거로운 설정 작업을 제거하는 실용적이고 오픈소스의 기능 계층입니다. AI 에이전트 생태계 내에 머물며, 관련 없는 튜토리얼이나 목록이 아니라, 프론티어 AI 도구의 범위에 완전히 포함됩니다.