メニュー
Extract and save ad creative assets (images and videos) from Meta Ads Library. Use when downloading competitor ad creatives, building a swipe file, researching ad formats, or saving Meta/Facebook ad images and videos from specific advertisers.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | meta-ads-extractor |
| description | Extract and save ad creative assets (images and videos) from Meta Ads Library. Use when downloading competitor ad creatives, building a swipe file, researching ad formats, or saving Meta/Facebook ad images and videos from specific advertisers. |
Extract actual ad creative images and videos from Meta's Ad Library via browser automation.
curl for downloading assetsThe Ad Library uses a delegate_page ID, NOT the profile ID from meta tags. This is the #1 source of errors.
Navigate to: https://www.facebook.com/<page-username>/
Extract via JS: document.documentElement.innerHTML.match(/"delegate_page":\{[^}]*"id":"(\d+)"/)
Fallback (if no delegate_page): use fb://profile/<id> from al:android:url meta tag
The delegate_page ID is what view_all_page_id parameter expects.
Build URL with these parameters:
https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&is_targeted_country=false&media_type=image_and_meme&search_type=page&view_all_page_id={PAGE_ID}
Key filter values:
active_status: active | inactive | allmedia_type: image_and_meme | video | all (omit for all)country: ALL | US | DE etc.Run the extraction JS from references/dom-selectors.md via browser evaluate. Returns JSON with image and video URLs.
Important: extraction ≠ downloading. The JS extracts ALL URLs from the page (instant, no network cost). Then download only the specific assets requested. When the user asks for "top N ads," the page sort order matches DOM order — so images[0] / videos[0] = highest impressions.
Image selectors: img elements with fbcdn.net src containing s600x600 (ad thumbnails).
Video selectors: video elements with fbcdn.net src (direct .mp4 URLs).
Video posters: video[poster] attributes (full-res thumbnail frames).
Each ad card has a "Learn More" (or similar) button linking to the advertiser's landing page. Extract these for landing page analysis:
// Run via browser evaluate — extracts CTA hrefs from ad cards
(() => {
const ctas = [...document.querySelectorAll('a')]
.filter(a => a.textContent.trim().match(/^(Learn More|Shop Now|Sign Up|Download|Get Offer|Book Now|Apply Now|Contact Us|Subscribe|Watch More|See More)$/i))
.map(a => ({ text: a.textContent.trim(), url: a.href }))
.filter(c => c.url && !c.url.includes('facebook.com/ads/library'));
return JSON.stringify(ctas);
})()
These URLs can be passed to the landing-page-analysis skill for offer/funnel analysis.
All fbcdn.net URLs work with direct curl — no authentication needed. Only download what was requested.
curl -sL -o "output.jpg" "https://scontent-xxx.xx.fbcdn.net/v/..."
curl -sL -o "output.mp4" "https://video-xxx.xx.fbcdn.net/v/..."
After downloading, determine the aspect ratio of each asset:
For images (using sips on macOS or identify from ImageMagick):
# macOS
sips -g pixelWidth -g pixelHeight image.jpg
# Calculate ratio
width=1080; height=1350
# 1080:1350 = 4:5 (vertical feed)
For videos (using ffprobe):
ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 video.mp4
# Output: 1080,1920 → 9:16 (Stories/Reels)
Common Meta ad aspect ratios:
| Ratio | Dimensions | Use Case |
|---|---|---|
| 1:1 | 1080×1080 | Feed (universal) |
| 4:5 | 1080×1350 | Feed (recommended, more space) |
| 9:16 | 1080×1920 | Stories, Reels |
| 16:9 | 1920×1080 | Video, landscape |
| 1.91:1 | 1200×628 | Link ads |
Save metadata to JSON:
{
"filename": "brand-video-01.mp4",
"type": "video",
"width": 1080,
"height": 1920,
"aspect_ratio": "9:16",
"duration_seconds": 31
}
Create {advertiser-slug}-metadata.json alongside the assets with dimensions for each file.
The Ad Library lazy-loads ads. To get more than the initial batch (~20), scroll down and wait, then re-extract. The JS deduplicates automatically.
{advertiser-slug}-{type}-{nn}.{ext}
Examples: hbs-online-image-01.jpg, iman-gadzhi-video-03.mp4
Send downloaded files via message tool with action=send and filePath. Include advertiser name and asset type in caption.
For batches: summary message first, then files one by one. Group images together, then videos.
Telegram limits: 50MB images / 2GB video. Most ad creatives are well under this.
After extraction, use:
See references/dom-selectors.md for detailed CSS selectors, URL patterns, and JS extraction code.
Generate ONE on-brand still-image creative for a single Aries social post at the correct per-platform scale. Use once per content_package post whose media is an image (feed / story-image). FORCES exactly one image_generate call and returns the generated_image creative_asset plus a content_package entry stamped with its placement. Paired with /social-video-creative for video posts.
Generate ONE on-brand short-form vertical video (Reel / Story video) for a single Aries social post at 9:16 reel scale. Use once per requested video clip. FORCES exactly one video_generate call and returns the generated_video creative_asset (localized basename + width/height/duration) plus a content_package entry stamped placement=reel / media_type=video. Paired with /social-image-creative for image posts.
Orchestrate creative asset production for social content. Use after /social-content-planner approval to coordinate /ad_designer, /scriptwriter, and /page_designer. Reviews all work for brand consistency and quality before presenting to user. The "make it happen" skill that turns approved strategy into deliverables.
Orchestrate brand-to-social-content workflow. Runs website brand analysis, then social content planning. Use when starting marketing for a brand from scratch or refreshing strategy. Produces brand bible + full social content plan ready for creative production.
Write video ad scripts with full production notes. Creates scene-by-scene breakdowns including dialogue, B-roll suggestions, on-screen text, camera direction, and timing. Outputs individual script files plus combined overview for approval.
Create a Meta Ads social content proposal based on brand guidelines and competitor analysis. Generates funnel strategy, landing pages, ad creatives, video scripts, and budget allocation. Outputs both markdown and HTML for review before asset creation.