Panniantong/Agent-Reach: 당신의 AI Agent에 인터넷 능력을 한 번에 장착하세요

당신의 AI Agent에 인터넷 능력을 한 번에 장착하세요

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

AI Agent는 이미 코드를 작성하고, 문서를 수정하며, 프로젝트를 관리할 수 있습니다. 하지만 인터넷에서 무언가를 찾아보라고 하면 길을 잃고 맙니다:

• 📺 "이 YouTube 튜토리얼이 무엇을 설명하는지 봐줘" → 볼 수 없음, 자막을 가져올 수 없음
• 🐦 "트위터(Twitter)에서 사람들이 이 제품을 어떻게 평가하는지 검색해줘" → 검색 불가, Twitter API는 유료임
• 📖 "Reddit에서 누군가 똑같은 버그를 겪었는지 확인해줘" → 403 Forbidden, 서버 IP 차단됨
• 📕 "샤오홍슈(小红书)에서 이 제품의 평판을 확인해줘" → 열 수 없음, 로그인이 필수임
• 📺 "Bilibili(B站)에 기술 영상이 있는데, 요약해줘" → 연결 불가, 해외/서버 IP 차단됨
• 🔍 "인터넷에서 최신 LLM 프레임워크 비교를 검색해줘" → 쓸만한 검색 도구가 없음, 유료이거나 품질이 낮음
• 🌐 "이 웹페이지에 뭐라고 적혀 있는지 봐줘" → HTML 태그 뭉치만 긁어옴, 도저히 읽을 수 없음
• 📦 "이 GitHub 저장소는 무엇을 위한 건가요? Issue에는 뭐라고 적혀 있나요?" → 사용은 가능하지만 인증 설정이 매우 번거로움
• 📡 "이 RSS 피드들을 구독하고 업데이트가 있으면 알려줘" → 직접 라이브러리를 설치하고 코드를 짜야 함

이것들은 구현하기 어렵지 않지만, 직접 설정을 만져야 하는 번거로움이 있습니다

각 플랫폼마다 고유한 장벽이 있습니다. 유료 API, 우회해야 하는 차단, 로그인해야 하는 계정, 정제해야 하는 데이터 등 말이죠. 하나하나 시행착오를 겪으며 도구를 설치하고 설정을 조정해야 합니다. Agent가 트위터 하나를 읽게 만드는 데에도 한참의 시간이 걸립니다.

Agent Reach는 이 과정을 한 문장으로 만듭니다:

Agent Reach를 설치해줘: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

당신의 Agent에게 복사해 주면, 몇 분 안에 트위터를 읽고, Reddit을 검색하며, YouTube를 보고, 샤오홍슈를 탐색할 수 있게 됩니다.

이미 설치하셨나요? 업데이트도 한 문장이면 됩니다:

Agent Reach를 업데이트해줘: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

⭐

이 프로젝트를 Star 해주세요. 저희는 각 플랫폼의 변화를 지속적으로 추적하고 새로운 채널을 연결할 것입니다. 당신이 직접 지켜볼 필요는 없습니다. 플랫폼이 차단하면 저희가 수정하고, 새로운 채널이 생기면 저희가 추가하겠습니다.

💰 완전 무료 |
모든 도구는 오픈 소스이며, 모든 API는 무료입니다. 유일하게 비용이 발생할 수 있는 것은 서버 프록시(월 $1)뿐이며, 로컬 컴퓨터에서는 필요하지 않습니다 |
🔒 개인정보 보호 및 보안 |
Cookie는 오직 당신의 로컬에만 존재하며, 업로드하거나 외부로 전달하지 않습니다. 코드는 완전히 오픈 소스이므로 언제든 검토할 수 있습니다 |
🔄 지속적인 업데이트 |
기저 도구(yt-dlp, twitter-cli, rdt-cli, Jina Reader 등)를 정기적으로 추적하여 최신 버전으로 업데이트하므로, 당신이 직접 신경 쓸 필요가 없습니다 |
🤖 모든 Agent와 호환 |
Claude Code, OpenClaw, Cursor, Windsurf…… 명령줄(CLI)을 실행할 수 있는 모든 Agent에서 사용할 수 있습니다 |
🩺 자체 진단 기능 |
agent-reach doctor 명령어 하나로 무엇이 작동하고 무엇이 작동하지 않는지, 어떻게 수정해야 하는지 알려줍니다

