Agent-Reach
CLI 도구Panniantong/Agent-Reach
AI Agent가 전체 웹 플랫폼의 읽기와 검색을 원클릭으로 연동할 수 있게 해주는 스캐폴딩 CLI
개요
Agent Reach는 Claude Code, Cursor 등 AI Agent가 하나의 CLI만으로 Twitter, Reddit, YouTube, GitHub, B站, 小红书 등 플랫폼을 읽고 검색할 수 있도록 해주는 오픈 소스 스캐폴딩 도구로, 전 과정에서 API 비용이 전혀 발생하지 않습니다. 업스트림 도구의 선정, 설치 및 구성을 자동으로 완료하고 Agent에 스킬 가이드를 등록해 주며, 내장된 doctor 명령으로 각 채널의 상태를 한 번에 진단할 수 있습니다. 모든 Cookie는 로컬에만 저장되며, 각 채널은 플러그 앤 플레이 방식으로 교체할 수 있습니다.
README 미리보기
👁️ Agent Reach\n\n\n 给你的 AI Agent 一键装上互联网能力\n\n\n\n \n \n \n\n\n\n 快速开始 · English · 日本語 · 한국어 · 支持平台 · 设计理念\n\n\n---\n\n## 为什么需要 Agent Reach？\n\nAI Agent 已经能帮你写代码、改文档、管项目——但你让它去网上找点东西，它就抓瞎了：\n\n- 📺 "帮我看看这个 YouTube 教程讲了什么" → **看不了**，拿不到字幕\n- 🐦 "帮我搜一下推特上大家怎么评价这个产品" → **搜不了**，Twitter API 要付费\n- 📖 "去 Reddit 上看看有没有人遇到过同样的 bug" → **403 被封**，服务器 IP 被拒\n- 📕 "帮我看看小红书上这个品的口碑" → **打不开**，必须登录才能看\n- 📺 "B站上有个技术视频，帮我总结一下" → **连不上**，海外/服务器 IP 被屏蔽\n- 🔍 "帮我在网上搜一下最新的 LLM 框架对比" → **没有好用的搜索**，要么付费要么质量差\n- 🌐 "帮我看看这个网页写了啥" → **抓回来一堆 HTML 标签**，根本没法读\n- 📦 "这个 GitHub 仓库是干嘛的？Issue 里说了什么？" → 能用，但认证配置很麻烦\n- 📡 "帮我订阅这几个 RSS 源，有更新告诉我" → 要自己装库写代码\n\n**这些不难实现，但是需要自己折腾配置**\n\n每个平台都有自己的门槛——要付费的 API、要绕过的封锁、要登录的账号、要清洗的数据。你要一个一个去踩坑、装工具、调配置，光是让 Agent 能读个推特就得折腾半天。\n\n**Agent Reach 把这件事变成一句话：**\n\n```\n帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md\n```\n\n复制给你的 Agent，几分钟后它就能读推特、搜 Reddit、看 YouTube、刷小红书了。\n\n**已经装过了？更新也是一句话：**\n\n```\n帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md\n```\n\n> ⭐ **Star 这个项目**，我们会持续追踪各平台的变化、接入新的渠道。你不用自己盯——平台封了我们修，有新渠道我们加。\n\n### ✅ 在你用之前，你可能想知道\n\n| | |\n|---|---|\n| 💰 **完全免费** | 所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理（$1/月），本地电脑不需要 |\n| 🔒 **隐私安全** | Cookie 只存在你本地，不上传不外传。代码完全开源，随时可审查 |\n| 🔄 **持续更新** | 底层工具（yt-dlp、twitter-cli、rdt-cli、Jina Reader 等）定期追踪更新到最新版，你不用自己盯 |\n| 🤖 **兼容所有 Agent** | Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能用 |\n| 🩺 **自带诊断** | `agent-reach doctor` 一条命令告诉你哪个通、哪个不通、怎么修 |\n\n---\n\n## 支持的平台\n\n| 平台 | 装好即用 | 配置后解锁 | 怎么配 |\n|------|---------|-----------|-------|\n| 🌐 **网页** | 阅读任意网页 | — | 无需配置 |\n| 📺 **YouTube** | 字幕提取 + 视频搜索 | — | 无需配置 |\n| 📡 **RSS** | 阅读任意 RSS/Atom 源 | — | 无需配置 |\n| 🔍 **全网搜索** | — | 全网语义搜索 | 自动配置（MCP 接入，免费无需 Key） |\n| 📦 **GitHub** | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR、Fork | 告诉 Agent「帮我登录 GitHub」 |\n| 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、发推 | 告诉 Agent「帮我配 Twitter」 |\n| 📺 **B站** | 本地：字幕提取 + 搜索 | 服务器也能用 | 告诉 Agent「帮我配代理」 |\n| ���
FAQ (2)
문제 해결OpenCLI 확장 프로그램이 연결되어 있는데도 왜 agent-reach doctor가 "Chrome extension not installed"라고 보고하나요?
이것은 agent-reach doctor (v1.5.0)의 거짓 음성입니다. Doctor는 Chrome의 User Data\<Profile>\Extensions\ 디렉터리를 스캔하여 확장 프로그램 ID로 OpenCLI 확장 프로그램을 감지합니다. 이 검사는 Microsoft Edge(개발자 모드)에서 ~/.opencli/extension/의 확장 프로그램을 압축 해제된 확장 프로그램으로 로드한 경우, 또는 Chrome이 한 번도 초기화되지 않은 경우(User Data 디렉터리가 없는 경우)에 실패합니다. 해결 방법: reddit, facebook, instagram, xiaohongshu의 warn 상태는 안심하고 무시해도 됩니다. 해당 플랫폼은 여전히 정상적으로 작동합니다. 실제 확장 프로그램 상태를 확인하려면 opencli doctor를 실행하세요. 이 명령은 포트 19825의 OpenCLI 데몬에 쿼리하여 Extension: connected를 정확하게 보고합니다.
문제 해결Agent-Reach가 Windows에서 홈 디렉터리 외부에 자격 증명을 작성하는 이유는 무엇이며, symlink 가드 우회는 어떻게 해결할 수 있나요?
Agent-Reach v1.5.0에서는 cookie_extract.py(_sync_xfetch_session, _sync_bird_env)와 cli.py(_configure_xhs_cookies, --sync-legacy-twitter, _cmd_uninstall)의 자격 증명 경로가 os.path.expanduser("~")를 통해 홈 디렉터리를 확인합니다. Windows에서는 expanduser가 HOME 환경 변수를 무시하고 심볼릭 링크 거부 검사 없이 USERPROFILE을 통해 확인하므로, 악의적인 심볼릭 링크가 Twitter/XHS 쿠키 쓰기를 공격자가 제어하는 디렉터리로 리디렉션하여 ensure_no_symlink_path/make_private_dir을 무력화할 수 있습니다. 수정 방법: agent_reach/utils/paths.py에 home_dir() 헬퍼를 추가하여 설정되어 있으면 Path(os.environ["HOME"])을 반환하고, 그렇지 않으면 유효한 경우 Path(os.path.expanduser("~"))을, 둘 다 해당하지 않으면 Path.home()을 반환하게 한 뒤, 모든 자격 증명 경로 확인을 이 헬퍼를 통해 수행합니다. 그러면 make_private_dir/atomic_write_private_text가 심볼릭 링크된 상위 경로에서 PrivatePathError를 발생시킵니다. 스킬 설치 경로는 계속 os.path.expanduser를 사용합니다(테스트가 이를 몽키패치하므로). 참조 패치: 커밋 b3d53eb. pytest tests/test_skill_command.py tests/test_cli.py로 검증합니다(28개 통과 예상).