| name | apify-swipe-file-ads |
| description | Use when you want to build a swipe file (inspiration bank) of the ad creatives running in a niche - copy, hooks, visuals, CTAs - to draw from when you write your own. Meta Ad Library niche search URL -> markdown gallery of ads. |
Constituer une swipe file d'ads d'une niche
Objectif & quand
One-shot : tu veux te constituer une banque d'inspiration des créas qui tournent dans une niche - le texte, l'accroche, le type de visuel, le CTA - pour ne plus jamais partir de la page blanche quand tu écris une pub. Cet Actor lit la Meta Ad Library sur un mot-clé de niche et te sort une galerie markdown : une fiche par pub, prête à parcourir et à piocher dedans.
Prérequis
- Compte Apify +
APIFY_TOKEN (gratuit pour démarrer).
- MCP Apify configuré (
CONNECTING-MCP.md).
Actor utilisé
curious_coder/facebook-ads-library-scraper (https://apify.com/curious_coder/facebook-ads-library-scraper) - extrait les pubs de la Meta Ad Library à partir d'une URL de recherche ou d'une page.
Config (config.example.yaml)
| Champ | Rôle |
|---|
urls | URL(s) Meta Ad Library de recherche par niche (mot-clé thématique) |
scrapeAdDetails | inclure le détail de chaque pub (texte complet, liens médias, CTA) |
count | nombre max de pubs à récupérer (borne le coût) |
Procédure (via MCP)
- Construire l'URL de recherche de niche : sur https://www.facebook.com/ads/library, chercher un mot-clé thématique (ex. "meal prep", "app de méditation"), filtrer pays + "All ads", copier l'URL.
- Demander au MCP Apify de lancer l'Actor
curious_coder/facebook-ads-library-scraper avec l'input de config.example.yaml (tool call-actor).
- Récupérer les items du dataset (
get-dataset-items).
- Mettre en forme en galerie markdown : une section par pub (marque, texte, type de média, lien média, CTA, lien snapshot).
Si le MCP ne fait pas l'action
Fallback via lib/apify_helpers.py :
from lib import apify_helpers as a
ads = a.run_actor("curious_coder/facebook-ads-library-scraper", {
"urls": ["https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=FR&q=app%20meditation"],
"scrapeAdDetails": True,
"count": 40,
})
Ou lancer l'Actor depuis la console Apify (bouton Start) avec le même input.
Livrable
Galerie markdown : une section par pub avec marque, texte de la pub, type de média, lien du média, CTA, lien snapshot (la snapshot Ad Library pour revoir le rendu original).
Coût & limites
~$0.75 / 1000 pubs. Données publiques (Ad Library). Le champ count borne la dépense. Une swipe file est un point de départ créatif, pas un modèle à copier tel quel.
Exemple
examples/swipe-file-ads.md (données fictives, schéma réel).
