Ad Spy

Ad Spy — Competitor Ad Intelligence

Cross-platform ad monitoring via a 3rd-party scraping API. Key: SCRAPER_API_KEY from ~/.claude/.credentials.master.env

When to Use

• "что рекламируют конкуренты" — обзор рекламной активности
• "реклама [компания] в Facebook/Google/LinkedIn"
• "ad spy [бренд]" — полный анализ рекламы
• "креативы конкурентов" — сбор рекламных материалов
• "мониторинг рекламы" — периодический трекинг
• Your Tracker: мониторинг рекламы конкурентов в своей нише
• YourProduct: что рекламируют AI-конкуренты
• "spy за Яндекс Директом / VK / Telegram Ads" — российские каналы (см. references)
• "лучшие креативы конкурентов в FB", "бюджет конкурента", "Atria" — Meta-креативный спай

Российские каналы и Meta-креативы

Scraping API хорошо покрывает FB/Google/LinkedIn/Reddit, но российские каналы и продвинутый Meta-креативный анализ требуют отдельных инструментов. Подробности — в references:

Связанные скиллы: meta-ads-launch-ru (запуск своих Meta-кампаний на основе разведки), ai-creative-factory-ru (декомпозиция найденных виральных креативов), telegram-ads-pro-ru / vk-ads-pro-ru (запуск в найденных каналах), ad-benchmarks-ru (нормы для оценки увиденных кампаний).

API Endpoints

BASE = https://api.your-scraper.example
AUTH: x-api-key: $SCRAPER_API_KEY

Facebook Ad Library (основной — самый большой объём рекламы)

Google Ad Library

LinkedIn Ad Library

Reddit Ads

Workflow: Competitor Ad Audit

Step 1: Find competitors in ad libraries

source ~/.claude/.credentials.master.env
API="https://api.your-scraper.example"
H="x-api-key: $SCRAPER_API_KEY"

# Find company in Facebook Ad Library
curl -s "$API/v1/facebook/adLibrary/search/companies?query=COMPETITOR_NAME" -H "$H" | python3 -m json.tool

Step 2: Pull all their ads (parallel across platforms)

source ~/.claude/.credentials.master.env
API="https://api.your-scraper.example"
H="x-api-key: $SCRAPER_API_KEY"

# Facebook ads
curl -s "$API/v1/facebook/adLibrary/company/ads?company_id=COMPANY_ID" -H "$H" > /tmp/ads_fb.json &

# Google ads
curl -s "$API/v1/google/company/ads?company=COMPETITOR_NAME" -H "$H" > /tmp/ads_google.json &

# LinkedIn ads
curl -s "$API/v1/linkedin/ads/search?query=COMPETITOR_NAME" -H "$H" > /tmp/ads_linkedin.json &

# Reddit ads
curl -s "$API/v1/reddit/ads/search?query=COMPETITOR_NAME" -H "$H" > /tmp/ads_reddit.json &

wait
echo "All ad data fetched"

Step 3: Analyze & synthesize

Read all JSON results and create structured report:

# Ad Intelligence Report: [Competitor]
Generated: [date] | Sources: Facebook, Google, LinkedIn, Reddit

## Summary
- **Total active ads:** [count by platform]
- **Primary platforms:** [where they spend most]
- **Ad types:** [video, image, carousel, text]
- **Key messages:** [top 3 themes/value props]

## Facebook Ads
| Creative | Copy (first line) | CTA | Status | Running Since |
|----------|-------------------|-----|--------|---------------|
| [image/video desc] | [text] | [button] | Active | [date] |

## Google Ads
| Headline | Description | Landing Page | Keywords (estimated) |
|----------|-------------|-------------|---------------------|
| [text] | [text] | [url] | [inferred] |

## LinkedIn Ads
| Format | Copy | Target (estimated) | Engagement |
|--------|------|-------------------|------------|
| [type] | [text] | [audience hints] | [reactions] |

## Reddit Ads
| Subreddit | Title | Copy | Engagement |
|-----------|-------|------|------------|
| r/xxx | [title] | [text] | [upvotes, comments] |

## Insights & Recommendations
1. **Messaging gaps:** What competitors say that we don't
2. **Channel gaps:** Where they advertise that we don't
3. **Creative patterns:** What formats perform best for them
4. **Timing:** When they launch new campaigns
5. **Recommended actions:** [specific suggestions]

Step 4: Save report

mkdir -p ~/Documents/Ad-Intel
# Write report to markdown file with date in filename

Use Case: Your Tracker

Competitors to monitor:

• Your-Brand — own brand awareness
• [Competitor1], [Competitor2], [Competitor3]

# Example: monitor all Your-Brand competitors
for company in "Comp1" "Comp2" "Comp3" "Comp4"; do
  curl -s "$API/v1/facebook/adLibrary/search/ads?query=$company your-industry" \
    -H "$H" > "/tmp/ads_${company// /_}.json"
  sleep 1
done

Use Case: YourProduct Competitive Intel

AI competitors to monitor:

• ChatGPT, Claude, Gemini

Credit Budget

Periodic Monitoring

Combine with /loop or /schedule for recurring checks:

/loop 24h ad-spy YourCompetitor your-industry

Or integrate into Your Tracker cron collectors on your-server.

Если банят: прямой скрап Ad Library в обход API

ScraperVendor — основной путь (не требует обхода защит). Но при прямом скрапе Ad Library (FB/Google/TikTok) или витрин конкурентов, когда встаёт анти-бот (Cloudflare/Datadome, «Access denied», капча, пустой ответ на requests):

• Лёгкий скрап без браузера: curl_cffi с impersonate="chrome" — подделывает TLS/JA3 под реальный Chrome, requests-совместимый API. Первый выбор для JSON/HTML-эндпоинтов.
• Полный браузер под анти-ботом: patchright вместо playwright (drop-in импорт, channel="chrome" + persistent context) — скрывает navigator.webdriver и CDP-утечки.

Рецепты + таблица «симптом бана → инструмент»: ../playwright-automation/references/stealth-scraping.md.

Integration