Agent Reach

13개 인터넷 채널(트위터·레딧·유튜브·깃허브 등)에 API 키 없이 접근하는 CLI 라우터

pipx install https://github.com/Panniantong/agent-reach/archive/main.zip && agent-reach install --env=auto

AI 에이전트가 트위터/X, 레딧, 유튜브, 깃허브, 빌리빌리, 샤오홍슈, 쉬에추(雪球), V2EX, 링크드인, 샤오위저우 팟캐스트, RSS, 웹, Exa 검색까지 13개 채널을 API 키 없이 읽고 검색하도록 설치·설정·헬스체크를 대신해주는 파이썬 CLI입니다. 도구 자체가 콘텐츠를 감싸지 않고, 채널별로 검증된 상위 CLI/MCP 백엔드(yt-dlp, gh CLI, twitter-cli, bili-cli, OpenCLI 등)에 계층적으로 라우팅한 뒤 그대로 위임합니다.

판단

이럴 때 씁니다

AI 에이전트가 트위터/레딧/유튜브/깃허브 등 여러 플랫폼 콘텐츠를 API 키 없이 읽고 검색해야 할 때
Claude Code처럼 skill을 지원하는 에이전트에서 소셜/웹 리서치 능력을 스킬 형태로 빠르게 통합하고 싶을 때
개인·리서치 규모에서 여러 플랫폼의 백엔드 상태를 doctor 한 번으로 점검하고 자동 폴백까지 맡기고 싶을 때

이럴 땐 쓰지 마세요

프로덕션에서 안정적인 공식 API 계약이 필요한 경우 — 쿠키 기반 접근은 ToS 위반 소지가 있고 테스트 스위트가 없다
회사/주요 계정으로 로그인 세션을 노출하고 싶지 않은 경우 — 쓰로우어웨이 계정이 사실상 필수
셸 명령 실행이 제한된 샌드박스형 에이전트 플랫폼 — 각 채널 CLI를 직접 호출하는 구조라 셸 접근이 없으면 동작하지 않는다

차별점

13개 플랫폼(트위터/레딧/유튜브/깃허브/빌리빌리/샤오홍슈/쉬에추/V2EX/링크드인/샤오위저우/RSS/웹/Exa)을 단일 CLI로 통합 — 실제 `agent-reach doctor --json` 실행 결과 GitHub·YouTube는 설치 즉시 tier 0로 바로 동작 확인
채널별 tier 0~2 계층적 백엔드 라우팅 — 1차 백엔드가 죽으면 자동 대체(2026년 6월 빌리빌리 풍공 이후 yt-dlp에서 bili-cli/검색 API로 전환된 사례가 실측 doctor 출력에 반영됨)
MCP 서버 옵션 포함(Exa 웹검색 mcporter, xiaohongshu-mcp, linkedin-scraper-mcp) — CLI 직접 호출과 MCP 두 진입점을 모두 지원
Claude Code 등 에이전트 프레임워크에 SKILL.md를 자동 등록하는 skill 시스템 — 본 카탈로그 작성 시점에도 이 환경에 실제 Claude Code skill로 설치되어 라우팅 표까지 정상 동작하는 것을 직접 확인
PyPI 미등록, GitHub 압축 아카이브를 pipx로 직접 설치하는 배포 방식(공급망 신뢰 범위가 좁음)

워크플로

01pipx install https://github.com/Panniantong/agent-reach/archive/main.zip 로 설치 후 agent-reach install --env=auto 실행
02agent-reach doctor --json 으로 채널별 실시간 백엔드 상태와 active_backend 확인
03tier 1/2 채널(레딧·샤오홍슈·링크드인 등)은 doctor가 안내하는 방식대로 로그인/쿠키 설정(OpenCLI로 브라우저 세션 재사용 등) 수행
04설정 완료 후 에이전트가 채널별 CLI(twitter-cli, bili search, gh 등)를 직접 호출해 콘텐츠 수집

주요 명령

