Meta Ad Scraper

Stahuje reklamy konkurence z Meta Ad Library přes Apify actor; vyžaduje placený Apify token

od gooseworks-ai · gooseworks-ai/goose-skills

Funguje s nastavením ★ 5.6/10

Meta Ad Scraper — Stahuje reklamy konkurence z Meta Ad Library přes Apify actor; vyžaduje placený Apify token

Co umí

Obaluje Apify `apify/facebook-ads-scraper` actor v Python CLI, který sestaví vyhledávací URL Meta Ad Library z názvu společnosti, klíčového slova nebo URL Facebook stránky, spustí actor, dotazuje ho a vytiskne výsledné reklamy jako JSON nebo tabulku. Spouští se, když se zeptáte, jaké reklamy konkurent aktuálně provozuje na Facebooku nebo Instagramu, nebo požádáte o scraping Meta Ad Library pro značku nebo klíčové slovo. Vyžaduje Apify účet a APIFY_API_TOKEN (nebo Gooseworks klíč); samotný scraping je účtován za reklamu na Apify.

Testovací report

Klonoval jsem repozitář do dočasného HOME=$(mktemp -d) a potvrdil, že kopie umístí SKILL.md do ~/.claude/skills/meta-ad-scraper/SKILL.md; frontmatter má name+description a referenční tabulka CLI v těle přesně odpovídá argparse (příznaky a výchozí hodnoty: --country ALL, --ad-status active, --max-ads 50, --output json, --timeout 300). Z odkazovaných souborů v těle vrací scripts/search_meta_ads.py HTTP 200, ale references/apify-config.md vrací HTTP 404 (adresář v stromě neexistuje) a příkladové příkazy používají cestu skills/meta-ad-scraper/scripts/..., která neodpovídá ani rozložení repozitáře, ani nainstalovanému rozložení. Importoval jsem modul a spustil build_ad_library_url přímo: --company „Notion“ --country US vygenerovalo https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=Notion&search_type=keyword_unordered (správně), ale --page-url „https://www.facebook.com/nike“ vygenerovalo view_all_page_id=nike — tento parametr přijímá číselné ID stránky, takže tvrzení „není třeba ručně hledat ID stránek“ se zdá být chybné pro vanity URL. Bez tokenu skript skončí s chybou 1 a jasnou zprávou; s úmyslně neplatným tokenem dosáhl api.apify.com a zemřel na neošetřenou requests.exceptions.HTTPError 401 traceback namísto přátelské chyby. Nemohl jsem provést skutečný scraping (žádný placený APIFY_API_TOKEN), takže neexistuje žádný pár artefaktů baseline-vs-skill a outputMeasured je false; samostatně, dokumentované snake_case schéma „Output Fields“ (spend_lower, impressions_lower atd.) není produkováno kódem — json výstup je surový json.dumps Apify datasetu bez parsování a samotný format_summary se vrací k camelCase klíčům. Bezpečnostní sken nenašel žádné curl|sh, base64 bloby, subprocess/eval, pevně zakódované cesty stroje ani injekční text; jeden nedokumentovaný datový tok: nastavení GOOSEWORKS_API_KEY tiše přesměruje všechny požadavky přes api.gooseworks.ai.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /meta-ad-scraperStahuje reklamy konkurence z Meta Ad Library přes Apify actor; vyžaduje placený Apify token

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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