Meta Ad Scraper

Estrae annunci della concorrenza dalla Meta Ad Library tramite un actor Apify; richiede un token Apify a pagamento.

di gooseworks-ai · gooseworks-ai/goose-skills

Richiede configurazione ★ 5.6/10

Meta Ad Scraper — Estrae annunci della concorrenza dalla Meta Ad Library tramite un actor Apify; richiede un token Apify a pagamento.

Cosa fa

Avvolge l'actor Apify `apify/facebook-ads-scraper` in una CLI Python che costruisce un URL di ricerca della Meta Ad Library da un nome di azienda, parola chiave o URL di pagina Facebook, esegue l'actor, lo interroga e stampa gli annunci risultanti come JSON o una tabella. Si attiva quando si chiede quali annunci un concorrente sta attualmente pubblicando su Facebook o Instagram, o si chiede di fare scraping della Meta Ad Library per un brand o una parola chiave. Richiede un account Apify e APIFY_API_TOKEN (o una chiave Gooseworks); lo scraping stesso viene fatturato per annuncio su Apify.

Rapporto di test

Clonato il repo in una HOME temporanea=$(mktemp -d) e confermato che la copia posiziona SKILL.md in ~/.claude/skills/meta-ad-scraper/SKILL.md; il frontmatter ha name+description, e la tabella di riferimento CLI nel corpo corrisponde esattamente ad argparse (flag e default: --country ALL, --ad-status active, --max-ads 50, --output json, --timeout 300). Dei file referenziati nel corpo, scripts/search_meta_ads.py restituisce HTTP 200 ma references/apify-config.md restituisce HTTP 404 (la directory non esiste nell'albero), e i comandi di esempio usano il percorso skills/meta-ad-scraper/scripts/... che non corrisponde né al layout del repo né al layout installato. Ho importato il modulo e ho eseguito direttamente build_ad_library_url: --company "Notion" --country US ha prodotto https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=Notion&search_type=keyword_unordered (corretto), ma --page-url "https://www.facebook.com/nike" ha prodotto view_all_page_id=nike — quel parametro richiede un ID di pagina numerico, quindi l'affermazione "non c'è bisogno di trovare manualmente gli ID di pagina" sembra errata per gli URL vanity. Senza token lo script esce con codice 1 con un messaggio chiaro; con un token deliberatamente non valido ha raggiunto api.apify.com ed è morto su un traceback requests.exceptions.HTTPError 401 non gestito anziché un errore amichevole. Non ho potuto eseguire lo scraping effettivo (nessun APIFY_API_TOKEN a pagamento), quindi nessuna coppia di artefatti baseline-vs-skill esiste e outputMeasured è false; separatamente, lo schema documentato "Output Fields" in snake_case (spend_lower, impressions_lower, etc.) non è prodotto dal codice — l'output json è un json.dumps raw del dataset Apify senza parsing, e format_summary stesso ricade su chiavi camelCase. La scansione di sicurezza non ha trovato blob curl|sh, base64, subprocess/eval, percorsi macchina hardcoded o testo di iniezione; un flusso di dati non documentato: l'impostazione di GOOSEWORKS_API_KEY reindirizza silenziosamente tutte le richieste tramite api.gooseworks.ai.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

/meta-ad-scraperEstrae annunci della concorrenza dalla Meta Ad Library tramite un actor Apify; richiede un token Apify a pagamento.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →