👁️ Agent Reach

AI 에이전트가 인터넷 전체에 접근할 수 있도록 한 번에 설정해 드립니다

빠른 시작 · 한국어 · 中文 · English · 日本語 · 지원 플랫폼 · 설계 철학

Agent Reach가 필요한 이유

AI 에이전트는 이미 인터넷에 접근할 수 있습니다 — 하지만 "인터넷에 접속할 수 있다"는 것은 시작에 불과합니다.

가장 가치 있는 정보는 소셜 미디어와 특화된 플랫폼에 분포되어 있습니다: Twitter 토론, Reddit 피드백, YouTube 튜토리얼, XiaoHongShu 리뷰, Bilibili 비디오, GitHub 활동... 여기가 정보 밀도가 가장 높은 곳이지만, 각 플랫폼은 고유한 진입장벽이 있습니다:

에이전트를 이 플랫폼에 연결하려면 도구를 찾고, 의존성을 설치하고, 설정을 디버깅해야 합니다 — 하나씩 직접.

Agent Reach는 이를 하나의 명령으로 바꿉니다:

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

이 명령을 에이전트에 복사해서 붙여넣으세요. 몇 분 뒤에는 트윗을 읽고, Reddit을 검색하고, Bilibili를 볼 수 있게 됩니다.

이미 설치하셨나요? 한 번에 업데이트하세요:

Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

✅ 시작하기 전에 알면 좋은 것들

지원 플랫폼

설정 단계: 없음 = 설치 후 바로 사용 · 자동 = 설치 시 처리 · mcporter = MCP 서비스 필요 · Cookie = 브라우저에서 내보내기 · 프록시 = 월 $1

빠른 시작

이 명령을 AI 에이전트(Claude Code, OpenClaw, Cursor 등)에 입력하세요:

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

에이전트가 자동으로 설치하고, 환경을 감지하고, 준비된 항목을 알려줍니다.

🔄 이미 설치하셨나요? 한 번에 업데이트:

Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto           # 읽기 전용 확인 (기본값)
agent-reach install --env=auto --system  # 시스템 변경을 명시적으로 승인한 경우에만

npx skills add Panniantong/Agent-Reach@agent-reach

별도 설정 없이 바로 사용

별도의 설정이 필요 없습니다. 에이전트에게 요청하기만 하면 됩니다:

• "이 링크 읽어줘" → 모든 웹 페이지에 대해 curl https://r.jina.ai/URL
• "이 GitHub 저장소는 무엇인가요?" → gh repo view owner/repo
• "이 비디오는 무엇을 다루나요?" → 자막을 위해 yt-dlp --dump-json URL
• "이 트윗 읽어줘" → TWITTER_AUTH_TOKEN / TWITTER_CT0 설정 후 twitter tweet URL
• "이 RSS 구독해줘" → 피드 파싱을 위해 feedparser
• "GitHub에서 LLM 프레임워크 검색" → gh search repos "LLM framework"

기억할 명령이 없습니다. 에이전트가 SKILL.md를 읽고 무엇을 호출할지 알고 있습니다.

필요할 때 설정

사용하지 않나요? 설정하지 마세요. 모든 단계는 선택 사항입니다.

🍪 Cookies — 무료, 2분

에이전트에 "Twitter 쿠키 설정 도와줘"라고 말하세요. Cookie-Editor 수동 내보내기 절차를 안내합니다. 저장한 값은 agent-reach doctor가 명시적 자격 증명의 존재 여부를 확인할 때만 사용하며, doctor는 twitter status를 실행하지 않습니다. 직접 실행하는 twitter 프로세스에는 TWITTER_AUTH_TOKEN과 TWITTER_CT0를 명시적으로 전달해야 합니다.

🌐 Proxy — 월 $1, 서버 전용

대부분의 사용자는 프록시가 필요 없습니다. 네트워크에서 Reddit/Twitter가 차단된 경우에만 프록시를 설정하세요. Bilibili는 bili-cli를 사용합니다.

Reddit은 이제 프록시 없이 rdt-cli를 통해 무료로 작동합니다. 로컬 컴퓨터는 Bilibili에도 프록시가 필요 없습니다.

한눈에 보는 상태

$ agent-reach doctor

👁️  Agent Reach 상태
========================================

✅ 사용 가능:
  ✅ GitHub 저장소 및 코드 — 공개 저장소 읽기 및 검색 가능
  ✅ YouTube 비디오 자막 — yt-dlp
  ✅ Bilibili 검색 및 비디오 정보 — bili-cli (자막은 OpenCLI)
  ✅ RSS/Atom 피드 — feedparser
  ✅ 웹 페이지 (모든 URL) — Jina Reader API

🔍 검색 (무료 Exa key로 잠금 해제):
  ⬜ 웹 시맨틱 검색 — exa.ai에서 무료 key 발급

🔧 설정 가능:
  ⚠️  Twitter/X — doctor는 명시적 자격 증명의 존재만 확인하며, 업스트림 CLI에는 환경 변수가 필요
  ✅ Reddit 글 및 댓글 — rdt-cli를 통한 검색 및 읽기 (무료, 프록시 없음)
  ⬜ XiaoHongShu 노트 — OpenCLI는 기존 세션만 사용하며, 그 외에는 Cookie-Editor로 MCP/기존 도구 설정

상태: 6/9 채널 사용 가능

설계 철학

Agent Reach는 스캐폴딩(scaffolding) 도구이지, 프레임워크가 아닙니다.

새 에이전트를 실행할 때마다 도구를 찾고, 의존성을 설치하고, 설정을 디버깅하는 데 시간을 보내게 됩니다 — Twitter는 무엇으로 읽나요? Reddit 차단을 어떻게 우회하나요? YouTube 자막은 어떻게 추출하나요? 매번 동일한 작업을 반복해야 합니다.

Agent Reach는 한 가지 간단한 작업을 수행합니다: 도구 선택 및 설정 결정을 대신 해줍니다.

설치 후, 에이전트는 업스트림 도구(twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI 등)를 직접 호출합니다 — 중간에 래퍼 계층이 없습니다.

🔌 모든 채널은 플러그인 가능

각 플랫폼은 업스트림 도구에 매핑됩니다. 마음에 안 드나요? 교체하세요.

channels/
├── web.py          → Jina Reader     ← Firecrawl, Crawl4AI로 교체...
├── twitter.py      → twitter-cli      ← 공식 API로 교체...
├── youtube.py      → yt-dlp          ← YouTube API, Whisper로 교체...
├── github.py       → gh CLI          → REST API, PyGithub로 교체...
├── bilibili.py     → bili-cli ▸ OpenCLI ▸ 검색 API (yt-dlp는 412 차단으로 폐기)
├── reddit.py       → OpenCLI ▸ rdt-cli (로그인 상태 필요)
├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py     → linkedin-mcp    ← LinkedIn API로 교체...
├── rss.py          → feedparser      ← atoma로 교체...
├── exa_search.py   → mcporter MCP    ← Tavily, SerpAPI로 교체...
└── __init__.py     → 채널 레지스트리 (doctor 검사용)