플랫폼	즉시 사용 가능	설정 후 잠금 해제	설정 방법
🌐 웹 페이지	모든 웹 페이지 읽기	—	설정 불필요
📺 YouTube	자막 추출 + 비디오 검색	—	설정 불필요
📡 RSS	모든 RSS/Atom 피드 읽기	—	설정 불필요
🔍 전방위 검색	—	전방위 시맨틱 검색 (Semantic Search)	자동 설정 (MCP 연동, 무료 및 Key 불필요)
📦 GitHub	공개 저장소 읽기 + 검색	프라이빗 저장소, Issue/PR 제출, Fork	Agent에게 "GitHub 로그인을 도와줘"라고 말하기
🐦 Twitter/X	단일 트윗 읽기	트윗 검색, 타임라인 탐색, 트윗 게시	Agent에게 "Twitter 설정을 도와줘"라고 말하기
📺 Bilibili	로컬: 자막 추출 + 검색	서버에서도 사용 가능	Agent에게 "프록시 설정을 도와줘"라고 말하기
📖 Reddit	검색 + 게시글 및 댓글 읽기 (rdt-cli 이용)	Cookie	로그인 인증 필요 (rdt login), rdt-cli 상세 내용 참조
📕 Xiaohongshu	—	읽기, 검색, 게시글 작성, 댓글, 좋아요	Agent에게 "Xiaohongshu 설정을 도와줘"라고 말하기
🎵 Douyin	—	비디오 분석, 워터마크 없는 다운로드 링크 획득	Agent에게 "Douyin 설정을 도와줘"라고 말하기
💼 LinkedIn	Jina Reader로 공개 페이지 읽기	프로필 상세, 회사 페이지, 채용 정보 검색	Agent에게 "LinkedIn 설정을 도와줘"라고 말하기
💬 WeChat Official Account	검색 + 공식 계정 기사 읽기 (전체 Markdown)	—	설정 불필요
📰 Weibo	실시간 검색, 콘텐츠/사용자/주제 검색, 사용자 동향, 댓글	—	설정 불필요
💻 V2EX	인기 게시글, 노드 게시글, 게시글 상세+답글, 사용자 정보	—	설정 불필요
📈 Xueqiu	주식 시세, 주식 검색, 인기 게시글, 인기 주식 순위	—	Agent에게 "Xueqiu 설정을 도와줘"라고 말하기
🎙️ Xiaoyuzhou Podcast	—	팟캐스트 오디오 텍스트 변환 (Whisper 전사, 무료 Key)	Agent에게 "Xiaoyuzhou Podcast 설정을 도와줘"라고 말하기

설정 방법을 모르겠나요? 문서를 찾아볼 필요 없습니다. Agent에게 직접 "XXX 설정을 도와줘"라고 말하세요. Agent가 무엇이 필요한지 알고 단계별로 안내할 것입니다. 🍪 Cookie가 필요한 플랫폼(Twitter, Xiaohongshu 등)의 경우,

Chrome 확장 프로그램인 Cookie-Editor를 사용하여 Cookie를 내보낸 후, Agent에게 전달하여 설정하는 것을 권장합니다. 프로세스는 동일합니다: 브라우저 로그인 → Cookie-Editor로 내보내기 → Agent에게 전달. QR 코드 스캔보다 더 간단하고 신뢰할 수 있습니다. 🔒 Cookie는 오직 로컬에만 존재하며, 업로드되거나 외부로 유출되지 않습니다. 코드는 완전히 오픈 소스이므로 언제든 검토할 수 있습니다. 💻 로컬 컴퓨터에는 프록시가 필요하지 않습니다. 프록시는 서버에 배포할 때만 필요합니다 (월 약 $1).

⚠️ OpenClaw 사용자는 먼저 exec 권한이 활성화되어 있는지 확인하십시오. Agent Reach는 Agent가 쉘(shell) 명령어를 실행하는 데 의존하므로 (pip install, mcporter, messaging 도구 설정 등), 권한이 없으면 명령을 실행할 수 없습니다. 설치 전에 exec 권한을 먼저 활성화하십시오: openclaw config set tools.profile "coding" 또는 ~/.openclaw/openclaw.json 파일에서 "tools": { "profile": "coding" }로 설정하십시오. 설정 후 Gateway를 재시작(openclaw gateway restart)하고 새 대화를 시작하면 됩니다. 다른 플랫폼(Claude Code, Cursor, Windsurf 등)은 이 제한을 받지 않습니다.

다음 문장을 당신의 AI Agent(Claude Code, OpenClaw, Cursor 등)에게 복사하여 붙여넣으세요:

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

이게 끝입니다. 나머지 모든 작업은 Agent가 스스로 완료할 것입니다.

🔄

이미 설치되어 있나요? 업데이트도 한 문장이면 충분합니다: 帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

🛡️

