🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Creator Screening

by @shawnshenopeninterx

Screen and evaluate social media creators/influencers using configurable quality frameworks. Analyzes Instagram, TikTok, YouTube creators using Memories.ai V...

Versionv1.1.0
Downloads953
TERMINAL
clawhub install creator-screening

πŸ“– About This Skill


name: creator-screening description: 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. metadata: openclaw: emoji: "🎯"

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: 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/
  • πŸ’‘ Examples

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

    βš™οΈ Configuration

    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