크리에이티볼트 크리에이터 스크래퍼 CV 개요
크리에이티볼트 크리에이터 스크래퍼 CV는 AI 에이전트를 위한 엔드투엔드 크리에이터 인텔리전스 스킬입니다.
이 스킬은 에이전트가 크리에이터를 발견하고, 크리에이터 데이터를 수집하며, 유사 크리에이터를 찾고, 크리에이터 목록을 내보내며, 틱톡, 유튜브, 인스타그램, 트위터/X에서 아웃리치 워크플로를 실행하는 데 도움을 줍니다.
이 스킬은 인플루언서 마케팅 팀, 성장 팀, 크리에이터 파트너십 팀, DTC 브랜드, Shopify 판매자, 틱톡 샵 판매자, SaaS 마케터, 에이전시, KOL 아웃리치 운영자에게 유용합니다.
핵심 기능
- 플랫폼, 국가, 틈새, 키워드, 팔로워, 조회수, 참여도, 오디언스, 연락처 가용성별로 크리에이터 검색
- 시드 프로필로부터 유사하거나 비슷한 크리에이터 찾기
- 링크, 사용자 이름, 파일 또는 키워드로부터 대량의 크리에이터 데이터 수집
- 비동기 수집 작업 추적
- 크리에이터 데이터를 xlsx, csv, html로 내보내기
- 크리에이터 아웃리치 이메일 발송
- 일괄 아웃리치, 후속 조치 및 아웃리치 지표 관리
- 발견에서 아웃리치까지 전체 인플루언서 워크플로 조정
지원 플랫폼
| 플랫폼 | 지원 기능 |
|---|---|
| 틱톡 | 검색, 유사 크리에이터 찾기, 일괄 수집, 키워드 수집, 연락처 데이터가 있는 경우 아웃리치 |
| 유튜브 | 검색, 유사 크리에이터 찾기, 일괄 수집, 키워드 수집, 연락처 데이터가 있는 경우 아웃리치 |
| 인스타그램 | 검색, 유사 크리에이터 찾기, 일괄 수집, 내보내기, 연락처 데이터가 있는 경우 아웃리치 |
| 트위터/X | 지원되는 경우 링크, 사용자 이름 또는 파일 기반 수집 |
서브 스킬
| 서브 스킬 | 용도 | 경로 |
|---|---|---|
| 크리에이터 검색 | 필터로 크리에이터 검색 | discovery/creator-search/SKILL.md |
| 유사 크리에이터 | 시드 프로필에서 유사 크리에이터 찾기 | discovery/creator-lookalike/SKILL.md |
| 크리에이터 수집 | 크리에이터 데이터 일괄 수집 및 결과 내보내기 | collection/creator-collection/SKILL.md |
| 크리에이터 아웃리치 | 아웃리치 이메일 발송 및 후속 조치 관리 | outreach/creator-outreach/SKILL.md |
| 워크플로 | 전체 인플루언서 캠페인 워크플로 실행 | workflow/SKILL.md |
라우팅 규칙
사용자가 필터로 크리에이터, 인플루언서, KOL 또는 소셜 계정을 찾고자 할 때 creator-search를 사용하세요.
사용자가 크리에이터 사용자 이름이나 프로필 URL을 제공하고 유사 크리에이터를 요청할 때 creator-lookalike를 사용하세요.
사용자가 링크, 사용자 이름, 파일, 키워드로부터 크리에이터 데이터를 수집한 후 결과를 내보내고자 할 때 creator-collection을 사용하세요.
사용자가 이메일을 보내거나, 일괄 아웃리치를 실행하거나, 답장을 관리하거나, 후속 조치를 추적하고자 할 때 creator-outreach를 사용하세요.
사용자가 크리에이터 찾기, 데이터 수집, 목록 내보내기, 아웃리치 준비와 같은 완전한 캠페인을 원할 때 workflow를 사용하세요.
설치
npx skills add https://github.com/creativault/skills/tree/main/creator-scraper-cv
요구 사항
사용 전 필요한 환경 변수를 설정하세요.
export CV_API_KEY=cv_live_your_key_here
export CV_USER_IDENTITY=your_email@example.com
선택 사항:
export CV_API_BASE_URL=http://api.creativault.vip
| 변수 | 필수 | 설명 |
|---|---|---|
| CV_API_KEY | 예 | 크리에이티볼트 Open API 키 |
| CV_USER_IDENTITY | 예 | 운영자 이메일 주소 |
| CV_API_BASE_URL | 아니요 | API 기본 URL |
서비스 레벨
| 레벨 | 적합한 용도 | 데이터 깊이 | 크레딧 |
|---|---|---|---|
| S1 | 기본 크리에이터 목록 구축 | 기본 프로필 및 팔로워 데이터 | 크리에이터당 1 크레딧 |
| S2 | 아웃리치 준비 연구 | S1과 더불어 가능한 경우 더 풍부한 프로필, 연락처, 성과, 참여도 필드 | 크리에이터당 3 크레딧 |
| S3 | 심층 오디언스 분석 | S2와 더불어 가능한 경우 오디언스 국가, 언어, 성별, 연령 필드 | 크리에이터당 4 크레딧 |
권장 기본값:
- 빠른 목록 구축에는 S1 사용
- 아웃리치 워크플로에는 S2 사용
- 오디언스 적합성이 중요한 유료 캠페인에는 S3 사용
매개변수 규칙
플랫폼 정규화:
tiktok
youtube
instagram
twitter
국가 및 언어 코드 사용:
{"country_code": "US"}
{"language_code": "en"}
0에서 100까지의 백분율 값 사용:
{"last10_avg_video_interaction_rate_gte": 3}
JSON 부울 사용:
{"has_email": true}
quota_remaining을 크레딧 잔액으로 취급하지 마세요. API가 오류 코드 40201을 반환할 때만 크레딧 부족 경고를 표시하세요.
예시 워크플로
크리에이터 검색
Find 50 TikTok beauty creators in the US with 10K to 100K followers, email available, and engagement above 3%.
유사 크리에이터 발견
Find 20 creators similar to this TikTok profile.
일괄 수집
Collect detailed data for these 100 Instagram creator links and export the result as xlsx.
아웃리치
Send a short partnership email to all creators in this list who have available email addresses.
전체 캠페인
Find 100 TikTok Shop creators in the beauty category, collect their data, export the list, and prepare an outreach campaign.
출력 가이드라인
크리에이터 결과를 표시할 때는 깔끔한 표를 사용하고 API에서 반환된 필드만 포함하세요.
권장 요약:
Summary:
- Platform: TikTok
- Service level: S2
- Displayed creators: 10
- Credits consumed: 30
- Remaining daily quota: 92
- Request ID: xxxxxxxx
기본 내보내기 형식: xlsx.
가벼운 데이터 처리에는 csv를, 공유 가능한 보고서에는 html을 사용하세요.
참조
discovery/creator-search/SKILL.mddiscovery/creator-lookalike/SKILL.mdcollection/creator-collection/SKILL.mdoutreach/creator-outreach/SKILL.mdworkflow/SKILL.mdreferences/api-reference.md