Creator Screening Skill
Automated creator/influencer screening powered by Memories.ai V2 Video Understanding API.
Parameters
| Parameter | Default | Description |
|---|
| INLINECODE0 | 5 | Number of top videos to analyze per creator |
| INLINECODE1 |
30 | First N seconds of each video to analyze |
|
platforms | instagram | Supported: instagram, tiktok, youtube |
|
analysis_mode |
mai |
mai (visual+audio AI analysis) or
transcript (audio-only fallback) |
|
framework | default | Screening framework to apply. See
references/frameworks/ |
|
output_format | discord |
discord,
pdf (Google Doc→PDF), or
json |
|
batch_size | 10 | Max creators per batch run |
Quick Start
CODEBLOCK0
Workflow
Step 1: Parse Input
Accept creator URLs in any format:
- - Profile: INLINECODE14
- Individual reel: INLINECODE15
- YouTube:
https://www.youtube.com/@channel or INLINECODE17
Step 2: Get Profile & Video Metadata
Memories.ai V2: INLINECODE18
CODEBLOCK1
Returns per video ($0.01/video):
- - Owner profile: username, fullname, followers, verified, profilepic
- Video stats: views, play_count, duration, caption, comments, dimensions, audio info
Step 3: Video Understanding (MAI)
Memories.ai V2 MAI: INLINECODE19
This is the core analysis step. MAI provides:
- - Visual scene descriptions: lighting quality, framing, environment, clothing, production value
- Audio transcription: speech-to-text with timestamps
- Content understanding: topic classification, delivery style, structure
CODEBLOCK2
Each video returns visual + audio AI analysis. Use this to evaluate:
- - Section 2.1: Look & Feel (lighting, environment, framing) — from visual scenes
- Section 2.2: Audio Quality (clarity, echo, consistency) — from audio analysis
- Section 3.x: Delivery & Content (structure, fluency, maturity) — from transcript text
- Section 4: Positioning (tone, energy, brand safety) — from combined analysis
Fallback: If MAI is unavailable, use --mode transcript for audio-only analysis:
CODEBLOCK3
Step 4: Apply Framework
Score against the selected screening framework:
CODEBLOCK4
Frameworks live in references/frameworks/:
- -
cac-crusher.md — CAC Crusher Creator Screening Framework (Talking Head + Skit categories) - INLINECODE23 — Generic quality screening (5 dimensions, weighted scoring)
- INLINECODE24 — Template for creating custom frameworks
Step 5: Generate Report
Output per-creator screening cards with:
- - Profile stats (followers, verified, engagement)
- Per-section scores (PASS/FAIL/FLAG)
- Transcript excerpts as evidence
- Visual quality notes from MAI
- Final verdict (APPROVED / REJECTED / CONDITIONAL)
Setup
Set the following environment variables before use:
CODEBLOCK5
Get your API key at https://api-tools.memories.ai
Memories.ai V2 API Reference
All endpoints use: Authorization: <API_KEY> header (no Bearer prefix).
Base URL: https://mavi-backend.memories.ai/serve/api/v2
| Endpoint | Method | Use | Cost |
|---|
| INLINECODE27 | POST | Profile + video stats | $0.01/video |
| INLINECODE28 |
POST | Visual + audio AI analysis | ~$0.11/video |
|
/{platform}/video/transcript | POST | Audio transcription only | ~$0.01/video |
Platforms: instagram, tiktok, youtube, INLINECODE33
Request body: {"video_url": "...", "channel": "rapid"}
MAI response: {"data": {"task_id": "..."}} (async, results via webhook)
URL format: Instagram must use /reel/SHORTCODE/ (not /p/ or /reels/)
Error Handling
- - Add 0.5s delay between API calls
- Retry failed requests once, then skip
- If MAI webhook not received, fall back to transcript mode
- Always normalize Instagram URLs:
/p/ → /reel/, /reels/ → INLINECODE42
创作者筛选技能
由 Memories.ai V2 视频理解API 驱动的自动化创作者/网红筛选。
参数
| 参数 | 默认值 | 描述 |
|---|
| videospercreator | 5 | 每位创作者需分析的精选视频数量 |
| video_seconds |
30 | 每个视频需分析的前N秒 |
| platforms | instagram | 支持平台:instagram、tiktok、youtube |
| analysis_mode | mai | mai(视觉+音频AI分析)或 transcript(仅音频备用方案) |
| framework | default | 应用的筛选框架。参见 references/frameworks/ |
| output_format | discord | discord、pdf(Google文档→PDF)或 json |
| batch_size | 10 | 每批次最大创作者数量 |
快速开始
筛选以下创作者:@anshmehra.in, @nishkarshsharmaa
参数:videospercreator=3, framework=cac-crusher
工作流程
步骤1:解析输入
接受任意格式的创作者链接:
- - 个人主页:https://www.instagram.com/username/
- 单个短视频:https://www.instagram.com/reel/SHORTCODE/
- YouTube:https://www.youtube.com/@channel 或 /shorts/ID
步骤2:获取个人资料与视频元数据
Memories.ai V2:POST /instagram/video/metadata
bash
python3 scripts/scrapeprofiles.py --urls reelurl1,reel_url2 --channel rapid
每个视频返回($0.01/视频):
- - 创作者个人资料:用户名、全名、粉丝数、认证状态、头像
- 视频数据:观看量、播放量、时长、文案、评论数、分辨率、音频信息
步骤3:视频理解(MAI)
Memories.ai V2 MAI:POST /instagram/video/mai/transcript
这是核心分析步骤。MAI提供:
- - 视觉场景描述:光线质量、构图、环境、服装、制作水准
- 音频转录:带时间戳的语音转文字
- 内容理解:主题分类、表达风格、结构分析
bash
python3 scripts/analyzevideos.py --mode mai --videosper_creator 5 --urls url1,url2
每个视频返回视觉+音频AI分析。用于评估:
- - 第2.1节:外观与感受(光线、环境、构图)——来自视觉场景
- 第2.2节:音频质量(清晰度、回声、一致性)——来自音频分析
- 第3.x节:表达与内容(结构、流畅度、成熟度)——来自转录文本
- 第4节:定位(语调、能量、品牌安全性)——来自综合分析
备用方案:如果MAI不可用,使用 --mode transcript 进行仅音频分析:
bash
python3 scripts/analyzevideos.py --mode transcript --videosper_creator 5 --urls url1,url2
步骤4:应用框架
根据选定的筛选框架进行评分:
bash
python3 scripts/score_creator.py --framework cac-crusher --profile profile.json --transcripts transcripts.json
框架文件位于 references/frameworks/:
- - cac-crusher.md — CAC Crusher创作者筛选框架(口播+短剧类别)
- default.md — 通用质量筛选(5个维度,加权评分)
- template.md — 创建自定义框架的模板
步骤5:生成报告
输出每位创作者的筛选卡片,包含:
- - 个人资料数据(粉丝数、认证状态、互动率)
- 各章节评分(通过/未通过/标记)
- 转录文本摘录作为证据
- MAI视觉质量备注
- 最终判定(批准/拒绝/有条件通过)
环境配置
使用前设置以下环境变量:
bash
export MEMORIESAPIKEY=your-memories-ai-v2-api-key # 必需 — Memories.ai V2 API密钥
export APIFYAPIKEY=your-apify-key # 可选 — 个人资料抓取备用方案
在 https://api-tools.memories.ai 获取您的API密钥
Memories.ai V2 API参考
所有接口使用:Authorization: 请求头(无需Bearer前缀)。
基础URL:https://mavi-backend.memories.ai/serve/api/v2
| 接口 | 方法 | 用途 | 费用 |
|---|
| /{platform}/video/metadata | POST | 个人资料+视频数据 | $0.01/视频 |
| /{platform}/video/mai/transcript |
POST | 视觉+音频AI分析 | ~$0.11/视频 |
| /{platform}/video/transcript | POST | 仅音频转录 | ~$0.01/视频 |
支持平台:instagram、tiktok、youtube、twitter
请求体:{video_url: ..., channel: rapid}
MAI响应:{data: {task_id: ...}}(异步,通过webhook获取结果)
链接格式:Instagram必须使用 /reel/SHORTCODE/ 格式(不能使用 /p/ 或 /reels/)
错误处理
- - API调用之间添加0.5秒延迟
- 失败请求重试一次,然后跳过
- 如果未收到MAI webhook,回退至转录模式
- 始终标准化Instagram链接:/p/ → /reel/,/reels/ → /reel/