O que Agent Reach — Roteador de Capacidades da Internet faz?
16 plataformas, múltiplos backends. Esta habilidade deve ser usada para acessar essas plataformas; não invente suas próprias soluções.
Regras Permanentes (aplicam-se a todo momento)
- Verifique a saúde antes de agir: Para plataformas com múltiplos backends / exigem login (Xiaohongshu/Reddit/Bilibili/Twitter/Facebook/Instagram/Boss直聘), execute primeiro
agent-reach doctor --json. Seactive_backendtiver valor, escolha o grupo de comandos de acordo;active_backend: nullsignifica que o Doctor não fez verificação em tempo real para evitar disparar leitura de cookies do navegador ou escrita remota, o que não indica que o backend não exista. O resultado do Doctor é um "instantâneo de um momento", o canal / estado de login pode ter mudado; antes de executar comandos somente leitura, se suspeitar de invalidação, verifique novamente com o runbook "Verificação e Recuperação" da referência correspondente (por exemplo, a solução de Boss直聘 CDP em career.md). - Declare o que está usando: Antes de começar a trabalhar, diga "Usando a plataforma X / backend Y do agent-reach".
- Em caso de falha, siga a cadeia de repetição das referências, não adivinhe comandos.
- Tarefas de pesquisa abrangente: Combine múltiplas plataformas (pesquisa Exa + Twitter/Reddit para discussões + Xiaohongshu/Bilibili para cenário chinês), colete em paralelo e depois resuma.
- Fique de olho na versão: Após concluir uma tarefa grande de pesquisa/multiplataforma, execute
agent-reach check-update(rápido, uma chamada de API). Se houver nova versão, inclua uma frase no relatório final: "O Agent Reach tem uma nova versão vX.Y.Z, copie esta frase para mim para atualizar: Me ajude a atualizar o Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md". Não interrompa a tarefa atual para atualizar, nem repita o lembrete da mesma versão.
Tabela de Roteamento
| Intenção do usuário | Categoria | Documentos Detalhados |
|---|---|---|
| Pesquisa na web / pesquisa de código | search | references/search.md |
| Xiaohongshu/Twitter/Bilibili/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| Vagas/empregos/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/código | dev | references/dev.md |
| Páginas web/artigos/RSS | web | references/web.md |
| YouTube/Bilibili/legendagem de podcasts | video | references/video.md |
| Xueqiu/cotações de ações | finance | references/finance.md |
Comandos Rápidos com Configuração Zero
# Exa pesquisa na web
mcporter call exa.web_search_exa query="query" numResults=5
# Leitura universal de páginas web
curl -s "https://r.jina.ai/URL"
# Pesquisa no GitHub
gh search repos "query" --sort stars --limit 10
# Legendas do YouTube (Nota: para Bilibili não use yt-dlp, cadeia de repetição em caso de falha veja video.md)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX populares
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# Pesquisa no Bilibili (bili-cli, sem login)
bili search "query" --type video -n 5
Plataformas que Exigem Login (escolha o comando conforme o active_backend do doctor)
Twitter Nota: Os cookies salvos com agent-reach configure twitter-cookies servem apenas para
doctor verificar se a configuração está completa; doctor não executa twitter status, nem configura o
Shell atual. Antes de executar twitter diretamente, é necessário fornecer explicitamente no ambiente do subprocesso
TWITTER_AUTH_TOKEN e TWITTER_CT0, sem expor seus valores em logs ou echo de comandos.
Xiaohongshu Nota: O Agent Reach não faz login pelo usuário, nem lê cookies do navegador. OpenCLI usa apenas sessões Chrome existentes e controladas explicitamente pelo usuário; se não houver sessão pronta, não faça login automático, use Cookie-Editor exportado manualmente para configurar xiaohongshu-mcp / ferramentas existentes.
Gatilho de configuração do Boss直聘: Quando o usuário disser "Me ajude a configurar o Boss直聘", primeiro leia a seção Boss de references/career.md,
depois, após obter autorização de instalação, execute
agent-reach install --env=local --system --channels=boss. O Agent é responsável por iniciar um Chrome dedicado que vincula apenas
127.0.0.1:9222; o primeiro passo após a inicialização é pausar e deixar o usuário confirmar visualmente
que a janela está logada (avatar no canto superior direito); se não estiver logado, deixe o usuário logar/escaneie o código QR, e só após confirmação execute
boss --cdp-url http://localhost:9222 login --cdp e agent-reach doctor para validação.
Não faça o usuário estudar parâmetros de porta.
O perfil Chrome dedicado deve ser reutilizado a longo prazo, não crie um novo a cada vez, nem use o navegador principal do dia a dia.
Para julgar o estado de login do CDP, não confie em boss status (ele só verifica o session.enc local, que não corresponde ao estado de login do navegador); use a detecção de cookies do navegador agent-reach doctor (wt2) como referência, combinada com confirmação visual do usuário. Nunca use a URL da página atual para julgar login:
security-check / zhipin-security / _security_check são páginas de desafio anti-raspagem do Boss直聘, não relacionadas ao login — usuários logados também podem vê-las (quase certo com portas de depuração CDP). Não as interprete como "não logado", execute primeiro agent-reach doctor para ver os cookies do navegador, e então decida se o usuário precisa fazer login. O erro de pesquisa AUTH_EXPIRED é a verdade fundamental de que o navegador não está logado: vá diretamente para o fluxo de login + login --cdp, não explique na direção de verificação de segurança.
Ao executar pesquisa, use
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...;
se encontrar ENVIRONMENT_RISK, pare imediatamente, não recarregue, não faça login novamente, não tente automaticamente.
# Pesquisa no Twitter (twitter-cli preferido; cadeia de repetição em caso de falha veja social.md)
twitter search "query" -n 10
# Reddit (sem caminho de configuração zero: OpenCLI ou rdt-cli, exige login)
opencli reddit search "query" -f yaml # desktop
rdt search "query" --limit 10 # existente/servidor
# Xiaohongshu (desktop: prefira OpenCLI)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram (desktop OpenCLI, reutiliza estado de login do navegador)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # pesquisa usuários
opencli instagram user USERNAME -f yaml # lê posts recentes de um usuário específico
Verificação de Ambiente
# Verificar canais disponíveis e o backend atualmente ativo de cada plataforma
agent-reach doctor --json
Descoberta de Adaptadores OpenCLI
Se a tabela de roteamento não cobrir a plataforma ou comando que o usuário precisa, primeiro use opencli list para ver os adaptadores existentes, depois use opencli <plataforma> --help para ver os comandos públicos. Descobrir um adaptador apenas prova que o comando existe, não que o login ou o conteúdo alvo estão disponíveis; execute comandos somente leitura apenas quando a tarefa do usuário exigir explicitamente essa plataforma, e valide com conteúdo não vazio real.
Regras de Área de Trabalho
Não crie arquivos no agent workspace. Use /tmp/ para saída temporária e ~/.agent-reach/ para dados persistentes.
Documentos Detalhados
De acordo com a necessidade do usuário, leia o documento detalhado correspondente:
- Ferramentas de Pesquisa — Pesquisa Exa AI
- Mídias Sociais — Xiaohongshu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (grupos de comando com múltiplos backends / exigem login)
- Carreira e Empregos — LinkedIn, Boss直聘
- Ferramentas de Desenvolvimento — GitHub CLI
- Leitura na Web — Jina Reader, RSS
- Vídeos e Podcasts — YouTube, Bilibili, Xiaoyuzhou
- Mercado Financeiro — Cotações de ações Xueqiu, pesquisa e conteúdos populares
Canais de Configuração
Se algum canal precisar de configuração, obtenha o guia de instalação: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
O usuário só precisa fornecer cookies, outras configurações são feitas pelo agent.