Creativault Creator Scraper CV Overview
Creativault Creator Scraper CV is an end-to-end creator intelligence skill for AI agents.
It helps agents discover creators, collect creator data, find lookalike creators, export creator lists, and run outreach workflows across TikTok, YouTube, Instagram, and Twitter/X.
This skill is useful for influencer marketing teams, growth teams, creator partnership teams, DTC brands, Shopify sellers, TikTok Shop sellers, SaaS marketers, agencies, and KOL outreach operators.
Core Capabilities
- Search creators by platform, country, niche, keyword, followers, views, engagement, audience, and contact availability
- Find similar or lookalike creators from a seed profile
- Collect creator data in bulk from links, usernames, files, or keywords
- Track async collection tasks
- Export creator data as xlsx, csv, or html
- Send creator outreach emails
- Manage batch outreach, follow-ups, and outreach metrics
- Orchestrate full influencer workflows from discovery to outreach
Supported Platforms
| Platform | Supported Capabilities |
|---|---|
| TikTok | Search, lookalike, batch collection, keyword collection, outreach when contact data is available |
| YouTube | Search, lookalike, batch collection, keyword collection, outreach when contact data is available |
| Search, lookalike, batch collection, export, outreach when contact data is available | |
| Twitter/X | Link, username, or file-based collection where supported |
Sub Skills
| Sub Skill | Use For | Path |
|---|---|---|
| creator-search | Search creators with filters | discovery/creator-search/SKILL.md |
| creator-lookalike | Find similar creators from a seed profile | discovery/creator-lookalike/SKILL.md |
| creator-collection | Batch collect creator data and export results | collection/creator-collection/SKILL.md |
| creator-outreach | Send outreach emails and manage follow-ups | outreach/creator-outreach/SKILL.md |
| workflow | Run full influencer campaign workflows | workflow/SKILL.md |
Routing Rules
Use creator-search when the user wants to find creators, influencers, KOLs, or social accounts by filters.
Use creator-lookalike when the user provides a creator username or profile URL and asks for similar creators.
Use creator-collection when the user wants to collect creator data from links, usernames, files, or keywords, then export the results.
Use creator-outreach when the user wants to send emails, run batch outreach, manage replies, or track follow-ups.
Use workflow when the user wants a complete campaign, such as finding creators, collecting data, exporting the list, and preparing outreach.
Installation
npx skills add https://github.com/creativault/skills/tree/main/creator-scraper-cv
Requirements
Set the required environment variables before use.
export CV_API_KEY=cv_live_your_key_here
export CV_USER_IDENTITY=your_email@example.com
Optional:
export CV_API_BASE_URL=http://api.creativault.vip
| Variable | Required | Description |
|---|---|---|
| CV_API_KEY | Yes | Creativault Open API Key |
| CV_USER_IDENTITY | Yes | Operator email address |
| CV_API_BASE_URL | No | API base URL |
Service Levels
| Level | Best For | Data Depth | Credits |
|---|---|---|---|
| S1 | Basic creator list building | Basic profile and follower data | 1 credit per creator |
| S2 | Outreach-ready research | S1 plus richer profile, contact, performance, and engagement fields where available | 3 credits per creator |
| S3 | Deep audience analysis | S2 plus audience country, language, gender, and age fields where available | 4 credits per creator |
Recommended defaults:
- Use S1 for quick list building
- Use S2 for outreach workflows
- Use S3 for paid campaigns where audience fit matters
Parameter Rules
Normalize platforms to:
tiktok
youtube
instagram
twitter
Use country and language codes:
{"country_code": "US"}
{"language_code": "en"}
Use percentage values from 0 to 100:
{"last10_avg_video_interaction_rate_gte": 3}
Use JSON booleans:
{"has_email": true}
Do not treat quota_remaining as credit balance. Only show an insufficient-credit warning when the API returns error code 40201.
Example Workflows
Creator Search
Find 50 TikTok beauty creators in the US with 10K to 100K followers, email available, and engagement above 3%.
Lookalike Discovery
Find 20 creators similar to this TikTok profile.
Batch Collection
Collect detailed data for these 100 Instagram creator links and export the result as xlsx.
Outreach
Send a short partnership email to all creators in this list who have available email addresses.
Full Campaign
Find 100 TikTok Shop creators in the beauty category, collect their data, export the list, and prepare an outreach campaign.
Output Guidelines
When showing creator results, use a clean table and only include fields returned by the API.
Recommended summary:
Summary:
- Platform: TikTok
- Service level: S2
- Displayed creators: 10
- Credits consumed: 30
- Remaining daily quota: 92
- Request ID: xxxxxxxx
Default export format: xlsx.
Use csv for lightweight data processing and html for shareable reports.
References
discovery/creator-search/SKILL.mddiscovery/creator-lookalike/SKILL.mdcollection/creator-collection/SKILL.mdoutreach/creator-outreach/SKILL.mdworkflow/SKILL.mdreferences/api-reference.md