에이전트 리치 사용법 2026: 마케터·기획자·영업이 직무별로 시작하는 순서와 복사용 요청문

에이전트 리치: AI 에이전트(내 대신 컴퓨터에서 일을 실행해 주는 AI)가 YouTube, GitHub(개발자들이 코드를 공개해 두는 사이트), X, Reddit 같은 인터넷 플랫폼을 읽고 검색할 수 있게, 필요한 도구를 골라 설치하고 점검해 주는 오픈소스(코드가 공개돼 누구나 쓸 수 있는) 프로그램이에요. 영문 이름은 Agent Reach이고 클로드 코드 같은 에이전트와 함께 씁니다.

에이전트 리치는 정확히 무엇을 해 주나요?

에이전트 리치는 읽기 도구가 아니라 도구 상자 관리자에 가까워요. 프로젝트 README(저장소 첫 화면의 설명서)에 따르면 실제로 영상을 읽고 글을 검색하는 일은 yt-dlp, gh, twitter-cli 같은 기존 도구가 하고 에이전트 리치는 그 도구들을 골라 설치하고 쓸 수 있는지 점검해 줘요.

그래서 이 글에서 "에이전트 리치가 해 주는 일"은 딱 둘이에요. 도구 설치와 상태 점검이에요. 읽어 온 내용을 요약하고 표로 만들고 문장으로 다듬는 일은 클로드 코드가 해요. 에이전트 리치에 댓글 자동 수집이나 감성 분석 리포트 같은 기능이 있다고 확인한 적은 없어요.

호환되는 에이전트는 Claude Code(클로드 코드), OpenClaw, Cursor(AI 코드 편집기), Windsurf처럼 명령을 실행할 수 있는 것들이에요. 이 글은 클로드 코드 기준으로 설명할게요. 라이선스는 MIT(누구나 쓰고 고칠 수 있게 허용한 오픈소스 조건)이고 이 글을 쓴 2026년 10월 10일 기준 최신 릴리스는 v1.5.0(2026년 6월 11일 공개)이에요.

시작 전에 무엇이 필요한가요?

준비물은 세 가지예요.

클로드 코드(터미널에서 말로 지시하면 일을 대신 해 주는 AI 도구)가 설치된 컴퓨터예요. 아직이라면 클로드코드 설치 가이드를 먼저 따라 하세요.
Pro 이상의 유료 계정이에요. 공식 문서에 따르면 Claude Code는 Pro, Max, Team, Enterprise, Console 계정이 필요하고 무료 claude.ai 플랜에는 포함되지 않아요.
Python 3.10 이상이에요. 에이전트 리치가 파이썬(프로그램 실행 환경 중 하나)으로 만들어져서 필요해요. 설치를 맡기면 클로드 코드에게 버전 확인도 함께 시켜 보세요.

"에이전트 리치는 무료"라는 말을 보셨다면 절반만 맞아요. 에이전트 리치와 연결되는 플랫폼 이용료는 없지만 그걸 시킬 클로드 코드는 유료 계정이 있어야 해요. 비용은 마지막 섹션에서 한 번 더 정리할게요.

공통 시작 3단계: 설치, 확인, 안전 점검

직무와 상관없이 처음 한 번은 이 순서로 해요.

터미널에서 claude를 입력해 클로드 코드를 켜요. 에이전트가 있어야 설치를 맡길 수 있어서예요.
아래 문장을 그대로 붙여 넣어요. README가 안내하는 방식이고 클로드 코드가 설치 가이드를 읽고 필요한 단계를 알아서 진행해요.
설치가 끝나면 agent-reach doctor를 실행해요. 지금 어떤 플랫폼이 쓸 수 있는 상태인지 한눈에 보여 주기 때문이에요.

아래 문장을 클로드 코드 입력창에 그대로 붙여 넣으세요. 에이전트가 설치 가이드 주소를 읽고 설치를 진행해 줘요.

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

설치가 끝나면 점검 명령을 실행해요. 터미널에 직접 입력해도 되고 클로드 코드에게 "agent-reach doctor 실행해서 결과를 쉬운 말로 설명해줘"라고 시켜도 돼요. 아래 명령은 채널별로 지금 쓸 수 있는지, 안 된다면 어떻게 고치는지 보여 줍니다.

agent-reach doctor

결과에서 YouTube와 웹은 바로 사용 가능으로 나오고 GitHub는 로그인 전이면 안내가 나오고 X와 Reddit은 설정이 안 됐다고 나오는 게 정상이에요. 처음부터 전부 초록불일 필요는 없어요.

