Panoramica di Creativault Creator Scraper CV
Creativault Creator Scraper CV è una skill completa di intelligence sui creator per agenti AI.
Aiuta gli agenti a scoprire creator, raccogliere dati sui creator, trovare creator simili, esportare liste di creator e gestire flussi di lavoro di outreach su TikTok, YouTube, Instagram e Twitter/X.
Questa skill è utile per team di influencer marketing, team di crescita, team di partnership con creator, marchi DTC, venditori Shopify, venditori TikTok Shop, marketer SaaS, agenzie e operatori di outreach KOL.
Capacità Principali
- Cercare creator per piattaforma, paese, nicchia, parola chiave, follower, visualizzazioni, engagement, pubblico e disponibilità di contatti
- Trovare creator simili o lookalike a partire da un profilo di riferimento
- Raccogliere dati sui creator in massa da link, nomi utente, file o parole chiave
- Monitorare le attività di raccolta asincrona
- Esportare i dati dei creator in formato xlsx, csv o html
- Inviare email di outreach ai creator
- Gestire outreach in batch, follow-up e metriche di outreach
- Orchestrare flussi di lavoro completi di influencer dalla scoperta all'outreach
Piattaforme Supportate
| Piattaforma | Capacità Supportate |
|---|---|
| TikTok | Ricerca, lookalike, raccolta in batch, raccolta per parole chiave, outreach quando i dati di contatto sono disponibili |
| YouTube | Ricerca, lookalike, raccolta in batch, raccolta per parole chiave, outreach quando i dati di contatto sono disponibili |
| Ricerca, lookalike, raccolta in batch, esportazione, outreach quando i dati di contatto sono disponibili | |
| Twitter/X | Raccolta basata su link, nome utente o file dove supportato |
Sotto-Skill
| Sotto-Skill | Utilizzo | Percorso |
|---|---|---|
| creator-search | Cerca creator con filtri | discovery/creator-search/SKILL.md |
| creator-lookalike | Trova creator simili da un profilo di riferimento | discovery/creator-lookalike/SKILL.md |
| creator-collection | Raccoglie in batch dati sui creator ed esporta i risultati | collection/creator-collection/SKILL.md |
| creator-outreach | Invia email di outreach e gestisce i follow-up | outreach/creator-outreach/SKILL.md |
| workflow | Esegue flussi di lavoro completi per campagne influencer | workflow/SKILL.md |
Regole di Instradamento
Usa creator-search quando l'utente vuole trovare creator, influencer, KOL o account social tramite filtri.
Usa creator-lookalike quando l'utente fornisce un nome utente o URL del profilo di un creator e chiede creator simili.
Usa creator-collection quando l'utente vuole raccogliere dati sui creator da link, nomi utente, file o parole chiave, e poi esportare i risultati.
Usa creator-outreach quando l'utente vuole inviare email, eseguire outreach in batch, gestire le risposte o monitorare i follow-up.
Usa workflow quando l'utente desidera una campagna completa, come trovare creator, raccogliere dati, esportare la lista e preparare l'outreach.
Installazione
npx skills add https://github.com/creativault/skills/tree/main/creator-scraper-cv
Requisiti
Imposta le variabili d'ambiente necessarie prima dell'uso.
export CV_API_KEY=cv_live_your_key_here
export CV_USER_IDENTITY=your_email@example.com
Opzionale:
export CV_API_BASE_URL=http://api.creativault.vip
| Variabile | Obbligatoria | Descrizione |
|---|---|---|
| CV_API_KEY | Sì | Chiave API Open di Creativault |
| CV_USER_IDENTITY | Sì | Indirizzo email dell'operatore |
| CV_API_BASE_URL | No | URL base dell'API |
Livelli di Servizio
| Livello | Ideale per | Profondità Dati | Crediti |
|---|---|---|---|
| S1 | Creazione di liste di creator di base | Dati di profilo e follower di base | 1 credito per creator |
| S2 | Ricerca pronta per outreach | S1 più campi arricchiti di profilo, contatto, performance e engagement dove disponibili | 3 crediti per creator |
| S3 | Analisi approfondita del pubblico | S2 più campi su paese, lingua, sesso ed età del pubblico dove disponibili | 4 crediti per creator |
Impostazioni predefinite consigliate:
- Usa S1 per la creazione rapida di liste
- Usa S2 per flussi di lavoro di outreach
- Usa S3 per campagne a pagamento dove l'idoneità del pubblico è importante
Regole per i Parametri
Normalizza le piattaforme in:
tiktok
youtube
instagram
twitter
Usa codici paese e lingua:
{"country_code": "US"}
{"language_code": "en"}
Usa valori percentuali da 0 a 100:
{"last10_avg_video_interaction_rate_gte": 3}
Usa booleani JSON:
{"has_email": true}
Non considerare quota_remaining come saldo crediti. Mostra un avviso di crediti insufficienti solo quando l'API restituisce il codice di errore 40201.
Flussi di Lavoro Esempio
Ricerca Creator
Trova 50 creator di bellezza su TikTok negli Stati Uniti con 10K-100K follower, email disponibile e engagement superiore al 3%.
Scoperta Lookalike
Trova 20 creator simili a questo profilo TikTok.
Raccolta in Batch
Raccogli dati dettagliati per questi 100 link di creator Instagram ed esporta il risultato in formato xlsx.
Outreach
Invia un'email breve di partnership a tutti i creator in questa lista che hanno indirizzi email disponibili.
Campagna Completa
Trova 100 creator TikTok Shop nella categoria bellezza, raccogli i loro dati, esporta la lista e prepara una campagna di outreach.
Linee Guida per l'Output
Quando mostri i risultati dei creator, utilizza una tabella pulita e includi solo i campi restituiti dall'API.
Riepilogo consigliato:
Riepilogo:
- Piattaforma: TikTok
- Livello di servizio: S2
- Creator mostrati: 10
- Crediti consumati: 30
- Quota giornaliera rimanente: 92
- ID richiesta: xxxxxxxx
Formato di esportazione predefinito: xlsx.
Usa csv per elaborazioni dati leggere e html per report condivisibili.
Riferimenti
discovery/creator-search/SKILL.mddiscovery/creator-lookalike/SKILL.mdcollection/creator-collection/SKILL.mdoutreach/creator-outreach/SKILL.mdworkflow/SKILL.mdreferences/api-reference.md