Meta Ad Scraper

Extrait les publicités des concurrents de la Meta Ad Library via un acteur Apify ; nécessite un jeton Apify payant.

par gooseworks-ai · gooseworks-ai/goose-skills

Fonctionne avec configuration ★ 5.6/10

Meta Ad Scraper — Extrait les publicités des concurrents de la Meta Ad Library via un acteur Apify ; nécessite un jeton Apify payant.

Ce que fait

Enveloppe l'acteur Apify `apify/facebook-ads-scraper` dans un CLI Python qui construit une Meta Ad Library search URL à partir d'un nom d'entreprise, d'un mot-clé ou d'une URL de page Facebook, exécute l'acteur, l'interroge et imprime les publicités résultantes en JSON ou sous forme de tableau. Se déclenche lorsque vous demandez quelles publicités un concurrent diffuse actuellement sur Facebook ou Instagram, ou demandez de scraper la Meta Ad Library pour une marque ou un mot-clé. Nécessite un compte Apify et APIFY_API_TOKEN (ou une clé Gooseworks) ; le scraping lui-même est facturé par publicité sur Apify.

Rapport de test

Cloné le dépôt dans un HOME temporaire=$(mktemp -d) et confirmé que la copie place SKILL.md dans ~/.claude/skills/meta-ad-scraper/SKILL.md ; le frontmatter contient name+description, et le tableau de référence CLI dans le corps correspond exactement à argparse (flags et valeurs par défaut : --country ALL, --ad-status active, --max-ads 50, --output json, --timeout 300). Parmi les fichiers référencés dans le corps, scripts/search_meta_ads.py retourne HTTP 200 mais references/apify-config.md retourne HTTP 404 (le répertoire n'existe pas dans l'arborescence), et les commandes d'exemple utilisent le chemin skills/meta-ad-scraper/scripts/... qui ne correspond ni à la disposition du dépôt ni à la disposition installée. J'ai importé le module et exécuté build_ad_library_url directement : --company "Notion" --country US a produit https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=Notion&search_type=keyword_unordered (correct), mais --page-url "https://www.facebook.com/nike" a produit view_all_page_id=nike — ce paramètre prend un ID de page numérique, donc l'affirmation "no need to manually find Page IDs" semble incorrecte pour les URL vanity. Sans jeton, le script se termine avec un message clair ; avec un jeton délibérément invalide, il a atteint api.apify.com et est mort sur un traceback requests.exceptions.HTTPError 401 non géré plutôt qu'une erreur conviviale. Je n'ai pas pu exécuter le scraping réel (pas de APIFY_API_TOKEN payant), donc aucune paire d'artefacts baseline-vs-skill n'existe et outputMeasured est false ; séparément, le schéma documenté snake_case "Output Fields" (spend_lower, impressions_lower, etc.) n'est pas produit par le code — la sortie json est un json.dumps brut du dataset Apify sans parsing, et format_summary lui-même revient aux clés camelCase. L'analyse de sécurité n'a trouvé aucun curl|sh, base64, subprocess/eval, chemins machine codés en dur, ou texte d'injection ; un flux de données non documenté : la définition de GOOSEWORKS_API_KEY redirige silencieusement toutes les requêtes via api.gooseworks.ai.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/gooseworks-ai/goose-skills.git /tmp/meta-ad-scraper-src
mkdir -p ~/.claude/skills
cp -R /tmp/meta-ad-scraper-src/skills/ads/capabilities/meta-ad-scraper ~/.claude/skills/meta-ad-scraper
# Dependency: pip install requests
# Required credential: export APIFY_API_TOKEN=apify_api_xxx  (https://console.apify.com/account/integrations)
#   Alternative: export GOOSEWORKS_API_KEY=... — the script then routes calls through https://api.gooseworks.ai/v1/proxy/apify instead of api.apify.com
# Run: python3 ~/.claude/skills/meta-ad-scraper/scripts/search_meta_ads.py --company "Nike" --country US --max-ads 20 --output summary
# Cost: the Apify actor bills per ad scraped (SKILL.md claims ~$5 / 1,000 ads) — unverified, no run was billed during this test
# Marketplace alternative: npx goose-skills install meta-ad-scraper

Commandes et exemples de prompts

  • /meta-ad-scraperExtrait les publicités des concurrents de la Meta Ad Library via un acteur Apify ; nécessite un jeton Apify payant.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Pull competitor ads from Meta's Ad Library
  • Check spend estimates for this brand's Facebook ads
  • Find creative inspiration from Instagram ad campaigns