icypeas-automation

Visão geral da skill icypeas-automation

O que a icypeas-automation faz

icypeas-automation é uma skill do Claude para executar tarefas de pesquisa e enriquecimento de leads no Icypeas por meio do Rube MCP da Composio. Em vez de codificar uma única ação fixa do Icypeas, a skill orienta o agente a descobrir primeiro o schema atual da ferramenta Icypeas, verificar a conexão e só então executar a ferramenta Rube correta para o fluxo de vendas ou pesquisa do usuário.

Melhor opção para equipes de pesquisa de leads

Esta skill é mais útil quando você já usa Icypeas ou quer que um agente de IA ajude na descoberta de prospects, localização de e-mails, enriquecimento de empresas/pessoas ou operações relacionadas de pesquisa de leads. Ela se encaixa bem em operações de vendas, times de growth, pesquisadores de recrutamento, fluxos de prospecção de agências e usuários técnicos que querem que o Claude acione ferramentas Icypeas com segurança, em vez de apenas redigir instruções manuais de pesquisa.

Principal diferencial: descobrir o schema primeiro

O comportamento mais importante da skill icypeas-automation é insistir em chamar RUBE_SEARCH_TOOLS antes da execução. Isso importa porque os schemas de ferramentas MCP podem mudar, e as ações do Icypeas podem expor campos obrigatórios diferentes dependendo do toolkit atual da Composio. Essa abordagem reduz chamadas com falha, exemplos desatualizados e parâmetros inventados em comparação com um prompt genérico.

Requisitos e limites de adoção

Para usar esta skill, o Rube MCP precisa estar disponível no seu cliente de IA, e a conexão do toolkit Icypeas deve estar ativa por meio de RUBE_MANAGE_CONNECTIONS. O repositório desta skill é intencionalmente enxuto: a orientação principal está em SKILL.md, sem scripts, regras ou arquivos de referência adicionais. Se você precisa de um pipeline completo de sincronização com CRM, uma camada de validação ou lógica personalizada de deduplicação, provavelmente terá que adicionar isso ao redor da skill.

Como usar a skill icypeas-automation

Caminho de instalação e configuração da icypeas-automation

Instale a skill a partir do repositório de origem com:

npx skills add ComposioHQ/awesome-claude-skills --skill icypeas-automation

Depois, configure o Rube MCP no seu cliente adicionando https://rube.app/mcp como servidor MCP. A skill depende do servidor MCP rube, não de um script local. Antes de pedir ao Claude para executar um fluxo do Icypeas, confirme que RUBE_SEARCH_TOOLS está disponível e use RUBE_MANAGE_CONNECTIONS com o toolkit icypeas para verificar se a conexão está ACTIVE. Se não estiver ativa, conclua primeiro o fluxo de autorização retornado.

Informações necessárias para uma execução confiável

Um bom prompt de icypeas-automation usage deve incluir o objetivo de negócio, os critérios de leads, os campos de saída exigidos, o volume, o nível de incerteza aceitável e quaisquer regras de exclusão. Por exemplo, “Encontre líderes prováveis de operações de vendas em empresas B2B SaaS na Alemanha” é melhor do que “encontre leads”, porque o agente consegue buscar as ferramentas Icypeas certas e mapear seus critérios para o schema em uso.

Entradas úteis incluem:

• Persona-alvo, senioridade, geografia, setor, porte da empresa ou lista de domínios
• Se você precisa de pessoas, empresas, e-mails, enriquecimento ou verificação
• Formato de saída, como tabela em estilo CSV, JSON, campos prontos para CRM ou resumo para revisão
• Restrições como “não enriquecer e-mails pessoais” ou “ignorar contas existentes”
• Critérios de sucesso, como confiança mínima, número máximo de registros ou campos obrigatórios

Transformando um objetivo vago em um prompt completo

Um prompt fraco diz: “Use Icypeas para obter leads.”

Um prompt mais forte diz: “Use a skill icypeas-automation para Lead Research. Primeiro descubra as ferramentas atuais do Icypeas com RUBE_SEARCH_TOOLS; depois confirme que a conexão do Icypeas está ativa. Preciso de até 50 prospects: VP Sales, Head of Revenue ou líderes de Sales Operations em empresas B2B SaaS com 50–500 funcionários na França e na Bélgica. Retorne nome, cargo, empresa, domínio da empresa, URL do LinkedIn se disponível, e-mail corporativo se disponível, ferramenta de origem usada e notas de confiança. Não inclua agências nem consultorias.”