명령	설명
`agent-reach doctor --json`	13개 채널의 현재 백엔드 가용성을 실시간 점검(실측: GitHub·YouTube ok, Twitter/Reddit/샤오홍슈/링크드인은 로그인·추가 설치 필요)
`agent-reach install --env=auto`	환경(로컬/서버) 자동 감지 후 필요한 백엔드(gh, yt-dlp 등)를 설치
`agent-reach check-update`	새 버전 확인 — 실측: 로컬 v1.5.0, '이미 최신 버전' 응답 확인
`agent-reach skill`	에이전트 프레임워크용 SKILL.md 등록/관리

함정

설치 전에 확인하세요

PyPI에 없음 — `pip index`/PyPI API 조회 시 404 확인. `pip install agent-reach`는 실제로 동작하지 않으며, GitHub 압축 아카이브를 pipx로 설치해야 한다
Reddit·샤오홍슈·트위터·링크드인 등 tier 1/2 채널은 쿠키 기반 로그인 세션이 필수이며, 각 플랫폼 ToS상 자동화 접근이 금지되어 있어 계정 정지 위험이 있다(외부 리뷰 andrew.ooo, 2026년 확인: 쓰로우어웨이 계정 권장, 주 1회 doctor 실행 권장)
테스트 스위트가 없는 'install + delegate' 구조 — 업스트림 도구(yt-dlp, gh CLI 등)는 성숙하지만 그 사이를 잇는 글루 코드 자체는 검증이 얕다

직접 써본 메모

이 환경에는 agent-reach가 pipx로 이미 설치되어 있어(v1.5.0) 직접 `agent-reach doctor --json`을 실행해봤다. 결과는 계층 구조가 뚜렷했다 — GitHub은 gh CLI로, YouTube는 yt-dlp로 별도 설정 없이 바로 tier 0 'ok' 상태였지만, 트위터는 twitter-cli 미설치로 'warn', 레딧과 샤오홍슈는 로그인 세션이 아예 없어 'off' 상태였다. 즉 '13개 채널 지원'이라는 문구는 사실이지만, 실제로 바로 쓸 수 있는 건 극히 일부이고 나머지는 쿠키/브라우저 세션 설정이라는 진입장벽이 남아있다는 점을 확인할 수 있었다.

README와 install.md를 대조해보니 흥미로운 불일치가 있었다 — README 요약에는 pip install처럼 읽히는 표현이 있었지만 실제로는 PyPI에 패키지가 없다(PyPI API 조회 404 확인). 공식 설치 경로는 GitHub 압축 아카이브를 pipx로 설치하는 방식이다. 이런 배포 방식은 공급망 신뢰 범위를 넓히므로, 외부 리뷰(andrew.ooo)가 지적한 '설치 URL을 커밋 SHA에 고정하라'는 권고가 타당해 보인다.

구조적으로는 도구 자체가 콘텐츠를 가공하지 않고 검증된 상위 CLI/MCP에 위임하는 '스캐폴딩'에 가깝다는 평가에 동의한다. 다만 그 사이를 잇는 글루 코드에는 테스트 스위트가 없고, 트위터·샤오홍슈·빌리빌리·링크드인처럼 로그인 세션이 필요한 채널은 해당 플랫폼 ToS상 자동화 접근이 금지돼 있어 계정 정지 리스크가 실재한다. 개인/리서치용 빠른 통합 도구로는 유용하지만, 프로덕션에 얹기 전에는 쓰로우어웨이 계정과 주기적 doctor 점검이 사실상 필수로 보인다.

비교

context7이 라이브러리 문서를 가져오는 MCP 컨텍스트 소스라면, agent-reach는 로그인 세션이 필요한 소셜/미디어 플랫폼 13곳의 CLI 백엔드 설치·헬스체크·자동 폴백을 관리하는 라우터에 가깝다. 콘텐츠를 직접 가공하지 않고 검증된 상위 도구에 위임한다는 점이 core 차이다.

최근 변경

v1.5.0에서 플랫폼별 다중 백엔드 라우팅, 실제 명령 기반 doctor와 active_backend, OpenCLI 데스크톱 백엔드를 추가하고 13개 채널을 검증했다.

공식 변경 내역