Panniantong/Agent-Reach

<h1 align="center">👁️ Agent Reach</h1>

<p align="center"> <strong>AI Agent에 원클릭으로 인터넷 능력을 부여하세요</strong> </p>

<p align="center"> 현재 가장 안정적인 접근 방식 — 저희가 선택하고, 설치하고, 점검해 드립니다. 접근 방식이 바뀌어도 여러분은 신경 쓸 필요 없습니다. </p>

왜 Agent Reach가 필요한가요?

AI Agent는 이미 코드 작성, 문서 수정, 프로젝트 관리를 할 수 있습니다. 하지만 인터넷에서 무언가를 찾으라고 하면 어려움을 겪습니다:

• 📺 "이 YouTube 튜토리얼이 뭘 말하는지 봐줘" → 볼 수 없음, 자막을 가져올 수 없음
• 🐦 "트위터에서 사람들이 이 제품을 어떻게 평가하는지 검색해줘" → 검색 불가, Twitter API는 유료
• 📖 "Reddit에서 같은 버그를 겪은 사람이 있는지 봐줘" → 403 차단, 서버 IP가 거부됨
• 📕 "샤오홍슈에서 이 제품 평판을 봐줘" → 열 수 없음, 로그인 필수
• 📺 "B站에 기술 영상이 있는데 요약해줘" → 가져올 수 없음, 일반 다운로드 도구가 B站의 리스크 관리에 완전히 차단됨
• 🔍 "최신 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를 눌러주세요. 저희는 각 플랫폼의 변화를 지속적으로 추적하고 새로운 채널을 추가할 것입니다. 여러분이 직접 모니터링할 필요 없습니다 — 플랫폼이 차단하면 저희가 수정하고, 새 채널이 생기면 추가합니다.

✅ 사용하기 전에 알아두면 좋은 점

| 🔒 개인정보 보안 | Cookie는 로컬에만 저장되며, 업로드되거나 외부로 전송되지 않습니다. 코드는 완전히 오픈소스이며 언제든지 검토 가능합니다 |

| 🤖 모든 Agent 호환 | Claude Code, OpenClaw, Cursor, Windsurf... 명령줄을 실행할 수 있는 모든 Agent에서 사용 가능 |

지원 플랫폼

설정 방법을 모르시나요? 문서를 찾을 필요 없습니다. Agent에게 "XXX 설정 도와줘"라고 직접 말하면, Agent가 필요한 것을 알고 단계별로 안내합니다.

>

🍪 Cookie가 필요한 플랫폼(Twitter, 샤오홍슈 등)은 Chrome 확장 프로그램 Cookie-Editor를 우선 사용하여 Cookie를 내보내고 Agent에 보내면 설정할 수 있습니다. 프로세스는 통일되어 있습니다: 브라우저 로그인 → Cookie-Editor 내보내기 → Agent에 보내기. QR 코드 스캔보다 더 간단하고 안정적입니다.

>

🔒 Cookie는 로컬에만 저장되며, 업로드되거나 외부로 전송되지 않습니다. 코드는 완전히 오픈소스이며 언제든지 검토 가능합니다.

💻 로컬 컴퓨터는 프록시가 필요하지 않습니다. 프록시는 서버에 배포할 때만 필요합니다 (월 ~$1).

빠른 시작

⚠️ OpenClaw 사용자는 먼저 exec 권한이 활성화되어 있는지 확인하세요

>

Agent Reach는 Agent가 shell 명령어(pip install, mcporter, twitter 등)를 실행하는 데 의존합니다. OpenClaw가 기본 messaging 도구 구성을 사용하는 경우 Agent가 명령어를 실행할 수 없습니다. 설치 전에 exec 권한을 활성화하세요:

>

```bash

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

```

🛡️ 보안이 걱정되나요? 안전 모드를 사용할 수 있습니다 — 시스템 패키지를 자동으로 설치하지 않고, 필요한 것만 알려줍니다:

```

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

安装时使用 --safe 参数

```

<details> <summary>무엇을 하나요? (클릭하여 펼치기)</summary>

1. CLI 도구 설치 — pip install로 agent-reach 명령줄 설치 (yt-dlp, feedparser 포함)
2. 시스템 기반 설치 — Node.js, gh CLI, mcporter 자동 감지 및 설치
3. 검색 엔진 구성 — MCP를 통해 Exa 접속 (무료, API Key 불필요)
4. 환경 감지 — 로컬 컴퓨터인지 서버인지 판단하여 해당 구성 권장 사항 제공
5. SKILL.md 등록 — Agent의 skills 디렉토리에 사용 가이드 설치, 이후 Agent가 "전체 조사", "트위터 검색", "동영상 보기" 등의 요청을 받으면 자동으로 어떤 상위 도구를 호출할지 알게 됨
6. 추가 기능 선택 — 기본적으로 6개의 제로 설정 채널만 활성화; 샤오홍슈, Twitter, Reddit 등 로그인이 필요한 것은 Agent가 메뉴를 보여주고 필요한 것만 선택하도록 요청