보안이 걱정되시나요? 안전 모드(Safe Mode)를 사용할 수 있습니다. 시스템 패키지를 자동으로 설치하지 않고 무엇이 필요한지만 알려줍니다: 帮我安装 Agent Reach（安全模式）：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md 安装时使用 --safe 参数

이것이 무엇을 하나요? (클릭하여 확장)

CLI 도구 설치—pip install

agent-reach 설치 완료

시스템 의존성 설치 — 명령줄에서 실행 — Node.js, gh CLI, mcporter, twitter-cli, rdt-cli 등을 자동으로 감지하여 설치
검색 엔진 설정 — MCP를 통해 Exa에 접속 (무료, API Key 불필요)
환경 검사 — 로컬 컴퓨터인지 서버인지 판단하여 그에 맞는 구성 제안
SKILL.md 등록 — Agent의 skills 디렉토리에 사용 가이드를 설치합니다. 이후 Agent가 "트위터 검색", "동영상 보기"와 같은 요구사항을 만나면 어떤 상위 도구(upstream tool)를 호출해야 하는지 자동으로 알게 됩니다.

설치 후, agent-reach doctor를 실행하면

단 하나의 명령어로 각 채널의 상태를 알려줍니다.

어떠한 설정도 필요 없이 Agent에게 말만 하면 됩니다:

• "이 링크 좀 봐줘" → curl https://r.jina.ai/URL (모든 웹페이지 읽기)
• "이 GitHub 저장소는 무엇을 하는 곳이야?" → gh repo view owner/repo (GitHub 검색/조회)
• "이 영상은 무슨 내용이야?" → yt-dlp --dump-json URL (자막 추출)
• "이 트윗 좀 확인해줘" → twitter tweet URL (트위터 분석)
• "이 RSS를 구독해줘" → feedparser (RSS 파싱)
• "GitHub에 어떤 LLM 프레임워크가 있는지 찾아봐" → gh search repos "LLM framework" (검색)

명령어를 외울 필요가 없습니다. Agent가 SKILL.md를 읽은 후 무엇을 호출해야 할지 스스로 판단합니다.

Agent Reach는 프레임워크(framework)가 아니라 스캐폴딩(scaffolding, 발판)입니다.

새로운 Agent에 환경을 구축할 때, 도구를 찾고, 의존성을 설치하고, 설정을 조정하는 데 항상 시간을 허비하게 됩니다. Twitter는 무엇으로 읽어야 할까? Reddit의 차단은 어떻게 우회할까? YouTube 자막은 어떻게 추출할까? 매번 똑같은 시행착오를 겪어야 합니다.

Agent Reach가 하는 일은 간단합니다: 이러한 도구 선택(selection)과 설정 작업을 대신 완료해 주는 것입니다.

설치가 완료되면 Agent는 Agent Reach의 래퍼(wrapper) 계층을 거치지 않고 상위 도구(twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI 등)를 직접 호출합니다.

각 플랫폼 뒤에는 독립적인 상위 도구가 있습니다. 마음에 들지 않나요? 그냥 교체하면 됩니다.

channels/
├── web.py → Jina Reader ← Firecrawl, Crawl4AI 등으로 교체 가능
├── twitter.py → twitter-cli ← 공식 API 등으로 교체 가능
...

각 채널 파일은 해당 상위 도구의 사용 가능 여부를 확인하는 check() 메서드만을 담당하며, agent-reach doctor에 상태 정보를 제공합니다. 실제 읽기와 검색은 Agent가 상위 도구를 직접 호출하여 완료합니다.

시나리오	선택된 도구	선택 이유
웹페이지 읽기	Jina Reader	9.8K Star, 무료, API Key 불필요
...

📌 이것들은 모두 「현재의 선택지」입니다. 마음에 들지 않는다면 해당 파일을 교체하기만 하면 됩니다. 이것이 바로 스캐폴딩의 의미입니다.

만약 단순히 "도인(Douyin) 영상 정보 파싱"을 넘어 다음과 같은 작업을 통합적으로 처리하고 싶다면:

• 도인 영상 스크립트 추출
• 샤오홍슈(Xiaohongshu) 영상 노트 스크립트 추출
• 샤오홍슈 이미지+텍스트 노트 본문 및 이미지 텍스트 추출
• 고정된 출력 형식 (script.md 및 info.json)

mcporter의 douyin 별칭(alias)을 다른 호환 구현체로 지정할 수 있습니다:

이 구현체는 기존 도구 이름과의 호환성을 유지합니다:

parse_douyin_video_info
get_douyin_download_link
extract_douyin_text

동시에 통합 도구를 새로 추가합니다:

parse_social_post_info
extract_social_post_script

