Panniantong/Agent-Reach

Agent Reach – AI 에이전트를 위한 원클릭 인터넷 기능 강화

개요 – Python 기반의 기능 계층으로, 모든 명령줄 기반 AI 에이전트(Claude Code, OpenClaw, Cursor, Windsurf 등)에 다양한 웹 서비스에 대한 즉시 사용 가능한 액세스 권한을 부여합니다. 각 플랫폼(YouTube 자막, Twitter 트윗, Reddit 게시물, GitHub 데이터, RSS 피드 등)에 가장 신뢰할 수 있는 도구를 검색, 설치 및 구성하며, 사이트의 API 변경이나 스크래핑 차단 시에도 라우팅을 최신 상태로 유지합니다.

중요성 – 현대의 에이전트는 코드를 작성하거나 프로젝트를 관리할 수 있지만, "온라인에서 무언가를 찾아봐"라는 요청을 받으면 어려움을 겪곤 합니다. Agent Reach는 수동으로 수행해야 하는 오류 발생 가능성이 높은 설정 작업(CLI 도구 설치, 쿠키 처리, 캡차 대응)을 제거하여 에이전트가 더 높은 수준의 작업에 집중할 수 있도록 합니다.

주요 기능

• 제로 구성 채널: 많은 인기 사이트(웹 페이지, YouTube, RSS, GitHub, LinkedIn 등) 지원.
• 로그인 필수 옵션 채널: Twitter/X, Reddit, Facebook, Instagram, 샤오홍슈(Xiaohongshu) 등은 간단한 "帮我配 XXX" 프롬프트로 활성화 가능. 도구가 쿠키 내보내기나 브라우저 세션 연결 절차를 안내합니다.
• 자동 백엔드 선택: 각 채널은 기본 및 대체 구현을 정의합니다(예: twitter-cli → OpenCLI → bird). CLI가 환경을 조사하여 첫 번째로 작동하는 백엔드를 선택하고 agent-reach doctor를 통해 결과를 보고합니다.
• 안전 우선 설치: agent-reach install은 사용자가 --system을 추가하지 않는 한 환경 확인만 수행합니다. 드라이런(dry-run) 모드에서는 설치될 내용을 정확히 확인할 수 있습니다.
• 로컬 전용 자격 증명 저장: 쿠키와 토큰은 ~/.agent-reach/config.yaml에 권한 600으로 저장되며, 외부로 전송되지 않습니다.
• 자가 진단: agent-reach doctor가 어떤 채널이 정상 작동하는지, 문제가 있을 경우 어떻게 수정해야 하는지 알려줍니다.
• 교차 에이전트 호환성: 셸 명령을 실행할 수 있는 모든 에이전트와 작동합니다. OpenClaw 사용자는 exec 도구 프로필을 활성화하기만 하면 됩니다.

사용 방법

1. 다음 한 줄의 지침을 에이전트 채팅에 복사하세요:

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

2. 에이전트가 설치 스크립트를 실행하여 다음을 수행합니다:
   • agent-reach CLI 설치(yt-dlp, feedparser 등 번들)
   • 필수 시스템 도구 확인(Node.js, gh CLI, mcporter)
   • SKILL.md 파일 등록(에이전트가 호출할 명령을 인식하도록 함)
3. 설치 후 에이전트에게 "이 링크 읽어 줘", "YouTube 영상 요약해 줘", "Reddit에서 … 검색해 줘"라고 요청하면 적절한 백엔드가 자동으로 호출됩니다.
4. 나중에 업데이트하려면 동일한 한 줄 프롬프트를 업데이트 URL과 함께 보내세요.

지원 플랫폼(요약)

플랫폼	즉시 사용 가능	추가 구성 필요
웹 페이지	✅ (Jina Reader)	—
YouTube	✅ (yt‑dlp subtitles)	—
RSS/Atom	✅ (feedparser)	—
GitHub (공개)	✅ (gh CLI)	비공개 저장소는 로그인 필요
Twitter/X	✅ (tweet fetch)	검색/타임라인은 로그인 필요
Reddit	✅ (post fetch)	전체 검색은 로그인 필요
Bilibili	✅ (bili‑cli)	—
Facebook / Instagram	✅ (OpenCLI)	로그인 필요
샤오홍슈	✅ (OpenCLI)	로그인 필요
LinkedIn	✅ (mcp‑server‑linkedin)	로그인 필요
기타 (Snowball, Boss직업 등)	✅ (특정 CLI)	수동 Chrome 세션 필요할 수 있음

설계 철학 – Agent Reach는 단순한 스크래퍼가 아니라 도구 선택, 설치, 상태 확인을 추상화하는 기능 계층입니다. 각 채널은 기본 및 대체 백엔드를 나열하는 작은 Python 모듈이며, doctor 명령이 이를 조사하여 활성 상태를 보고합니다. 백엔드가 중단되면(예: yt‑dlp가 Bilibili에 의해 차단됨), 프로젝트는 목록을 재정렬하기만 하면 되며 사용자가 코드를 변경할 필요는 없습니다.

보안 및 개인정보 보호

• 모든 쿠키/토큰은 사용자의 컴퓨터에만 저장되며, 저장소는 이를 전송하지 않습니다.
• --system이 전달되지 않는 한 설치 과정에서 시스템 파일이 수정되지 않습니다.
• README는 로그인 기반 채널 사용 시 계정 정지 위험에 대해 경고하며, 일회용 계정 사용을 권장합니다.

시작하기 – 저장소에는 다음이 포함되어 있습니다:

• docs/install.md 및 docs/update.md(에이전트에 입력할 URL).
• 플랫폼별 어댑터가 포함된 channels/ 디렉토리.
• CLI 명령: agent-reach install, agent-reach doctor, agent-reach uninstall.

대상 사용자 – 맞춤형 AI 어시스턴트를 구축하는 개발자, 데이터 수집을 위해 내부 에이전트를 배포하는 팀, 또는 스크래핑 코드를 작성하지 않고 에이전트가 웹을 탐색하게 하고 싶은 애호가.

---

위의 모든 정보는 프로젝트의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.