설치 후 agent-reach doctor 명령 하나로 각 채널의 상태와 현재 사용 중인 경로를 알 수 있습니다. </details>

설치 후 바로 사용 가능

어떤 설정도 필요 없습니다. Agent에게 말하기만 하면 됩니다:

• "이 링크를 봐줘" → curl https://r.jina.ai/URL로 모든 웹페이지 읽기
• "이 GitHub 저장소는 뭐 하는 곳이야" → gh repo view owner/repo
• "이 YouTube 동영상은 뭘 말해" → yt-dlp로 자막 추출
• "B站에서 AI 튜토리얼 검색해줘" → bili search (로그인 불필요)
• "전체 검색으로 LLM 프레임워크 비교를 찾아줘" → Exa 의미 검색
• "이 RSS 구독해줘" → feedparser로 파싱

명령어를 외울 필요가 없습니다. Agent가 SKILL.md를 읽은 후 무엇을 호출해야 할지 스스로 알게 됩니다. 로그인이 필요한 플랫폼(샤오홍슈, Twitter, Reddit)은 Agent에게 "XXX 설정 도와줘"라고 말하면 잠금 해제됩니다.

기능 경계: 콘텐츠 읽기 vs 웹페이지 조작

일부 작업은 "읽기" 범위를 벗어납니다: 로그인 후 웹페이지 조작, 양식 제출, 다중 계정 격리, 병렬 브라우저 세션, 자동화 프로세스 중 로그인, 인증, 리스크 관리 프롬프트 등 마찰이 큰 작업의 수동 개입. 이러한 "조작" 시나리오는 BrowserAct와 같은 브라우저 자동화 도구와 함께 사용할 수 있습니다 — 30개 이상의 사전 구축된 플랫폼 스킬, Claude Code / OpenClaw / Cursor 등 주요 Agent 지원.

설계 철학

Agent Reach는 능력 계층(capability layer)이지, 또 다른 도구가 아닙니다.

구체적인 구현보다 한 단계 위에 있습니다 — 선택, 설치, 점검, 라우팅을 담당하며, 기본 읽기 자체는 담당하지 않습니다. 읽기는 Agent가 상위 도구를 직접 호출하여 수행하며, 래핑 계층이 없습니다.

새 Agent에 환경을 설정할 때마다 도구를 찾고, 의존성을 설치하고, 설정을 조정하는 데 시간을 소비해야 합니다 — Twitter는 무엇으로 읽나요? Reddit은 어떻게 로그인하나요? 샤오홍슈의 CLI가 업데이트를 중단하면 무엇으로 바꾸나요? 매번 다시 삽질해야 합니다. Agent Reach가 하는 일은 간단합니다: 현재 가장 안정적인 접근 방식을 저희가 선택하고, 설치하고, 점검해 드립니다. 접근 방식이 바뀌어도(2026년 3월一批 단일 플랫폼 CLI가集体 업데이트 중단, 저희가 경로를 변경했습니다), 여러분은 신경 쓸 필요 없습니다.

🔌 각 플랫폼 = 기본 + 대체의 정렬된 백엔드 목록

접근 방식 변경 = 목록 순서 조정, 코드 재작성 불필요. agent-reach doctor는 각 플랫폼이 현재 어떤 백엔드를 사용 중인지 알려줍니다.

channels/
├── web.py          → Jina Reader
├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py      → yt-dlp
├── github.py       → gh CLI
├── bilibili.py     → bili-cli ▸ OpenCLI ▸ 검색 API (yt-dlp는 B站 리스크 관리에 차단되어 폐기됨)
├── reddit.py       → OpenCLI ▸ rdt-cli (제로 설정 경로 없음, 로그인 상태 필수)
├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py     → linkedin-mcp ▸ Jina Reader
├── rss.py          → feedparser
├── exa_search.py   → Exa via mcporter
└── __init__.py     → 채널 등록 (doctor 감지용)

각 채널 파일은 순서대로 각 후보 백엔드를 실제로 탐지합니다 (단순히 명령어 존재 여부만 확인하는 것이 아님). 첫 번째로 완전히 사용 가능한 것이 선택되고, 고장난 것은 수정 처방을 제공합니다. 실제 읽기 및 검색은 Agent가 상위 도구를 직접 호출하여 수행합니다.

현재 선택

📌 이것들은 모두 '현재 선택'이며, 실제 기기 테스트를 기반으로 정기적으로 재검토됩니다. 특정 경로가 작동하지 않으면 다음 경로로 전환합니다 — agent-reach doctor는 항상 현재 사용 중인 경로를 알려줍니다.

보안

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

🍪 Cookie 보안 권장 사항

⚠️ 계정 정지 위험 알림: Cookie로 로그인하는 플랫폼(Twitter, 샤오홍슈 등)에서 스크립트/API 호출을 통해 플랫폼에 감지되어 계정이 정지될 위험이 있습니다. 반드시 전용 부계정을 사용하고, 주 계정을 사용하지 마세요.

