Ad Library Archivist
npx machina-cli add skill akhilkannur/marketing-agent-blueprints/ad-library-archivist --openclawThe Ad Library Archivist
Core Instructions
You are a highly specialized AI agent focusing on Competitive Intel. Your mission is: Ads disappear. This agent reads a CSV of FB Ad Library or LinkedIn Ad links and creates a structured directory of 'Swipe Assets', naming every file by date, competitor, and marketing angle.
Implementation Workflow
Phase 1: Initialization & Seeding
- Check: Does
ad_links.csvexist? - If Missing: Create
ad_links.csvusing thesampleDataprovided in this blueprint. - If Present: Load the data for processing.
Phase 2: The Loop
Phase 2: The Archival Loop For each row in the CSV:
- Categorize: Determine the year and quarter.
- Naming: Generate a standardized filename:
[YYYY-MM]_[Competitor]_[Angle].png. - Command: Provide the specific
mkdirandcurl(or manual screenshot) instructions to save the asset into/swipe_file/[Year]/[Competitor]/.
Phase 3: The Index
- Create:
swipe_file_index.md. - Summarize: List all saved assets with their associated angles.
- Summary: "Archived [X] ads across [Y] competitors."
Blueprint ID: ad-library-archivist Source: Real AI Examples
Source
git clone https://github.com/akhilkannur/marketing-agent-blueprints/blob/main/skills/ad-library-archivist/SKILL.mdView on GitHub Overview
Ad Library Archivist automatically reads a CSV of FB Ad Library or LinkedIn Ad links and builds a structured directory of Swipe Assets. It names each file by date, competitor, and marketing angle, ensuring ads are preserved before they disappear. The resulting /swipe_file directory and a summary index make competitive intel easy to browse and reuse.
How This Skill Works
It checks for ad_links.csv and creates it from sampleData if missing, otherwise it loads the data. For each row, it determines the year/quarter, builds a filename [YYYY-MM]_[Competitor]_[Angle].png, creates /swipe_file/[Year]/[Competitor]/, and saves the asset via mkdir and curl (or a manual screenshot). It then generates swipe_file_index.md listing all assets and their angles.
When to Use It
- You need to preserve current ads before they disappear from the Ad Library.
- You want a sortable archive by year/quarter for competitive intel reporting.
- You must compare creative angles across multiple competitors.
- You are onboarding new teammates and need a ready-to-browse archive.
- You require a reproducible workflow to audit ad campaigns across quarters.
Quick Start
- Step 1: Ensure ad_links.csv exists in the project root, or allow the system to create it from sampleData.
- Step 2: Run the archival loop to generate /swipe_file/[Year]/[Competitor]/ assets and swipe_file_index.md.
- Step 3: Open swipe_file_index.md to review saved assets by year and competitor.
Best Practices
- Normalize competitor names to avoid duplicate folders (e.g., 'ACME' vs 'Acme').
- Validate ad_links.csv contents (valid URLs and meaningful angles) before running.
- Follow the [YYYY-MM] naming convention exactly to enable automatic sorting.
- Store assets under /swipe_file with Year/Competitor directories for easy browsing.
- Run the archival loop on a schedule (quarterly) to capture new ads.
Example Use Cases
- Archived 120 ads across 8 competitors for 2024 Q1 with angles like 'Brand Awareness' and 'Holiday Offer'.
- Captured 75 ads in 2024 Q3 for three competitors focusing on 'Lead Gen' and 'Product Launch'.
- Built a 2025 Q1 archive with 9 competitors and angles including 'Launch', 'Retargeting', and 'UGC'.
- Completed a mid-cycle audit: 50 ads across 5 competitors with angles like 'Sales Promo' and 'Testimonial'.
- Consolidated LinkedIn ads from 2023 Q4 into /swipe_file with per-competitor folders.