안전 면에서 한 가지 알아 둘 게 있어요. README에 따르면 기본 설치(agent-reach install)는 읽기 전용 점검만 하고 컴퓨터 설정을 바꾸는 작업은 내가 승인했을 때만 --system 옵션으로 실행돼요. 에이전트가 승인을 구하면 무엇을 바꾸는지 읽어 본 뒤 허락하세요.

직접 설치하고 싶다면 아래 두 줄을 쓰면 돼요. 첫 줄이 GitHub에서 프로그램을 내려받아 설치하고 둘째 줄은 내 컴퓨터에 빠진 것이 무엇인지 점검만 해요. 실제 설치·설정은 내가 승인한 뒤 --system 옵션을 붙였을 때만 진행돼요. 맥은 pipx(파이썬 프로그램을 따로 격리해 설치해 주는 도구)나 가상환경을 권장해요.

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

마케터는 YouTube 먼저, Reddit은 그다음이에요

마케터의 첫 작업은 "사람들이 이 주제를 어떻게 말하는지 찾기"예요. 이 순서를 권하는 이유는 준비물 차이 때문이에요. YouTube는 README와 소스 코드 기준으로 설정 없이 자막 추출과 영상 검색이 되고 Reddit은 설정 없이 쓰는 경로가 없어요.

1단계: YouTube로 오늘 바로 시작해요

agent-reach doctor에서 YouTube가 사용 가능이면 바로 시켜 볼 수 있어요. 아래 문장의 괄호 부분만 내 제품이나 업계 말로 바꿔서 클로드 코드에 붙여 넣으세요. 영상 3개의 자막을 읽고 공통점과 차이를 표로 만들어 주는 요청이에요.

agent-reach의 YouTube 기능으로 "(내 제품 분야) 추천"을 검색해서 상위 영상 3개를 찾아줘.
각 영상의 자막을 읽고, 영상마다 강조하는 장점과 주의하라고 말하는 점을 표로 정리해줘.
마지막에 세 영상이 공통으로 말하는 내용 3가지와, 우리 마케팅 문구에 써볼 만한 표현 후보 3개를 적어줘.

여기서 읽는 건 영상 속 말이에요. 시청자 댓글이 아니라 만든 사람이 한 말이라서, "시청자 반응"이 아니라 "업계가 이 주제를 어떻게 설명하는지"를 보는 작업으로 이해하세요.

2단계: Reddit은 로그인 상태를 설정한 뒤에요

Reddit은 소스 코드 기준으로 로그인 상태가 필수예요. 설정 방법은 두 가지로, 데스크톱 OpenCLI(브라우저에 로그인해 둔 상태를 그대로 재사용하는 도구)를 쓰거나 rdt-cli에 쿠키를 넣는 방식이에요. 쿠키(로그인했다는 표시가 담긴 작은 파일)를 쓰는 방식이니 아래 "처음 하면 여기서 막힙니다"의 계정 주의를 먼저 읽어 주세요.

설정은 에이전트에게 맡겨요. README는 "X 설정 도와줘"처럼 말하면 필요한 단계를 안내해 준다고 해요. Reddit도 같은 방식으로 아래처럼 시키면 됩니다. 이 요청은 Reddit 연결 방법 두 가지를 비교해 주고 내가 할 단계를 하나씩 안내해 달라는 내용입니다.

Reddit 설정 도와줘. 내 컴퓨터에서 로그인 상태를 쓰는 방법과 쿠키를 쓰는 방법 중
어느 쪽이 나한테 맞는지 먼저 설명해주고, 내가 해야 할 일을 한 단계씩 알려줘.

설정이 끝나서 agent-reach doctor에 Reddit이 사용 가능으로 뜨면 아래 요청을 쓰세요. 지정한 커뮤니티에서 인기 글을 읽고 불만과 질문을 나눠 정리하는 요청이에요.

agent-reach의 Reddit 기능으로 "(내 분야 키워드)"를 검색해서 최근 인기 글 5개를 읽어줘.
글쓴이들이 겪는 불만, 자주 나오는 질문, 쓰는 용어를 따로 묶어서 표로 정리해줘.

기획자는 GitHub 공개 저장소로 분야 흐름을 봐요

기획자의 첫 작업은 "내 분야에서 요즘 어떤 도구와 서비스가 만들어지는지 보기"예요. GitHub는 개발자들이 코드를 공개해 두는 곳이라, 새로운 시도는 보통 저장소(코드와 설명서를 모아 둔 공개 폴더) 형태로 먼저 올라와요. 코드를 읽을 필요는 없어요. 각 저장소의 README만 읽어도 무슨 프로젝트인지 알 수 있어요.