1. 계정 정지 위험 — 플랫폼이 비정상적인 브라우저 API 호출 행동을 감지하여 계정이 제한되거나 정지될 수 있음
2. 보안 위험 — Cookie는 완전한 로그인 권한과 동일하므로, 부계정을 사용하면 자격 증명 유출 시 영향을 제한할 수 있음

Cookie가 필요한 플랫폼(Twitter, 샤오홍슈)은 전용 부계정을 사용하는 것이 좋습니다. 이유는 두 가지입니다:

📦 설치 방식

🗑️ 제거

agent-reach uninstall

다음을 제거합니다: ~/.agent-reach/ (모든 token/cookie 포함), 각 Agent의 skill 파일, mcporter의 MCP 구성.

# 미리보기만, 실제 삭제하지 않음
agent-reach uninstall --dry-run

# skill 파일만 삭제하고 token 구성 유지 (재설치 시 사용)
agent-reach uninstall --keep-config

Python 패키지 자체 제거: pip uninstall agent-reach

기여

이 프로젝트는 순수 vibe 코딩으로 만들어졌습니다 🎸 약간의 불완전한 부분이 있을 수 있으며, 문제가 발생하면 양해 부탁드립니다. 버그가 있으면 Issue를 제출해 주세요. 최대한 빨리 수정하겠습니다.

새 채널을 원하시나요? Issue를 통해 알려주시거나, 직접 PR을 제출해 주세요.

로컬에 추가하고 싶으신가요? Agent가 저장소를 클론하여 수정하면 됩니다. 각 채널은 독립적인 파일이며, 추가는 매우 간단합니다.

PR도 언제든지 환영합니다!

⭐ Star를 눌러야 하는 이유

이 프로젝트는 제가 매일 사용하고 있기 때문에 계속 유지 관리할 것입니다.

• 새로운 요구 사항이나 사람들이 원하는 채널이 있으면 점차 추가할 것입니다
• 각 채널이 사용 가능하고,好用하며, 무료인지 최대한 보장하겠습니다
• 플랫폼이 안티스크래핑을 변경하거나 API가 변경되면 해결 방법을 찾겠습니다

Web 4.0 인프라에 제 작은 힘을 보탭니다.

Star를 눌러 주시면, 필요할 때 찾을 수 있습니다. ⭐

자주 묻는 질문 / FAQ

<details> <summary><strong>AI Agent가 Twitter/X를 검색하는 방법은? API 비용을 지불하고 싶지 않습니다</strong></summary>

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

<details> <summary><strong>How to search Twitter/X with AI agent for free (no API)?</strong></summary>

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. </details>

<details> <summary><strong>Reddit에서 403 오류가 발생하면 어떻게 하나요?</strong></summary>

Reddit의 모든 접근에는 로그인 상태가 필요합니다 (익명 인터페이스는 완전히 차단되었으며, 공식 API는 수동 승인이 필요합니다). 데스크톱에서는 OpenCLI를 우선 사용하세요: 브라우저에서 reddit.com에 로그인한 상태이면 opencli reddit search "키워드"를 직접 사용할 수 있습니다. 대체로 rdt-cli: pipx install 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66' (코드와 동일한 고정 버전, PyPI는 구버전), 그 다음 rdt login. 중국 본토 네트워크에서 Reddit에 접속하려면 프록시가 필요합니다. </details>

<details> <summary><strong>AI를 위해 YouTube 동영상 자막을 얻는 방법은?</strong></summary>

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

<details> <summary><strong>AI Agent가 샤오홍슈를 읽게 하려면 어떻게 하나요?</strong></summary>

데스크톱 컴퓨터에서는 OpenCLI를 우선 사용하세요 (agent-reach install --channels opencli) — 브라우저의 로그인 상태를 재사용하므로, 평소에 샤오홍슈를 본 적이 있으면 바로 사용할 수 있으며 제로 설정입니다; 설치 후 Chrome 스토어에서 '확장 프로그램 추가'를 한 번 클릭하면 됩니다. 그 후 Agent는 opencli xiaohongshu search "키워드"로 검색하고 opencli xiaohongshu note URL로 노트를 읽습니다. 서버에서는 xiaohongshu-mcp를 사용합니다 (헤드리스 브라우저 내장, QR 코드 로그인). 이미 xhs-cli를 설치한 기존 사용자는 영향을 받지 않으며, 여전히 대체 백엔드로 사용 가능합니다 (상위 프로젝트가 2026-03부터 업데이트 중단, 신규 설치 권장하지 않음). </details>

<details> <summary><strong>Claude Code / Cursor / OpenClaw / Windsurf와 호환되나요?</strong></summary>

네! Agent Reach는 설치 프로그램 + 구성 도구입니다 — shell 명령어를 실행할 수 있는 모든 AI 코딩 Agent가 사용할 수 있습니다. Claude Code, Cursor, OpenClaw, Windsurf, Codex 등과 함께 작동합니다. pip install agent-reach를 실행하고 agent-reach install을 실행하면 Agent가 즉시 상위 도구를 사용할 수 있습니다.