Meta Ad Scraper

Pobiera reklamy konkurencji z Meta Ad Library za pośrednictwem aktora Apify; wymaga płatnego tokena Apify

Autor: gooseworks-ai · gooseworks-ai/goose-skills

Działa po konfiguracji ★ 5.6/10

Meta Ad Scraper — Pobiera reklamy konkurencji z Meta Ad Library za pośrednictwem aktora Apify; wymaga płatnego tokena Apify

Co robi ten skill

Opakowuje aktora Apify `apify/facebook-ads-scraper` w Python CLI, który buduje URL wyszukiwania Meta Ad Library na podstawie nazwy firmy, słowa kluczowego lub URL strony Facebook, uruchamia aktora, odpytuje go i drukuje wynikowe reklamy jako JSON lub tabelę. Uruchamia się, gdy pytasz, jakie reklamy konkurent obecnie wyświetla na Facebooku lub Instagramie, lub prosisz o skrapowanie Meta Ad Library dla marki lub słowa kluczowego. Wymaga konta Apify i APIFY_API_TOKEN (lub klucza Gooseworks); samo skrapowanie jest rozliczane za reklamę na Apify.

Raport z testu

Sklonowano repozytorium do tymczasowego HOME=$(mktemp -d) i potwierdzono, że kopia ląduje SKILL.md w ~/.claude/skills/meta-ad-scraper/SKILL.md; frontmatter ma name+description, a tabela referencyjna CLI w treści dokładnie odpowiada argparse (flagi i wartości domyślne: --country ALL, --ad-status active, --max-ads 50, --output json, --timeout 300). Spośród plików, do których odwołuje się treść, scripts/search_meta_ads.py zwraca HTTP 200, ale references/apify-config.md zwraca HTTP 404 (katalog nie istnieje w drzewie), a przykładowe polecenia używają ścieżki skills/meta-ad-scraper/scripts/..., która nie pasuje ani do układu repozytorium, ani do zainstalowanego układu. Zaimportowałem moduł i uruchomiłem build_ad_library_url bezpośrednio: --company „Notion” --country US wygenerowało https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=Notion&search_type=keyword_unordered (poprawnie), ale --page-url „https://www.facebook.com/nike” wygenerowało view_all_page_id=nike — ten parametr przyjmuje numeryczny Page ID, więc twierdzenie „no need to manually find Page IDs” wydaje się błędne dla vanity URLs. Bez tokena skrypt kończy działanie z błędem 1 i jasnym komunikatem; z celowo nieprawidłowym tokenem dotarł do api.apify.com i zakończył się nieobsłużonym śladem requests.exceptions.HTTPError 401 zamiast przyjaznego błędu. Nie mogłem wykonać faktycznego skrapowania (brak płatnego APIFY_API_TOKEN), więc nie istnieje para artefaktów baseline-vs-skill, a outputMeasured jest fałszywe; oddzielnie, udokumentowany schemat „Output Fields” w snake_case (spend_lower, impressions_lower itp.) nie jest produkowany przez kod — wyjście json to surowe json.dumps zestawu danych Apify bez parsowania, a sam format_summary wraca do kluczy camelCase. Skan bezpieczeństwa nie znalazł curl|sh, base64 blobs, subprocess/eval, hardcoded machine paths ani tekstu iniekcji; jeden nieudokumentowany przepływ danych: ustawienie GOOSEWORKS_API_KEY cicho przekierowuje wszystkie żądania przez api.gooseworks.ai.

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

Instalacja

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

Komendy i przykładowe prompty

  • /meta-ad-scraperPobiera reklamy konkurencji z Meta Ad Library za pośrednictwem aktora Apify; wymaga płatnego tokena Apify

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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