Creator Screening

Screen and evaluate social media creators/influencers using configurable quality frameworks. Analyzes Instagram, TikTok, YouTube creators using Memories.ai V2 Video Understanding API — fetches profile metadata, runs MAI visual+audio AI analysis on videos, and scores against production quality, audio, delivery, and positioning criteria. Use when asked to vet creators, screen influencers, evaluate content quality, or generate creator reports.

Creator Screening Skill

Automated creator/influencer screening powered by Memories.ai V2 Video Understanding API.

Parameters

Parameter	Default	Description
videos_per_creator	5	Number of top videos to analyze per creator
video_seconds	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

Screen these creators: @anshmehra.in, @nishkarshsharmaa
Parameters: videos_per_creator=3, framework=cac-crusher

Workflow

Step 1: Parse Input

Accept creator URLs in any format:

• Profile: https://www.instagram.com/username/
• Individual reel: https://www.instagram.com/reel/SHORTCODE/
• YouTube: https://www.youtube.com/@channel or /shorts/ID

Step 2: Get Profile & Video Metadata

Memories.ai V2: POST /instagram/video/metadata

python3 scripts/scrape_profiles.py --urls "reel_url1,reel_url2" --channel rapid

Returns per video ($0.01/video):

• Owner profile: username, full_name, followers, verified, profile_pic
• Video stats: views, play_count, duration, caption, comments, dimensions, audio info

Step 3: Video Understanding (MAI)

Memories.ai V2 MAI: POST /instagram/video/mai/transcript

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

python3 scripts/analyze_videos.py --mode mai --videos_per_creator 5 --urls "url1,url2"

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:

python3 scripts/analyze_videos.py --mode transcript --videos_per_creator 5 --urls "url1,url2"

Step 4: Apply Framework

Score against the selected screening framework:

python3 scripts/score_creator.py --framework cac-crusher --profile profile.json --transcripts transcripts.json

Frameworks live in references/frameworks/:

• cac-crusher.md — CAC Crusher Creator Screening Framework (Talking Head + Skit categories)
• default.md — Generic quality screening (5 dimensions, weighted scoring)
• template.md — 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:

export MEMORIES_API_KEY="your-memories-ai-v2-api-key"   # Required — Memories.ai V2 API key
export APIFY_API_KEY="your-apify-key"                    # Optional — fallback scraper for profiles

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
/{platform}/video/metadata	POST	Profile + video stats	$0.01/video
/{platform}/video/mai/transcript	POST	Visual + audio AI analysis	~$0.11/video
/{platform}/video/transcript	POST	Audio transcription only	~$0.01/video

Platforms: instagram, tiktok, youtube, twitter

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/ → /reel/