GitHub는 gh CLI(GitHub용 명령 도구)로 읽는데, 쓰려면 먼저 로그인이 필요해요. README 기준으로 GitHub 무료 계정이면 충분하고 로그인 후에야 doctor에 사용 가능으로 표시돼요. 클로드 코드에게 "gh auth login 하는 방법을 한 단계씩 알려줘"라고 시켜서 안내대로 따라가면 돼요. 브라우저 창이 열리면 GitHub에 로그인해서 승인하는 방식이에요.

로그인이 끝나면 아래 요청을 쓰세요. 공개 저장소를 검색해서 흐름을 3가지로 요약하는 요청이에요.

agent-reach의 GitHub 기능으로 "(내 분야 키워드)" 관련 공개 저장소를 검색해줘.
최근에 갱신된 것 위주로 5개를 골라 README를 읽고, 저장소마다 무슨 문제를 푸는 프로젝트인지 한 줄로 적어줘.
마지막에 5개를 보고 보이는 분야의 흐름 3가지와, 우리 서비스 기획에 참고할 점 3가지를 정리해줘.

결과의 "흐름"은 클로드 코드가 읽어 온 README를 바탕으로 정리한 해석이에요. 기획서에 넣을 때는 저장소 주소를 같이 받아 두면 나중에 출처로 쓸 수 있어요. "저장소 주소도 함께 적어줘"를 한 줄 덧붙이세요.

영업은 X에서 고객이 쓰는 말을 찾아요

영업의 첫 작업은 "잠재 고객이 우리 분야 불만을 어떤 말로 하는지 찾기"예요. X(옛 트위터)는 검색, 타임라인 읽기, 긴 글 읽기가 되는데, README 기준으로 쿠키 설정을 한 뒤에야 쓸 수 있어요. 에이전트 리치가 지원하는 방식은 Cookie-Editor라는 브라우저 확장 프로그램으로 내가 직접 내보낸 쿠키를 쓰는 것뿐이에요.

여기서 가장 중요한 건 계정이에요. 프로젝트는 쿠키로 로그인하는 플랫폼에서 계정 정지 위험이 있다고 직접 경고하고 본 계정 대신 전용 보조 계정을 쓰라고 권해요. 고객 응대에 쓰는 회사 대표 계정이나 개인 계정은 쓰지 마세요.

설정은 클로드 코드에게 맡기면 돼요. 아래처럼 시키면 필요한 단계를 순서대로 안내해 줘요.

X 설정 도와줘. 내 본 계정이 아니라 보조 계정으로 쓸 거야.
Cookie-Editor로 쿠키를 내보내는 단계부터 한 단계씩 알려줘.

doctor에서 X가 사용 가능으로 바뀌면 아래 요청을 쓰세요. 검색한 글을 불만, 칭찬, 질문으로 나누고 영업 첫 문장 후보까지 만드는 요청이에요. 문장 후보는 클로드 코드가 쓰는 초안이니 그대로 보내지 말고 담당자가 고쳐서 쓰세요.

agent-reach의 X 검색 기능으로 "(우리 제품 또는 경쟁사 이름)"을 검색해서 최근 글 20개를 읽어줘.
글을 불만, 칭찬, 질문 세 가지로 나눠서 표로 정리하고, 글마다 어떤 표현을 썼는지 짧게 인용해줘.
마지막에 불만 글을 쓴 사람에게 건넬 영업 첫 문장 후보를 3개 써줘. 광고처럼 들리지 않게 해줘.

처음 하면 여기서 막힙니다

막히는 지점은 크게 다섯 가지예요.

첫째, 같은 이름의 다른 프로그램을 설치했어요. PyPI(파이썬 프로그램을 모아 둔 공용 저장소)에 이름이 같은 패키지가 있는데, README에 따르면 이 프로젝트가 아니에요. pip install agent-reach처럼 이름으로 설치하지 말고 위의 GitHub 주소로 설치하세요. 에이전트에게 설치를 맡길 때도 위의 안내 문장을 그대로 쓰면 이 문제를 피할 수 있어요.

둘째, "Reddit이나 X도 설치하면 바로 된다"고 읽었어요. 그렇지 않아요. YouTube와 일반 웹 페이지는 설정 없이, GitHub는 무료 계정 로그인 후, X와 Reddit은 계정 쿠키 설정 후에 쓸 수 있어요. 저장소의 한국어 안내문에는 Reddit이 설정 없이 된다고 적힌 부분이 있는데, 중국어 정본 README와 소스 코드는 로그인이 필수라고 해요. 한국어판이 더 오래된 내용이라 정본 기준으로 따르세요.

