# Send Meta Video Ad Analyzer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "meta-video-ad-analyzer",
    "name": "Meta Video Ad Analyzer",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/fortytwode/meta-video-ad-analyzer",
    "canonicalUrl": "https://clawhub.ai/fortytwode/meta-video-ad-analyzer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/meta-video-ad-analyzer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=meta-video-ad-analyzer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "prompts/scene_analysis.md",
      "prompts/scene_reconciliation.md",
      "scripts/models.py",
      "scripts/prompt_manager.py",
      "scripts/video_extractor.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/meta-video-ad-analyzer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/meta-video-ad-analyzer",
    "downloadUrl": "https://openagent3.xyz/downloads/meta-video-ad-analyzer",
    "agentUrl": "https://openagent3.xyz/skills/meta-video-ad-analyzer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/meta-video-ad-analyzer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/meta-video-ad-analyzer/agent.md"
  }
}
```
## Documentation

### Video Ad Analyzer

AI-powered video content extraction using Google Gemini Vision.

### What This Skill Does

Frame Extraction: Smart sampling with scene change detection
OCR Text Detection: Extract text overlays using EasyOCR
Audio Transcription: Convert speech to text with Google Cloud Speech
AI Scene Analysis: Describe each scene using Gemini Vision
Native Video Analysis: Direct video understanding for longer content
Thumbnail Generation: Auto-generate thumbnails from first frame

### 1. Environment Variables

# Required for Gemini Vision
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# Required for audio transcription
# (same service account needs Speech-to-Text API enabled)

### 2. Dependencies

pip install opencv-python pillow easyocr ffmpeg-python google-cloud-speech vertexai google-api-python-client

Also requires ffmpeg and ffprobe installed on system.

### Basic Video Analysis

from scripts.video_extractor import VideoExtractor
from scripts.models import ExtractedVideoContent
import vertexai
from vertexai.generative_models import GenerativeModel

# Initialize Vertex AI
vertexai.init(project="your-project-id", location="us-central1")
gemini_model = GenerativeModel("gemini-1.5-flash")

# Create extractor
extractor = VideoExtractor(gemini_model=gemini_model)

# Analyze video
result = extractor.extract_content("/path/to/video.mp4")

print(f"Duration: {result.duration}s")
print(f"Scenes: {len(result.scene_timeline)}")
print(f"Text overlays: {len(result.text_timeline)}")
print(f"Transcript: {result.transcript[:200]}...")

### Extract Only Frames

frames, timestamps, text_timeline, scene_timeline, thumbnail = extractor.extract_smart_frames(
    "/path/to/video.mp4",
    scene_interval=2,    # Check for scene changes every 2s
    text_interval=0.5    # Check for text every 0.5s
)

### Analyze Images

# Works with images too
result = extractor.extract_content("/path/to/image.jpg")
print(result.scene_timeline[0]['description'])

### Output Structure

ExtractedVideoContent(
    video_path="/path/to/video.mp4",
    duration=30.5,
    transcript="Here's what we found...",
    text_timeline=[
        {"at": 0.0, "text": ["Download Now"]},
        {"at": 5.5, "text": ["50% Off Today"]}
    ],
    scene_timeline=[
        {"timestamp": 0.0, "description": "Woman using phone app..."},
        {"timestamp": 2.0, "description": "Product showcase with features..."}
    ],
    thumbnail_url="/static/thumbnails/video_thumb.jpg",
    extraction_complete=True
)

### Key Features

FeatureDescriptionScene DetectionHistogram-based change detection (threshold=65)OCR ConfidenceTiered thresholds (0.5 high, 0.3 low)AI ProofreadingGemini cleans up OCR errorsSource ReconciliationMerges OCR + Vision text intelligentlyNative VideoDirect Gemini analysis for <20MB files

### Prompts

Customize AI behavior by editing prompts in the prompts/ folder:

scene_analysis.md - Frame analysis prompts
scene_reconciliation.md - Scene enrichment prompts

### Common Questions This Answers

"What text appears in this video ad?"
"Describe each scene in this creative"
"What does the narrator say?"
"Extract the call-to-action from this ad"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: fortytwode
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/meta-video-ad-analyzer)
- [Send to Agent page](https://openagent3.xyz/skills/meta-video-ad-analyzer/agent)
- [JSON manifest](https://openagent3.xyz/skills/meta-video-ad-analyzer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/meta-video-ad-analyzer/agent.md)
- [Download page](https://openagent3.xyz/downloads/meta-video-ad-analyzer)