Skill Extratora de Contatos Comerciais e Links de Redes Sociais
📖 Resumo
Esta skill integra dois templates do BrowserAct para cobrir dois cenários comuns. Quando o usuário fornece um nome de empresa, ela pesquisa no Google para extrair o site oficial e canais de redes sociais da empresa. Quando o usuário fornece uma URL de site, ela raspa o site para extrair links de perfis de redes sociais (LinkedIn, Facebook, X/Twitter, Instagram, YouTube, TikTok). O script detecta automaticamente o tipo de entrada e roteia para o template correto.
✨ Funcionalidades
- Sem Alucinações: Fluxos de trabalho predefinidos evitam alucinações generativas de IA, garantindo extração de dados estável e precisa.
- Sem Problemas de Captcha: Não é necessário lidar com reCAPTCHA ou outros desafios de verificação.
- Sem Restrições de IP: Não é necessário lidar com restrições regionais de IP ou geofencing.
- Execução Mais Rápida: As tarefas são executadas mais rapidamente em comparação com soluções de automação de navegador puramente baseadas em IA.
- Custo-Efetivo: Reduz significativamente os custos de aquisição de dados em comparação com soluções de IA de alto consumo de tokens.
🔑 Configuração da Chave de API
Antes de executar, verifique a variável de ambiente BROWSERACT_API_KEY. Se não estiver definida, não tome outras medidas; pergunte e aguarde o usuário fornecê-la.
O agente deve informar o usuário:
"Como você ainda não configurou a Chave de API do BrowserAct, por favor, visite o Console do BrowserAct para obter sua Chave."
🛠️ Parâmetros de Entrada
O agente deve determinar se a entrada é um nome de empresa ou uma URL de site e passá-la para o script. O script roteia automaticamente a solicitação para o template correto.
- Alvo (Nome da Empresa ou URL do Site)
- Obrigatório: Sim
- Tipo:
string - Descrição: O nome da empresa a ser pesquisada ou a URL direta do site para extrair links de redes sociais.
- Exemplo:
OpenAIouhttps://www.rotorooter.com/
🚀 Método de Invocação
O agente deve executar o seguinte comando para invocar a skill:
# Pesquisar por nome da empresa
python -u ./scripts/business_contact_social_links.py "OpenAI"
# Raspar por URL do site
python -u ./scripts/business_contact_social_links.py "https://www.rotorooter.com/"
⏳ Monitoramento da Execução
Como esta tarefa envolve operações automatizadas do navegador, pode levar vários minutos. O script gera logs de status com carimbo de data/hora continuamente (por exemplo, [14:30:05] Task Status: running).
Diretrizes para o agente:
- Monitore a saída do terminal enquanto aguarda.
- Enquanto novos logs de status aparecerem, a tarefa está sendo executada normalmente; não a julgue erroneamente como congelada.
- Considere acionar uma nova tentativa apenas se o status permanecer inalterado por muito tempo ou a saída parar sem um resultado final.
📊 Saída de Dados
Após a execução bem-sucedida, o script imprime dados JSON estruturados extraídos da resposta da API.
Se um Nome de Empresa foi fornecido, a saída inclui:
Company Name: O nome oficial da empresa.Current Page URL: A URL do site oficial.Social Media Information: Uma lista consolidada de perfis de redes sociais descobertos.
Se uma URL de Site foi fornecida, a saída inclui um array de objetos:
platform: Nome da plataforma (ex.: LinkedIn, YouTube).url: URL canônica do perfil externo.
⚠️ Tratamento de Erros e Nova Tentativa
Se ocorrer um erro durante a execução do script (por exemplo, flutuações de rede ou falha na tarefa), o Agente deve seguir esta lógica:
-
Verifique o Conteúdo da Saída:
- Se a saída contiver
"Invalid authorization", significa que a Chave de API é inválida ou expirou. Não tente novamente; oriente o usuário a verificar e fornecer a Chave de API correta. - Se a saída contiver
"concurrent"ou"too many running tasks", significa que o limite de tarefas simultâneas foi atingido. Não tente novamente; oriente o usuário a atualizar seu plano. O agente deve informar o usuário:"A tarefa atual não pode ser executada porque sua conta do BrowserAct atingiu o limite de tarefas simultâneas. Por favor, visite a Página de Upgrade do Plano BrowserAct para atualizar seu plano."
- Se a saída não contiver as palavras-chave de erro acima mas a tarefa falhou (por exemplo, a saída começa com
Error:ou retorna resultados vazios), o Agente deve re-executar automaticamente o script uma vez.
- Se a saída contiver
-
Limite de Novas Tentativas:
- A nova tentativa automática é limitada a uma vez. Se a segunda tentativa falhar, pare de tentar e relate o erro específico ao usuário.
🌟 Casos de Uso Típicos
- Enriquecimento de Leads de Vendas: Encontre o site oficial e canais sociais para uma lista de nomes de empresas.
- Prospecção de Influenciadores: Extraia todos os perfis de redes sociais do site pessoal de um criador.
- Análise de Concorrentes: Descubra quais plataformas de redes sociais uma empresa concorrente prioriza.
- Limpeza de Dados de CRM: Verifique e preencha links sociais ausentes e URLs oficiais para leads existentes.
- Marketing Multicanal: Construa listas segmentadas de empresas com presença ativa em redes sociais.
- Configuração de Monitoramento Social: Reúna rapidamente contas oficiais para monitorar menções à marca.
- Prospecção B2B: Combine com dados do Yellow Pages para construir perfis completos de inteligência de negócios.
- Avaliação de Parceiros: Avalie a pegada digital de um potencial parceiro de negócios usando apenas o nome.
- Construção de Diretórios: Automatize a coleta de links de sites e redes sociais para um diretório de negócios local.
- Rastreamento de Marcas: Monitore todos os canais oficiais de contato de marcas específicas na web.