따라서 Agent Reach의 관점에서 보면, 이것은 여전히 mcporter 내의 douyin 서버일 뿐이며, 단지 능력이 더 완전해진 것입니다.

Agent Reach는 설계 단계에서 보안을 중시합니다:

조치	설명
🔒 자격 증명 로컬 저장	Cookie, Token은 오직 사용자의 로컬 머신 ~/.agent-reach/config.yaml에만 존재하며, 파일 권한은 600(소유자만 읽기/쓰기 가능)으로 설정되어 업로드되거나 외부로 유출되지 않습니다.
🛡️ 안전 모드 (Safe Mode)	agent-reach install --safe 명령은 시스템을 자동으로 수정하지 않고 필요한 사항만 나열하며, 설치 여부는 사용자가 직접 결정합니다.
👀 완전 오픈 소스 (Open Source)	코드가 투명하여 언제든 검토할 수 있습니다. 모든 의존성 도구 또한 오픈 소스 프로젝트입니다.
🔍 드라이 런 (Dry Run)	agent-reach install --dry-run을 통해 모든 작업을 미리 보기 할 수 있으며, 어떠한 변경도 수행하지 않습니다.
🧩 플러그형 아키텍처 (Pluggable Architecture)	특정 컴포넌트를 신뢰할 수 없나요? 해당 채널 (channel) 파일만 교체하면 되며, 다른 부분에는 영향을 주지 않습니다.

⚠️ 계정 정지 위험 주의: Cookie를 사용하여 로그인하는 플랫폼 (Twitter, 小红书(Xiaohongshu) 등)의 경우, 스크립트 또는 API 호출을 통해 플랫폼에 감지되어 계정이 정지될 위험이 있습니다. 반드시 전용 부계정을 사용해야 하며, 본인의 주 계정(Main Account)을 사용하지 마세요.

Cookie가 필요한 플랫폼 (Twitter, 小红书)은 전용 부계정 사용을 권장합니다. 이유는 두 가지입니다:

계정 정지 위험 — 플랫폼이 일반적인 브라우저가 아닌 API 호출 행위를 감지하여 계정을 제한하거나 차단할 수 있습니다.
보안 위험 — Cookie는 완전한 로그인 권한과 동일하므로, 부계정을 사용하면 자격 증명 유출 시 영향 범위를 제한할 수 있습니다.

방식	명령	적합한 시나리오
원클릭 자동 설치 (기본값)	agent-reach install --env=auto	개인용 컴퓨터, 개발 환경
안전 모드	agent-reach install --env=auto --safe	운영 서버, 다수 사용자 공유 머신
미리 보기 전용	agent-reach install --env=auto --dry-run	수행될 작업을 먼저 확인하고 싶을 때

agent-reach uninstall

다음 항목들을 삭제합니다: ~/.agent-reach/ (모든 token/cookie 포함), 각 Agent의 skill 파일, mcporter 내의 MCP 설정.

# 실제 삭제하지 않고 미리 보기만 수행
agent-reach uninstall --dry-run

# skill 파일만 삭제하고 token 설정은 유지 (재설치 시 사용)
...

Python 패키지 자체를 삭제하려면: pip uninstall agent-reach

이 프로젝트는 순수하게 Vibe Coding으로 만들어졌습니다 🎸 완벽하지 않은 부분이 있을 수 있으니, 문제가 발생하더라도 너그러운 양해 부탁드립니다. 버그가 있다면 언제든 Issue를 제기해 주세요. 최대한 빠르게 수정하겠습니다.

새로운 채널을 원하시나요? 직접 Issue를 제기하여 알려주시거나, PR (Pull Request)을 보내주세요.

로컬에 추가하고 싶으신가요? Agent를 클론(clone)하여 수정하시면 됩니다. 각 채널은 독립된 파일로 구성되어 있어 추가하기 매우 쉽습니다.

PR은 언제나 환영합니다!

이 프로젝트는 저 자신이 매일 사용하고 있으므로, 지속적으로 유지보수할 것입니다.

• 새로운 요구사항이나 요청된 채널이 있으면 차례로 추가하겠습니다.
• 각 채널에 대해 최대한 사용 가능하고, 편리하며, 무료인 상태를 유지하겠습니다. - 플랫폼의 안티 크롤링(Anti-scraping) 정책이 바뀌거나 API가 변경되면 해결 방법을 찾아내겠습니다.

Web 4.0 인프라 구축에 저만의 힘을 보태고자 합니다.

나중에 필요할 때 찾을 수 있도록 Star를 눌러주세요. ⭐

AI Agent가 어떻게 API 비용 없이 Twitter / X를 검색할 수 있나요?

