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: мониторинг рекламы конкурентов в вашей категории
• YourCompanyGPT: что рекламируют AI-конкуренты

API Endpoints

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

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

Endpoint	Path	Input	Returns
Search Ads	/v1/facebook/adLibrary/search/ads	?query=keyword	Креативы, тексты, статус, даты
Company Ads	/v1/facebook/adLibrary/company/ads	?company_id=ID	Все объявления компании
Ad Details	/v1/facebook/adLibrary/ad	?ad_id=ID	Полная информация об объявлении
Search Companies	/v1/facebook/adLibrary/search/companies	?query=company_name	Найти company_id для дальнейшего поиска

Google Ad Library

Endpoint	Path	Input	Returns
Company Ads	/v1/google/company/ads	?company=name	Контекстная реклама компании
Ad Details	/v1/google/ad	?ad_id=ID	Детали объявления
Search Advertisers	/v1/google/adLibrary/advertisers/search	?query=keyword	Поиск рекламодателей

LinkedIn Ad Library

Endpoint	Path	Input	Returns
Search Ads	/v1/linkedin/ads/search	?query=keyword	B2B реклама по ключевому слову
Ad Details	/v1/linkedin/ad	?id=AD_ID	Детали конкретного объявления

Reddit Ads

Endpoint	Path	Input	Returns
Search Ads	/v1/reddit/ads/search	?query=keyword	Нативная реклама Reddit
Ad Details	/v1/reddit/ad	?ad_id=ID	Детали объявления

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 (ClientCorp3) — 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: YourCompanyGPT Competitive Intel

AI competitors to monitor:

• ChatGPT, Claude, Gemini

Credit Budget

Operation	Credits
Find company in FB Ad Library	1
Pull company's FB ads	1
Pull Google ads	1
Pull LinkedIn ads	1
Pull Reddit ads	1
Full competitor audit (4 platforms)	5
N competitors (Your-Brand scope)	~35

Periodic Monitoring

Combine with /loop or /schedule for recurring checks:

/loop 24h ad-spy YourCompetitor your-industry

Or integrate into your own cron collectors.

Integration

Next Step	Tool
Deep competitor analysis	competitive-analysis skill
Campaign planning	campaign-planning skill
Meta Ads optimization	meta-ads-analyzer skill
Content inspiration	content-creation skill
Report to stakeholders	stakeholder-comms skill
Save to your DB	your collector (your server)