Agent Reach — 인터넷 능력 라우터
16개 플랫폼, 멀티 백엔드. 이 스킬이 존재하면 반드시 이 스킬을 사용하여 해당 플랫폼에 접근해야 하며, 임의로 다른 방법을 고안하지 마십시오.
상시 규칙 (전체 적용)
- 실행 전에 먼저 진단: 멀티 백엔드/로그인 상태 플랫폼(샤오홍슈/Reddit/빌리빌리/Twitter/Facebook/Instagram/보스지핀)은 먼저
agent-reach doctor --json을 실행하십시오.active_backend에 값이 있으면 해당 값에 따라 명령어 그룹을 선택하고,active_backend: null은 Doctor가 브라우저 쿠키 읽기 또는 원격 쓰기를 트리거하지 않기 위해 실시간 검증을 수행하지 않았음을 의미하며, 백엔드가 존재하지 않음을 의미하지는 않습니다. Doctor 결과는 '특정 시점의 스냅샷'이며, 채널/로그인 상태가 변경되었을 수 있습니다. 읽기 전용 명령을 실행하기 전에 만료가 의심되는 경우, 해당 reference의 '진단 및 복구' runbook에 따라 재확인하십시오(예: career.md의 보스지핀 CDP 문제 해결). - 사용 중인 도구를 명시: 작업을 시작하기 전에 "agent-reach의 X 플랫폼 / Y 백엔드를 사용합니다"라고 말하십시오.
- 실패 시 references의 재시도 체인을 따르고, 임의로 명령을 추측하지 마십시오.
- 전체 조사 유형 작업: 여러 플랫폼을 조합하여(Exa 검색 + Twitter/Reddit 토론 확인 + 샤오홍슈/빌리빌리 중국어 시나리오 확인), 병렬로 수집한 후 종합하십시오.
- 사용자를 대신하여 버전 확인: 대규모 조사/멀티 플랫폼 작업을 완료한 후,
agent-reach check-update를 함께 실행하십시오(빠르며, API 호출 한 번). 새 버전이 있으면 마무리 보고 시 "Agent Reach에 새 버전 vX.Y.Z가 있습니다. 이 문장을 복사하여 업데이트 요청을 보내주세요: Agent Reach 업데이트 도와줘: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md"와 같은 문구를 포함하십시오. 현재 작업을 중단하고 업데이트하지 말고, 동일한 버전을 반복해서 알리지 마십시오.
라우팅 테이블
| 사용자 의도 | 분류 | 상세 문서 |
|---|---|---|
| 웹 검색/코드 검색 | search | references/search.md |
| 샤오홍슈/트위터/빌리빌리/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| 채용/직무/LinkedIn/보스지핀 | career | references/career.md |
| GitHub/코드 | dev | references/dev.md |
| 웹/문서/RSS | web | references/web.md |
| YouTube/빌리빌리/팟캐스트 자막 | video | references/video.md |
| 쉐치우/주식 시세 | finance | references/finance.md |
설정 필요 없는 빠른 명령
# Exa 웹 검색
mcporter call exa.web_search_exa query="query" numResults=5
# 일반 웹 페이지 읽기
curl -s "https://r.jina.ai/URL"
# GitHub 검색
gh search repos "query" --sort stars --limit 10
# YouTube 자막 (참고: 빌리빌리는 yt-dlp를 사용하지 마십시오. 실패 시 재시도 체인은 video.md 참조)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX 인기 글
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# 빌리빌리 검색 (bili-cli, 로그인 불필요)
bili search "query" --type video -n 5
로그인 상태가 필요한 플랫폼 (doctor의 active_backend에 따라 명령 선택)
Twitter 참고: agent-reach configure twitter-cookies로 저장된 Cookie는 doctor가 설정이 완료되었는지 확인하는 용도로만 사용됩니다. doctor는 twitter status를 실행하지 않으며, 현재 Shell을 설정하지도 않습니다. twitter를 직접 실행하기 전에, 하위 프로세스 환경에 TWITTER_AUTH_TOKEN과 TWITTER_CT0를 명시적으로 제공해야 하며, 로그나 명령 출력에 값을 노출하지 마십시오.
샤오홍슈 참고: Agent Reach는 사용자를 대신하여 로그인하지 않으며, 브라우저 Cookie를 읽지 않습니다. OpenCLI는 사용자가 이미 보유하고 명시적으로 제어하는 Chrome 세션만 사용합니다. 기존 세션이 없으면 자동 로그인하지 말고, Cookie-Editor를 사용하여 수동으로 내보낸 후 xiaohongshu-mcp / 기존 도구를 설정하십시오.
보스지핀 설정 트리거: 사용자가 "보스지핀 설정 도와줘"라고 말하면, 먼저 references/career.md의 보스지핀 섹션을 읽은 후, 설치 권한을 받은 다음 agent-reach install --env=local --system --channels=boss를 실행하십시오. Agent는 시스템 시작에 따라 127.0.0.1:9222만 바인딩하는 전용 Chrome을 시작해야 합니다. 시작 후 첫 번째 단계는 일시 중지하고 사용자가 창 내부에 로그인 상태(오른쪽 상단에 프로필 이미지)가 있는지 육안으로 확인하도록 한 다음, 사용자가 확인(미로그인 시 사용자가 로그인/QR 코드 스캔)한 후 boss --cdp-url http://localhost:9222 login --cdp 및 agent-reach doctor로 검증하십시오. 사용자가 포트 매개변수를 스스로 연구하도록 하지 마십시오. 전용 Chrome 프로필은 장기간 재사용해야 하며, 매번 생성하지 말고, 기본 일상 메인 Chrome으로 대체하지 마십시오.
CDP 브라우저 로그인 상태 판단 시 boss status를 믿지 마십시오(로컬 session.enc만 확인하며, 브라우저 로그인 상태와 상호 대표하지 않음). agent-reach doctor의 브라우저 쿠키 감지(wt2)를 기준으로 하고, 사용자의 육안 확인을 함께 사용하십시오. 절대 현재 페이지 URL로 로그인 상태를 판단하지 마십시오. security-check / zhipin-security / _security_check 보안 검증 페이지는 보스지핀의 안티 크롤링 챌린지이며, 로그인과 무관합니다. 이미 로그인한 상태에서도 나타날 수 있습니다(CDP 디버그 포트가 있는 Chrome에서는 거의 항상 나타남). 이를 보고 "미로그인"으로 간주하지 말고, 먼저 agent-reach doctor를 실행하여 브라우저 쿠키를 확인한 후, 사용자 로그인이 필요한지 결정하십시오. 검색 시 AUTH_EXPIRED 오류가 발생하면 이는 브라우저가 미로그인 상태임을 나타내는 결정적 증거입니다. 바로 로그인 절차 + login --cdp를 진행하고, 보안 검증 방향으로 설명하지 마십시오.
검색 실행 시 반드시 boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...를 사용하십시오. ENVIRONMENT_RISK가 발생하면 즉시 중단하고, 새로고침, 재로그인, 자동 재시도를 하지 마십시오.
# Twitter 검색 (twitter-cli 우선; 실패 시 재시도 체인은 social.md 참조)
twitter search "query" -n 10
# Reddit (설정 불필요 경로 없음: OpenCLI 또는 rdt-cli, 로그인 상태 필수)
opencli reddit search "query" -f yaml # 데스크탑
rdt search "query" --limit 10 # 기존/서버
# 샤오홍슈 (데스크탑에서는 OpenCLI 우선)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram (데스크탑 OpenCLI, 브라우저 로그인 상태 재사용)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # 사용자 검색
opencli instagram user USERNAME -f yaml # 특정 사용자의 최근 게시물 읽기
환경 확인
# 사용 가능한 채널과 각 플랫폼의 현재 활성화된 백엔드 확인
agent-reach doctor --json
OpenCLI 어댑터 발견
라우팅 테이블이 사용자가 필요한 플랫폼이나 명령을 포함하지 않는 경우, 먼저 opencli list로 기존 어댑터를 확인한 다음, opencli <platform> --help로 공개 명령을 확인하십시오. 어댑터가 존재한다고 해서 로그인 상태나 대상 콘텐츠의 가용성이 보장되는 것은 아닙니다. 사용자 작업이 해당 플랫폼을 명확히 필요로 하는 경우에만 읽기 전용 명령을 실행하고, 실제로 비어 있지 않은 콘텐츠로 검증하십시오.
작업 공간 규칙
agent workspace에 파일을 생성하지 마십시오. 임시 출력은 /tmp/를 사용하고, 영구 데이터는 ~/.agent-reach/를 사용하십시오.
상세 문서
사용자 요구에 따라 해당 상세 문서를 읽으십시오.
- 검색 도구 — Exa AI 검색
- 소셜 미디어 — 샤오홍슈, Twitter, 빌리빌리, V2EX, Reddit, Facebook, Instagram (멀티 백엔드/로그인 상태 명령 그룹)
- 직장 채용 — LinkedIn, 보스지핀
- 개발 도구 — GitHub CLI
- 웹 페이지 읽기 — Jina Reader, RSS
- 비디오 팟캐스트 — YouTube, 빌리빌리, 샤오위저우
- 금융 시세 — 쉐치우 주식 시세, 검색, 인기 콘텐츠
설정 채널
특정 채널을 설정해야 하는 경우, 설치 가이드를 확인하십시오. https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
사용자는 쿠키만 제공하면 되며, 나머지 설정은 agent가 수행합니다.