Agent Reach: o Claude Code Lendo a Internet
Instale o Agent Reach, uma CLI que dá ao Claude Code leitura de páginas e YouTube, e veja o que exige login e pode bloquear a sua conta.
O que é
Agent Reach: o Claude Code Lendo a Internet
O Agent Reach é uma ferramenta de linha de comando (CLI) em Python que instala e confere os meios de leitura de que o seu agente precisa na web: páginas públicas, transcrição de vídeos do YouTube, RSS e, com configuração extra, canais como X, Reddit, Instagram, Facebook e LinkedIn. Neste tutorial você instala pela rota segura e testa o que funciona sem login.
O autor é Panniantong, a licença é MIT e o repositório tinha 100.297 estrelas em 20/10/2026. O Agent Reach é uma CLI chamada agent-reach que vem com uma skill (um SKILL.md) que ensina o Claude Code qual ferramenta chamar. Segundo o README, há duas formas de instalar: pela CLI ou pela skill.
A ressalva principal é o risco de plataforma. Páginas públicas e YouTube não pedem configuração, mas Instagram, X e LinkedIn dependem de login, cookie ou sessão de navegador, os termos dessas plataformas restringem a coleta automatizada de dados e a conta pode ser limitada ou banida.
Páginas públicas
Leitura de qualquer página pública pelo Jina Reader, sem configuração e sem chave.
Transcrição do YouTube
Legendas e busca de vídeos via yt-dlp, sem configuração.
Instalação em modo seguro
Por padrão o install só confere a máquina. O --system exige a sua aprovação.
Diagnóstico com doctor
O comando agent-reach doctor mostra o que está pronto, o que falta e qual backend cada canal usa.
Canais com login
X, Reddit, Instagram, Facebook e LinkedIn pedem cookie, sessão ou MCP extra, com risco de conta.
Nível: intermediário · Tempo estimado: ~25 min para a instalação segura e os dois testes sem login. Os canais com login levam mais tempo e não são necessários para o tutorial.
Risco ALTO de plataforma. Os termos de uso de LinkedIn, Instagram e X restringem a coleta automatizada de dados (scraping), e esses canais exigem login, cookie ou sessão do seu navegador. Contas usadas assim podem ser limitadas ou banidas: o README do Agent Reach avisa do risco e recomenda uma conta secundária. Leia o texto vigente dos termos de cada plataforma antes de usar. Esta página não incentiva raspar redes sociais. O caminho principal é páginas públicas e YouTube.
Dados de pessoas: nomes, perfis, e-mails e telefones são dados pessoais (LGPD). Nos exemplos desta página só aparecem nomes fictícios. Não monte lista de contatos para disparo, não publique prints com dados reais e não guarde mais do que precisa.
Instalação remota sem versão fixa. O comando do README instala o branch main (archive/main.zip), que muda sem aviso, e o install.md instrui o agente a instalar pacotes. Leia o install.md antes de colar, fixe um commit se quiser reprodutibilidade e só aprove o --system depois de ler a lista do que ele vai instalar. Não instale o pacote de mesmo nome do PyPI: o README avisa que não é este projeto.
Não testado neste tutorial: a instalação, o doctor, a leitura do YouTube, o canal do Instagram (OpenCLI), o LinkedIn e o uso com Codex ou Gemini. Os comandos vêm do README e do install.md lidos em 20/10/2026. Antes de usar, confira o doctor na sua máquina.
Pré-requisitos
- Claude Code instalado e logado (documentação oficial: https://code.claude.com/docs)
- Python 3.10 ou mais novo e o pipx (o README recomenda pipx; em Homebrew ou com PEP 668 use pipx ou um venv)
- Para o --system: aceitar que ele pode instalar gh CLI, Node.js e mcporter e configurar uma busca MCP (Exa). Sem a sua aprovação, ele não faz isso
- Para o Instagram e o Facebook: Chrome no desktop com a extensão OpenCLI e uma sessão que você controla, preferencialmente de conta secundária
- Custo: o Agent Reach é grátis (MIT). Os canais sem configuração não pedem chave. Os canais com login dependem da conta e das regras da plataforma
Conceitos-chave
- 01
CLI com uma skill
A CLI agent-reach instala e confere as ferramentas de leitura. Ela vem com uma skill (um SKILL.md) que ensina o Claude Code qual ferramenta chamar em cada caso. A skill é registrada quando você aprova o --system, ou à parte com npx skills add (passo abaixo). Segundo o README, o agente lê o SKILL.md e sabe o que chamar.
- 02
Canal e backend
Canal é a plataforma (YouTube, X, Instagram). Backend é a ferramenta por trás dele (yt-dlp, Jina Reader, OpenCLI). O doctor mostra qual backend cada canal usa hoje.
- 03
Sem configuração × com login
YouTube, páginas, RSS e GitHub público funcionam sem configurar. Reddit não tem caminho sem login, e Instagram, Facebook e perfis do LinkedIn pedem sessão, cookie ou MCP extra.
- 04
Jina Reader
Serviço que converte uma página em texto legível. A URL que você pede passa por um terceiro (r.jina.ai): não use com página privada nem com dado de cliente.
Passo a passo
- 01
Confira Python e pipx
O Python precisa ser 3.10 ou superior.
python3 --version pipx --version - 02
Leia o install.md antes de instalar
Abra o arquivo no navegador e leia o que ele manda o agente fazer. Ele é o roteiro que o Claude vai seguir.
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md - 03
Instale a CLI (README e install.md)
Este comando instala do branch main, sem versão fixa. Rode com pipx.
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip - 04
Opcional: fixe um commit
Para a instalação não mudar sem aviso, abra a aba Commits do repositório, copie o hash de um commit e use a variação abaixo. É uma forma padrão do pip para instalar do Git, não é o comando do README e não foi testada aqui.
pipx install git+https://github.com/Panniantong/Agent-Reach.git@[HASH] - 05
Faça só a verificação (modo seguro)
Por padrão, o install só confere gh CLI, Node.js, mcporter, a busca Exa e o yt-dlp e lista o que falta, sem alterar o sistema. Atenção: sem o --system, os canais sem login (páginas web, YouTube, GitHub, RSS) NÃO são ativados, e a skill não é registrada. Para ativá-los é preciso aprovar o próximo passo.
agent-reach install --env=auto - 06
Veja o que o --system faria
Antes de aprovar qualquer instalação de sistema, peça a prévia. O --system só deve rodar com a sua aprovação explícita, depois de ler a lista. É ele que ativa web, YouTube, GitHub e RSS. Se concordar com a lista, rode depois o mesmo comando com --system no lugar de --dry-run (agent-reach install --env=auto --system).
agent-reach install --env=auto --dry-run - 07
Alternativa: instale só a skill (README)
O README em inglês oferece a skill como segunda forma de instalar, para Claude Code e outros agentes com suporte a skills. Depois de instalada, o agente detecta se a CLI agent-reach existe e a instala se precisar. Esse caminho não foi testado aqui.
npx skills add Panniantong/Agent-Reach@agent-reach - 08
Confira o diagnóstico
O doctor mostra o que está pronto, o que falhou e qual backend cada canal usa.
agent-reach doctor - 09
Teste o que não exige login
Use os prompts de YouTube e de página pública abaixo. Comece por aí antes de pensar em qualquer rede social.
- 10
Opcional e arriscado: Instagram e Facebook pelo OpenCLI
Só se você aceitar o risco do aviso acima. Instale o canal, adicione a extensão OpenCLI no Chrome (link nas fontes) e rode o opencli doctor: deve mostrar Extension: connected.
agent-reach install --system --channels opencli
Prompts prontos
Troque cada palavra entre colchetes: [URL DO VÍDEO] é o link do YouTube que você quer entender, [URL DA PÁGINA] é uma página pública, [URL DA PÁGINA PÚBLICA DA EMPRESA] é a página de uma empresa que não exige login e [CONTA] é uma conta pública que você tem motivo legítimo para consultar. O primeiro prompt faz só a verificação e para antes de qualquer instalação de sistema.
Prompt: instalar em modo seguro (o pedido seguro do README)
Safely check and install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md Rode só a verificação (agent-reach install --env=auto), sem --system. Liste o que está faltando e espere minha aprovação antes de instalar qualquer coisa no sistema.
Prompt: resumir um vídeo do YouTube
Use o Agent Reach para pegar a transcrição de [URL DO VÍDEO] e me entregue: um resumo em 5 tópicos, as 3 ideias mais úteis para o meu negócio e as perguntas que o vídeo deixa sem resposta.
Prompt: ler uma página pública
Use o Agent Reach para ler [URL DA PÁGINA] e me diga do que ela trata, o que oferece e o que está sem resposta nela. Não acesse nada que exija login.
Prompt: entender o resultado do doctor
Rode agent-reach doctor e me explique, canal por canal, o que está pronto, o que exige login e o que tem risco de conta. Não corrija nada e não instale nada. Só relate.
Prompt: página pública de uma empresa, sem login
Leia a página pública [URL DA PÁGINA PÚBLICA DA EMPRESA] e resuma o que a empresa faz, o porte aparente e as vagas listadas. Não faça login, não use meus cookies e não navegue por perfis de pessoas.
Prompt: posts recentes de uma conta pública do Instagram
Com o canal do Instagram que eu já configurei, mostre os posts mais recentes da conta pública [CONTA] e o que eles têm em comum. Faça no máximo uma consulta, não siga outras contas e me avise se aparecer qualquer bloqueio ou pedido de verificação.
Erros comuns
- pipx: command not found → o pipx não está instalado → instale o pipx pela sua gerenciadora de pacotes e repita
- externally-managed-environment (PEP 668) → o Python do sistema não aceita pip global → use pipx ou crie um venv, como o install.md orienta
- agent-reach: command not found depois do pipx → a pasta do pipx não está no PATH → rode pipx ensurepath e abra um terminal novo
- Reddit aparece bloqueado ou 403 no doctor → o acesso anônimo foi bloqueado e não há caminho sem login → trate como canal com login ou deixe de fora
- Instagram não aparece como pronto → falta o OpenCLI ou a extensão no Chrome → instale o canal, adicione a extensão e confirme no opencli doctor (Extension: connected)
- O LinkedIn só traz a página pública → perfis, empresas e vagas completos exigem o mcp-server-linkedin e login → leia o install.md e pese o risco de conta antes de ligar
- A plataforma pediu verificação, bloqueou ou limitou a conta → uso automatizado detectado → pare, não repita e use conta secundária ou outra fonte
Checklist final
- Li o install.md antes de pedir ao Claude para instalar
- Rodei só agent-reach install --env=auto e li a lista do que faltava
- Só usei --system depois de ler e aprovar a prévia (--dry-run)
- O agent-reach doctor roda e eu entendi o que cada canal exige
- Testei uma página pública e um vídeo do YouTube antes de qualquer rede social
- Li os termos de cada plataforma antes de ligar um canal com login
- Nenhum dado real de pessoa foi salvo ou mostrado em print
Perguntas frequentes
O Agent Reach lê a internet inteira, sem restrição?
Não. Páginas públicas e YouTube funcionam sem configuração. Reddit não tem caminho sem login, e Instagram, Facebook, X e perfis do LinkedIn pedem login, cookie ou sessão, com risco de limitação da conta.
Preciso pagar alguma API?
Os canais sem configuração não pedem chave. O README explica que a API do X é paga e que por isso usa cookie. Cookie e login têm o risco de conta descrito acima.
Funciona com Codex ou Gemini?
O README cita Claude Code, OpenClaw, Cursor e Windsurf. Codex e Gemini não foram verificados.
Onde ficam meus cookies?
O README diz que ficam só na sua máquina, em ~/.agent-reach/config.yaml, com permissão 600 (só o seu usuário lê e escreve), e que não são enviados a ninguém.
Fontes oficiais
- README do Agent Reachgithub.com/Panniantong/Agent-Reach (abre em nova aba)
- Guia de instalação (install.md)raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md (abre em nova aba)
- README em inglêsgithub.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md (abre em nova aba)
- OpenCLI, usado no Instagram e no Facebookgithub.com/jackwener/opencli (abre em nova aba)
- Documentação do Claude Codecode.claude.com/docs (abre em nova aba)
Próximos passos
Comece agora
Pronto para colocar Agent Reach: o Claude Code Lendo a Internet para rodar?
Ver o Agent Reach no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo