Visão Geral do Creativault Creator Scraper CV
Creativault Creator Scraper CV é uma habilidade de inteligência de criadores ponta a ponta para agentes de IA.
Ajuda os agentes a descobrir criadores, coletar dados de criadores, encontrar criadores semelhantes, exportar listas de criadores e executar fluxos de trabalho de outreach no TikTok, YouTube, Instagram e Twitter/X.
Esta habilidade é útil para equipes de marketing de influenciadores, equipes de crescimento, equipes de parcerias com criadores, marcas DTC, vendedores da Shopify, vendedores do TikTok Shop, profissionais de marketing SaaS, agências e operadores de outreach para KOLs.
Capacidades Principais
- Pesquisar criadores por plataforma, país, nicho, palavra-chave, seguidores, visualizações, engajamento, público e disponibilidade de contato
- Encontrar criadores semelhantes ou parecidos a partir de um perfil semente
- Coletar dados de criadores em massa a partir de links, nomes de usuário, arquivos ou palavras-chave
- Acompanhar tarefas assíncronas de coleta
- Exportar dados de criadores como xlsx, csv ou html
- Enviar e-mails de outreach para criadores
- Gerenciar outreach em lote, follow-ups e métricas de outreach
- Orquestrar fluxos de trabalho completos de influenciadores, desde a descoberta até o outreach
Plataformas Suportadas
| Plataforma | Capacidades Suportadas |
|---|---|
| TikTok | Pesquisa, semelhantes, coleta em lote, coleta por palavra-chave, outreach quando dados de contato estiverem disponíveis |
| YouTube | Pesquisa, semelhantes, coleta em lote, coleta por palavra-chave, outreach quando dados de contato estiverem disponíveis |
| Pesquisa, semelhantes, coleta em lote, exportação, outreach quando dados de contato estiverem disponíveis | |
| Twitter/X | Coleta baseada em link, nome de usuário ou arquivo, onde suportado |
Sub-habilidades
| Sub-habilidade | Usar Para | Caminho |
|---|---|---|
| creator-search | Pesquisar criadores com filtros | discovery/creator-search/SKILL.md |
| creator-lookalike | Encontrar criadores semelhantes a partir de um perfil semente | discovery/creator-lookalike/SKILL.md |
| creator-collection | Coletar dados de criadores em lote e exportar resultados | collection/creator-collection/SKILL.md |
| creator-outreach | Enviar e-mails de outreach e gerenciar follow-ups | outreach/creator-outreach/SKILL.md |
| workflow | Executar fluxos de trabalho completos de campanhas de influenciadores | workflow/SKILL.md |
Regras de Roteamento
Use creator-search quando o usuário desejar encontrar criadores, influenciadores, KOLs ou contas sociais por meio de filtros.
Use creator-lookalike quando o usuário fornecer um nome de usuário ou URL de perfil de criador e solicitar criadores semelhantes.
Use creator-collection quando o usuário desejar coletar dados de criadores a partir de links, nomes de usuário, arquivos ou palavras-chave e, em seguida, exportar os resultados.
Use creator-outreach quando o usuário desejar enviar e-mails, realizar outreach em lote, gerenciar respostas ou acompanhar follow-ups.
Use workflow quando o usuário desejar uma campanha completa, como encontrar criadores, coletar dados, exportar a lista e preparar o outreach.
Instalação
npx skills add https://github.com/creativault/skills/tree/main/creator-scraper-cv
Requisitos
Defina as variáveis de ambiente necessárias antes de usar.
export CV_API_KEY=cv_live_sua_chave_aqui
export CV_USER_IDENTITY=seu_email@exemplo.com
Opcional:
export CV_API_BASE_URL=http://api.creativault.vip
| Variável | Obrigatória | Descrição |
|---|---|---|
| CV_API_KEY | Sim | Chave da API Aberta do Creativault |
| CV_USER_IDENTITY | Sim | Endereço de e-mail do operador |
| CV_API_BASE_URL | Não | URL base da API |
Níveis de Serviço
| Nível | Ideal Para | Profundidade dos Dados | Créditos |
|---|---|---|---|
| S1 | Criação básica de listas de criadores | Dados básicos de perfil e seguidores | 1 crédito por criador |
| S2 | Pesquisa pronta para outreach | S1 mais campos de perfil mais ricos, contato, desempenho e engajamento, onde disponíveis | 3 créditos por criador |
| S3 | Análise aprofundada de audiência | S2 mais campos de país, idioma, gênero e idade da audiência, onde disponíveis | 4 créditos por criador |
Padrões recomendados:
- Use S1 para criação rápida de listas
- Use S2 para fluxos de trabalho de outreach
- Use S3 para campanhas pagas onde a adequação da audiência é importante
Regras de Parâmetros
Normalize as plataformas para:
tiktok
youtube
instagram
twitter
Use códigos de país e idioma:
{"country_code": "US"}
{"language_code": "en"}
Use valores percentuais de 0 a 100:
{"last10_avg_video_interaction_rate_gte": 3}
Use booleanos JSON:
{"has_email": true}
Não trate quota_remaining como saldo de créditos. Mostre um aviso de créditos insuficientes apenas quando a API retornar o código de erro 40201.
Exemplos de Fluxos de Trabalho
Pesquisa de Criadores
Encontre 50 criadores de beleza no TikTok nos EUA com 10 mil a 100 mil seguidores, e-mail disponível e engajamento acima de 3%.
Descoberta de Semelhantes
Encontre 20 criadores semelhantes a este perfil do TikTok.
Coleta em Lote
Colete dados detalhados para estes 100 links de criadores do Instagram e exporte o resultado como xlsx.
Outreach
Envie um e-mail de parceria curto para todos os criadores desta lista que tenham endereços de e-mail disponíveis.
Campanha Completa
Encontre 100 criadores do TikTok Shop na categoria de beleza, colete seus dados, exporte a lista e prepare uma campanha de outreach.
Diretrizes de Saída
Ao mostrar resultados de criadores, use uma tabela limpa e inclua apenas os campos retornados pela API.
Resumo recomendado:
Resumo:
- Plataforma: TikTok
- Nível de serviço: S2
- Criadores exibidos: 10
- Créditos consumidos: 30
- Cota diária restante: 92
- ID da solicitação: xxxxxxxx
Formato de exportação padrão: xlsx.
Use csv para processamento leve de dados e html para relatórios compartilháveis.
Referências
discovery/creator-search/SKILL.mddiscovery/creator-lookalike/SKILL.mdcollection/creator-collection/SKILL.mdoutreach/creator-outreach/SKILL.mdworkflow/SKILL.mdreferences/api-reference.md