Обзор Creativault Creator Scraper CV
Creativault Creator Scraper CV — это комплексный навык сбора информации о создателях для ИИ-агентов.
Он помогает агентам находить создателей, собирать данные о создателях, находить похожих создателей, экспортировать списки создателей и выполнять рабочие процессы по рассылке в TikTok, YouTube, Instagram и Twitter/X.
Этот навык полезен для команд по маркетингу влияния, команд роста, команд по партнерству с создателями, DTC-брендов, продавцов Shopify, продавцов TikTok Shop, SaaS-маркетологов, агентств и операторов по рассылке KOL.
Основные возможности
- Поиск создателей по платформе, стране, нише, ключевому слову, подписчикам, просмотрам, вовлеченности, аудитории и доступности контактов
- Поиск похожих или аналогичных создателей на основе исходного профиля
- Массовый сбор данных о создателях по ссылкам, именам пользователей, файлам или ключевым словам
- Отслеживание асинхронных задач по сбору данных
- Экспорт данных о создателях в формате xlsx, csv или html
- Отправка писем для рассылки создателям
- Управление массовой рассылкой, последующими письмами и метриками рассылки
- Организация полных рабочих процессов по работе с влиятельными лицами: от поиска до рассылки
Поддерживаемые платформы
| Платформа | Поддерживаемые возможности |
|---|---|
| TikTok | Поиск, поиск похожих, массовый сбор, сбор по ключевым словам, рассылка при наличии контактных данных |
| YouTube | Поиск, поиск похожих, массовый сбор, сбор по ключевым словам, рассылка при наличии контактных данных |
| Поиск, поиск похожих, массовый сбор, экспорт, рассылка при наличии контактных данных | |
| Twitter/X | Сбор по ссылкам, именам пользователей или файлам, где поддерживается |
Дополнительные навыки
| Дополнительный навык | Назначение | Путь |
|---|---|---|
| creator-search | Поиск создателей с фильтрами | discovery/creator-search/SKILL.md |
| creator-lookalike | Поиск похожих создателей по исходному профилю | discovery/creator-lookalike/SKILL.md |
| creator-collection | Массовый сбор данных о создателях и экспорт результатов | collection/creator-collection/SKILL.md |
| creator-outreach | Отправка писем для рассылки и управление последующими действиями | outreach/creator-outreach/SKILL.md |
| workflow | Запуск полных рабочих процессов кампаний с влиятельными лицами | workflow/SKILL.md |
Правила маршрутизации
Используйте creator-search, когда пользователь хочет найти создателей, влиятельных лиц, KOL или социальные аккаунты по фильтрам.
Используйте creator-lookalike, когда пользователь предоставляет имя пользователя или URL профиля создателя и запрашивает похожих создателей.
Используйте 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 | Да | Открытый API-ключ Creativault |
| CV_USER_IDENTITY | Да | Адрес электронной почты оператора |
| CV_API_BASE_URL | Нет | Базовый URL API |
Уровни обслуживания
| Уровень | Лучше всего подходит для | Глубина данных | Кредиты |
|---|---|---|---|
| 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.
Примеры рабочих процессов
Поиск создателей
Найдите 50 TikTok-создателей в категории красоты из США с 10К–100К подписчиков, доступной электронной почтой и вовлеченностью выше 3%.
Поиск похожих
Найдите 20 создателей, похожих на этот профиль в TikTok.
Массовый сбор
Соберите подробные данные для этих 100 ссылок на создателей в Instagram и экспортируйте результат в формате xlsx.
Рассылка
Отправьте короткое письмо о партнерстве всем создателям из этого списка, у которых есть доступные адреса электронной почты.
Полная кампания
Найдите 100 создателей TikTok Shop в категории красоты, соберите их данные, экспортируйте список и подготовьте кампанию по рассылке.
Рекомендации по выводу
При отображении результатов по создателям используйте аккуратную таблицу и включайте только поля, возвращаемые API.
Рекомендуемая сводка:
Сводка:
- Платформа: TikTok
- Уровень обслуживания: S2
- Отображено создателей: 10
- Потрачено кредитов: 30
- Оставшаяся дневная квота: 92
- 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