Esse prompt melhora os resultados porque dá ao agente contexto suficiente para escolher ferramentas, preencher campos obrigatórios e avaliar se os registros retornados correspondem ao objetivo da pesquisa.

Arquivos para ler antes de usar o repositório

Comece por composio-skills/icypeas-automation/SKILL.md. Ele contém o padrão operacional real: pré-requisitos, configuração, descoberta de ferramentas, verificação de conexão, execução do fluxo e expectativas de tratamento de erros. Não há arquivos adicionais README.md, resources/, references/, rules/ ou scripts/ na pasta da skill, portanto não espere lógica de implementação escondida. O valor prático está na disciplina do fluxo MCP, especialmente na descoberta de ferramentas antes da execução.

FAQ da skill icypeas-automation

A icypeas-automation é só para usuários do Icypeas?

Sim, na prática. A skill foi projetada em torno do toolkit Icypeas da Composio via Rube MCP. Você pode instalá-la sem uma conexão ativa com o Icypeas, mas ela não executará fluxos úteis de pesquisa de leads até que a conexão do toolkit esteja autorizada e ativa.

Por que não pedir simplesmente ao Claude para pesquisar leads manualmente?

Um prompt genérico pode redigir critérios de pesquisa ou sugerir estratégias de busca, mas não consegue chamar ações atuais do Icypeas de forma confiável a menos que as ferramentas MCP estejam disponíveis e tenham sido descobertas. A icypeas-automation skill adiciona um padrão repetível: pesquisar schemas atuais de ferramentas, verificar autenticação, executar com campos conhecidos e lidar com falhas no nível da ferramenta.

É amigável para iniciantes?

É amigável para iniciantes se o seu cliente de IA já oferece suporte a MCP e você se sente confortável autorizando conexões com ferramentas externas. É menos indicada para quem espera um app de planilha com um clique. A skill pressupõe que você consiga verificar a disponibilidade do Rube MCP, inspecionar respostas das ferramentas e esclarecer critérios de leads quando o agente fizer perguntas de acompanhamento.

Quando eu não devo usar esta skill?

Não use icypeas-automation quando precisar de fontes de dados não compatíveis, pesquisa totalmente offline, precisão garantida de e-mails sem verificação ou governança complexa de CRM depois da coleta. Ela também é uma má escolha se você não puder compartilhar com o agente os critérios necessários de prospecção ou se a sua organização exigir aprovação manual antes de cada chamada de enriquecimento por terceiros.

Como melhorar a skill icypeas-automation

Melhore os resultados da icypeas-automation com critérios mais específicos

A melhor forma de melhorar a saída de icypeas-automation é restringir a solicitação de pesquisa antes da execução. Substitua categorias amplas como “empresas de tecnologia” por filtros explícitos: “empresas B2B SaaS que vendem software de RH, 100–1.000 funcionários, sediadas no Reino Unido, excluindo agências de recrutamento.” Filtros claros reduzem chamadas de enriquecimento irrelevantes e facilitam avaliar se os leads retornados são utilizáveis.

Modos de falha comuns para acompanhar

A maioria das falhas vem de conexões inativas, descoberta de schema ignorada, campos obrigatórios ausentes ou definições vagas de lead. Se uma chamada de ferramenta falhar, peça ao agente para executar novamente RUBE_SEARCH_TOOLS para o caso de uso específico e comparar os parâmetros tentados com o schema retornado. Se os resultados forem de baixa qualidade, refine o ICP antes de aumentar o volume; mais registros não corrigem uma segmentação fraca.

Itere depois da primeira saída

Trate a primeira execução como uma rodada de calibração. Peça um lote pequeno, inspecione falsos positivos e então atualize o prompt com regras de exclusão e sinais preferidos. Por exemplo: “O primeiro lote incluiu consultores; execute novamente com uma regra para excluir agências, consultores independentes e empresas com menos de 20 funcionários.” Isso gera resultados melhores na segunda rodada do que simplesmente pedir ao agente para “tentar de novo.”

Adicione regras locais de fluxo se sua equipe precisar de consistência

Como a skill original contém apenas SKILL.md, equipes com processos recorrentes de pesquisa de leads podem querer adicionar suas próprias instruções de wrapper: campos aprovados, convenções de nomenclatura, regras de deduplicação, notas de compliance, formato de importação para CRM e pontos de revisão. Esses acréscimos tornam o icypeas-automation guide mais robusto para uso em produção sem mudar o requisito central de descobrir primeiro os schemas ativos das ferramentas Rube.