IA by DNACX

#14 no GitHub · Pesquisa e entendimento

Como usar o Agent Reach no Claude Code: passo a passo

O Agent Reach instala para o seu agente as ferramentas que ele não alcança sozinho: plataformas que exigem login, legendas e áudio de vídeos, sites chineses e dados organizados do GitHub e de outros sites. Depois de instalado, o agente usa tudo com um comando.

Para quem
Quem usa o Claude Code e quer que ele leia conteúdo de YouTube, Bilibili, Reddit, GitHub e outros lugares que a busca comum do agente cobre mal. O README está em chinês e boa parte dos canais é de plataformas chinesas.
Estrelas (02/11/2026)
108.067, #14 no ranking
Licença
MIT
Repositório
Panniantong/Agent-Reach

Passo a passo

Antes de começar: Claude Code (ou outro agente de linha de comando) com permissão para executar comandos no seu computador; uv, um instalador de programas. Se não tiver, o agente instala e avisa você. Segundo o README, não pede senha de administrador.

  1. Libere o Claude Code para executar comandos

    O agente faz a instalação sozinho, então precisa poder rodar comandos. Se ele disser que não pode, abra as configurações dele e ative a opção de permitir execução de comandos.

  2. Envie ao Claude Code a frase de instalação

    Cole a frase abaixo na conversa, exatamente como está. Ela aponta para o guia de instalação que o agente lê e executa. O README diz que o mesmo comando serve para instalar e para atualizar.

    Comando
    帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md

  3. Responda às perguntas do agente durante a instalação

    Ele pode pedir permissão para rodar comandos, avisar que vai instalar o uv e perguntar quais canais opcionais você quer. Ao final, ele conta quais canais já funcionam: B站, V2EX, GitHub, YouTube e leitura de páginas web.

  4. Peça o estado das ferramentas

    Converse com o agente em linguagem normal. A frase do primeiro teste faz ele dizer quais canais estão funcionando e quais quebraram. Depois, é só pedir o que quiser ler, e ele escolhe a ferramenta certa.

Primeiro teste

Numa sessão do Claude com a skill instalada, cole:

Primeiro teste
看看 Agent Reach 状态

Segundo o README, o agente informa o estado de cada canal: se funciona agora e quais estavam bons da última vez e agora estão quebrados. O README dá a frase em chinês e não diz se uma frase equivalente em português funciona.

Cuidados

  • O README manda instalar só pelo guia do GitHub do projeto. O pacote chamado agent-reach no PyPI não é este projeto e não deve ser instalado.
  • O instalador roda comandos no seu computador por meio do agente. No guia de instalação (docs/install.md, lido em 02/11/2026), se faltar o uv, o agente baixa e executa um script de astral.sh (curl com sh no macOS e Linux, PowerShell no Windows). Depois instala o programa com um arquivo zip do GitHub do projeto e roda agent-reach setup.
  • Para plataformas que exigem login, o Agent Reach usa um navegador próprio, em segundo plano. Na primeira vez em cada site, ele copia o login que você já tem no seu Chrome para esse navegador. O README diz que o Chrome original não muda, que ele não lê o cofre de senhas e que nunca pede a sua senha.
  • O login copiado costuma ser o da sua conta principal. O README recomenda trocar por uma conta secundária, porque as plataformas podem limitar contas com acesso automatizado.
  • O README diz que o Agent Reach só lê e busca. Não publica, não comenta, não curte e não manda mensagem.
  • Algumas funções precisam de chave de API. A transcrição de áudio do YouTube exige chave Groq ou OpenAI, e a transcrição de podcast do Xiaoyuzhou exige chave Groq. O README manda digitar a chave no seu próprio terminal com agent-reach configure groq-key, nunca na conversa.
  • Os canais têm níveis. Os canais padrão funcionam ao instalar. Os opcionais você pede depois. Os experimentais (Twitter, Facebook, Instagram) podem parar de funcionar a qualquer momento por causa do bloqueio das plataformas.
  • Tudo que ele instala fica numa única pasta, ~/.agent-reach/, segundo o README.
  • O README avisa que o projeto não tem moeda, token, carteira ou taxa de resgate. Qualquer projeto de criptomoeda com o nome Agent Reach não tem relação com ele.

Como desfazer

Diga ao agente "卸载 Agent Reach". Ele lista o que vai apagar, espera a sua confirmação e remove só o que o Agent Reach instalou, sem tocar nos seus outros arquivos nem no navegador. No fim, ele explica como remover o próprio programa.

Desfazer
卸载 Agent Reach

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README está em chinês e não diz se frases em português funcionam com o agente. As frases de exemplo (instalar, ver estado, desinstalar) estão só em chinês.
  • O README não diz se é preciso abrir uma sessão nova do Claude Code depois de instalar. O guia docs/install.md só manda abrir um novo shell se o comando agent-reach não for encontrado.
  • O README não lista requisitos de sistema operacional. O guia docs/install.md traz comandos para macOS, Linux e Windows.
  • O README cita o selo de Python 3.10+, mas a instalação é feita com uv e o README não diz se é preciso ter Python antes.
  • O README não menciona custo, e os custos de Groq ou OpenAI não foram verificados.
  • Os comandos de adicionar e remover canais (agent-reach add, agent-reach remove) estão no guia docs/install.md, não no README principal. O README principal mostra só a frase em linguagem normal.
  • A instalação não foi testada, e o guia sobre sessões (agent_reach/skill/references/sessions.md) e o troubleshooting.md não foram lidos.

Dúvidas

Ele mexe no meu navegador e nas minhas contas?

Usa um navegador próprio, em segundo plano. Na primeira vez em cada site que exige login, copia o login desse site do seu Chrome, sem alterar o Chrome e sem ler o cofre de senhas. O README recomenda usar uma conta secundária, pois o login copiado costuma ser o da conta principal.

Como adiciono ou removo um canal, como o Reddit?

Peça ao agente em linguagem normal. O README mostra frases como "加上小红书" (adicionar) e "去掉小红书" (remover), e diz que a lista de canais com o que cada um faz aparece com o comando agent-reach channels.

Preciso falar chinês para usar?

O README e as frases de exemplo dele estão em chinês. Ele manda falar com o agente "em linguagem normal" (大白话), mas não diz se pedidos em português funcionam. O guia de instalação que o agente lê (docs/install.md) está em inglês.

A DNACX já usou o Agent Reach?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próxima da lista

← #13 Taste · #15 Impeccable →

Ver as 15 skills

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de Panniantong/Agent-Reach, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.