Agent Reach는 twitter-cli를 사용하여 Cookie 인증을 통해 Twitter에 접속하며, 완전히 무료입니다. 설치: pipx install twitter-cli를 수행하고, 브라우저에서 x.com에 로그인되어 있는지 확인하세요. 그러면 Agent가 twitter search "키워드"로 검색하고, twitter tweet URL로 트윗을 읽을 수 있습니다.

How to search Twitter/X with AI agent for free (no API)?

Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with pipx install twitter-cli, make sure you're logged into x.com in your browser, then your agent can search with twitter search "query" and read tweets with twitter tweet URL.

Reddit에서 403 에러가 발생하면 어떻게 하나요?

Agent Reach는 Reddit에 접속하기 위해 rdt-cli를 사용합니다. Reddit은 2024년부터 인증을 요구하므로, 설치 후 rdt login을 실행하여 로그인해야 합니다. 설치: pipx install rdt-cli

，그 다음 rdt login을 실행합니다

(브라우저에서 자동으로 Cookie를 추출합니다). 이후 Agent는 rdt search "키워드"를 사용하여 검색하거나, rdt read POST_ID를 사용하여 게시물 전문과 댓글을 읽을 수 있습니다.

AI를 위한 YouTube 영상 스크립트(transcripts)를 가져오는 방법은?

yt-dlp --dump-json "https://youtube.com/watch?v=xxx"는 영상의 메타데이터(metadata)를 추출하며, yt-dlp --write-sub --skip-download "URL"은 자막을 추출합니다. 내부적으로 yt-dlp를 사용하며 여러 언어를 지원합니다. API 키는 필요하지 않습니다.

AI Agent가 Xiaohongshu(小红书)를 읽게 하려면 어떻게 하나요?

pipx install xiaohongshu-cli를 설치한 후, xhs login을 실행합니다

(브라우저에서 자동으로 Cookie를 추출합니다). 이후 Agent는 xhs search "키워드"로 노트를 검색하고, xhs read NOTE_ID로 상세 내용을 읽으며, xhs comments NOTE_ID로 댓글을 확인할 수 있습니다. Docker는 필요하지 않습니다.

AI Agent가 Douyin(抖音) 영상을 분석하게 하려면 어떻게 하나요?

douyin-mcp-server를 설치하면, Agent는 mcporter call 'douyin.parse_douyin_video_info(share_link: "공유 링크")'를 사용하여 영상 정보를 분석하고 워터마크 없는 다운로드 링크를 가져올 수 있습니다. 로그인은 필요하지 않으며, Douyin 공유 링크를 Agent에게 전달하기만 하면 됩니다. 자세한 내용은 https://github.com/yzfly/douyin-mcp-server 를 참조하세요.

Claude Code / Cursor / OpenClaw / Windsurf와 호환되나요?

네! Agent Reach는 설치 및 설정 도구입니다. 셸 명령(shell commands)을 실행할 수 있는 모든 AI 코딩 에이전트가 이를 사용할 수 있습니다. Claude Code, Cursor, OpenClaw, Windsurf, Codex 등과 함께 작동합니다. pip install agent-reach를 실행하고, agent-reach install을 실행하면 에이전트가 즉시 상위 도구(upstream tools)들을 사용할 수 있습니다.

OpenClaw 참고 사항: 만약 OpenClaw가 기본 messaging 도구 프로필(tool profile)을 사용 중이라면

• 📧
  Email: pnt01@foxmail.com - 🐦
  Twitter/X: @Neo_Reidlab

교류 또는 협업을 원하시면 WeChat을 추가해 주세요. 교류 그룹에 초대해 드리겠습니다.

버그 피드백 및 기능 요청은 추적이 용이하도록 GitHub Issues를 사용해 주세요.

FluxNode — 저렴한 AI API 중계 스테이션입니다. 공식 가격의 10% 수준이며, 사용량 기반 또는 패키지 기반 결제가 가능합니다. OpenClaw, Claude Code 등 모든 Agent에서 사용할 수 있습니다.

OpenClaw for Enterprise — 기업용 OpenClaw 다중 사용자 배포 솔루션입니다. Feishu(飞书)에서 직접 AI를 사용하며, 컨테이너 격리 및 단일 명령어로 관리가 가능합니다.

Tencent Cloud OpenClaw — Tencent Cloud Lighthouse에서 OpenClaw 올인원 어시스턴트를 초 단위로 배포할 수 있습니다. 대화를 통해 Agent Reach에 매끄럽게 연결하여, 귀하의 OpenClaw에 인터넷 능력을 원클릭으로 장착할 수 있습니다.