셋째, doctor에서 X나 Reddit이 안 된다고 나와요. 설치가 잘못된 게 아니라 아직 설정 전이라는 뜻이에요. 지금 쓸 직무의 플랫폼부터 설정하세요. Reddit은 쿠키를 저장한 지 7일이 넘으면 doctor가 갱신하라고 안내해요.

넷째, 계정이 정지될까 걱정돼요. 쿠키로 로그인하는 방식이라 위험이 있다는 걸 프로젝트가 직접 인정해요. 본 계정 대신 이 용도로만 만든 보조 계정을 쓰고 한꺼번에 너무 많이 읽어 오게 시키지 마세요. 쿠키와 토큰(로그인 열쇠 역할을 하는 값)은 내 컴퓨터의 ~/.agent-reach/ 폴더에만 저장되고 업로드되지 않아요(파일 권한 600).

다섯째, 써 보고 지우고 싶어요. 아래 명령을 먼저 실행하면 실제로 지우지 않고 어떤 파일이 지워질지 미리 보여 줘요. 확인한 뒤 --dry-run을 빼고 실행하면 설정, 쿠키, 스킬 파일이 제거됩니다.

agent-reach uninstall --dry-run

비용은 얼마나 드나요?

에이전트 리치 자체는 MIT 라이선스 오픈소스이고 연결되는 도구도 모두 오픈소스라 플랫폼 API(프로그램이 플랫폼 데이터를 가져오는 공식 통로) 이용료는 없어요. 개인 컴퓨터에 설치하면 추가로 낼 돈이 없습니다.

서버에 설치할 때만 프록시(인터넷 접속을 중간에서 대신 전달하는 서버)가 필요해서 월 $1가 들어요. 개인 컴퓨터에서는 필요 없어요.

반드시 따로 챙겨야 하는 비용이 하나 있어요. 시키는 쪽인 클로드 코드는 Pro 이상 유료 계정이 필요해요. 요금은 바뀔 수 있으니 Claude 공식 요금제 페이지에서 직접 확인하세요.

마무리

에이전트 리치 사용법은 결국 세 줄이에요. 클로드 코드에 설치 문장을 붙여 넣고 agent-reach doctor로 상태를 보고 내 직무의 플랫폼부터 하나씩 열어 가세요. 마케터는 YouTube부터, 기획자는 GitHub 로그인부터, 영업은 보조 계정을 만든 뒤 X 설정부터 시작하면 가장 덜 막혀요.

한 번에 모든 플랫폼을 켜려고 하지 않는 게 요령이에요. 오늘은 설정 없이 되는 것 하나만 성공시켜 보고 그 결과가 쓸 만하면 다음 플랫폼으로 넘어가세요.

자주 묻는 질문

에이전트 리치는 무료인가요?

에이전트 리치와 연결 도구는 오픈소스(MIT)이고 플랫폼 API 이용료도 없어요. 다만 시키는 쪽인 클로드 코드는 Pro 이상 유료 계정이 필요하고 무료 플랜에는 포함되지 않아요. 서버에 설치할 때만 프록시 월 $1가 들어요.

설치만 하면 Reddit이나 X도 바로 쓸 수 있나요?

아니요. YouTube와 웹은 설정 없이 쓰고 GitHub는 무료 계정 로그인이 필요하고 X와 Reddit은 계정 쿠키 설정이 필요해요. agent-reach doctor가 채널별로 지금 쓸 수 있는지 알려 줘요.

코딩을 전혀 몰라도 쓸 수 있나요?

네. 설치도 설정도 클로드 코드에게 말로 시키는 방식이에요. 이 글의 코드 블록은 입력창에 붙여 넣는 문장이라 내용을 이해하지 못해도 따라 할 수 있어요.

계정이 정지될 수도 있나요?

쿠키로 로그인하는 X와 Reddit에서는 위험이 있어요. 프로젝트도 본 계정 대신 전용 보조 계정을 쓰라고 권해요. YouTube와 일반 웹은 계정이 필요 없어요.

어떤 에이전트와 함께 쓸 수 있나요?

README는 Claude Code, OpenClaw, Cursor, Windsurf처럼 명령을 실행할 수 있는 에이전트와 호환된다고 해요. 이 글은 클로드 코드 기준이에요.

에이전트 리치 사용법 2026: 마케터·기획자·영업이 직무별로 시작하는 순서와 복사용 요청문