google-ad-scraper

Q: How do I install google-ad-scraper?

Run npx skills add https://github.com/gooseworks-ai/goose-skills --skill google-ad-scraper in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/google-ad-scraper/ (personal) or .claude/skills/google-ad-scraper/ (project).

by gooseworks-aiMarketing & SEO

Scrape competitor ads from Google Ads by domain. Returns ad creatives, formats, and campaign details. Use for competitive ad research and messaging analysis.

Installs: 51
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/gooseworks-ai/goose-skills --skill google-ad-scraper

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads google-ad-scraper automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Google Ads Scraper

Scrape ads from Google Ads using the Apify burbn/google-ads-search actor. Search by domain to get ad creatives, formats, and campaign details.

Quick Start

Requires APIFY_API_TOKEN env var (or --token flag).

# Search by domain (recommended)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "hubspot.com"

# Search by company name (resolves to domain via transparency center)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --company "Nike"

# Limit results
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "hubspot.com" --max-ads 30

# Human-readable summary
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "stripe.com" --output summary

How It Works

Domain Input: Pass the target company's domain directly via --domain
Company Name Resolution (optional): If only --company is provided, the script searches Google Ads Transparency Center using Apify's web-scraper (Puppeteer) to resolve the company name to advertiser info
Ad Scraping: Calls the Apify burbn/google-ads-search actor with {"domain": "...", "maxResults": N}
Output: Returns ads as JSON or human-readable summary

Input contract: maxResults is the actor’s documented limit field (official schema). This fallback remains temporary research; it does not create a saved GooseWorks ad-library source. Prefer the confirmed durable Google workflow in competitor-ad-intelligence when saving is requested.

CLI Reference

Flag	Default	Description
`--domain`	none	Company domain (e.g. hubspot.com) — recommended
`--company`	none	Company name (resolved to domain via transparency center)
`--max-ads`	50	Maximum number of ads to return
`--output`	json	Output format: `json` or `summary`
`--token`	env var	Apify token (prefer `APIFY_API_TOKEN` env var)
`--timeout`	300	Max seconds to wait for Apify run

At least one of --company or --domain is required.

Output Fields

Each ad in the output contains:

{
  "advertiserId": "AR13129532367502835713",
  "advertiserName": "Nike, Inc.",
  "creativeId": "CR12345678901234567890",
  "originalUrl": "https://www.nike.com/",
  "imageUrl": "https://...",
  "variantFormat": "TEXT",
  "variantContent": "Shop the latest Nike shoes...",
  "variants": [...],
  "variantCount": 3,
  "startDate": "2026-01-15"
}

Output fields:

Field	Description
`advertiserId`	Google Ads advertiser ID
`advertiserName`	Company/advertiser display name
`creativeId`	Unique ID for the ad creative
`originalUrl`	Destination URL the ad links to
`imageUrl`	URL of the ad image (if applicable)
`variantFormat`	Ad format (TEXT, IMAGE, VIDEO, etc.)
`variantContent`	Ad copy/text content
`variants`	Array of ad variants
`variantCount`	Number of variants for this creative
`startDate`	Date the ad first appeared

Cost

Ad scraping: Varies by actor pricing, typically a few cents per domain
Company name resolution (optional): ~$0.05 (one web-scraper page)

Common Workflows

1. Competitor Ad Research

python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "competitor.com" --max-ads 100 --output summary

2. Compare Multiple Competitors

# Run for each competitor domain
for domain in "competitor1.com" "competitor2.com" "competitor3.com"; do
  python3 skills/google-ad-scraper/scripts/search_google_ads.py \
    --domain "$domain" --max-ads 50
done

Limitations

Company name resolution uses Puppeteer-based web scraping of Google's SPA. It may occasionally fail — use --domain for best results.
Ad coverage: Google only shows ads from verified advertisers. Some smaller advertisers may not appear.
Historical data: Primarily shows recently active ads.

FAQ

What does the google-ad-scraper skill do?

Scrape competitor ads from Google Ads by domain. Returns ad creatives, formats, and campaign details. Use for competitive ad research and messaging analysis.

How do I install google-ad-scraper?

Run npx skills add https://github.com/gooseworks-ai/goose-skills --skill google-ad-scraper in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/google-ad-scraper/ (personal) or .claude/skills/google-ad-scraper/ (project).

Which AI agents can use google-ad-scraper?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is google-ad-scraper safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains google-ad-scraper?

It is published by gooseworks-ai in gooseworks-ai/goose-skills. It has 51 recorded installs.

More from gooseworks-ai/goose-skills

View all →

restaurant-booking

gooseworks-ai/goose-skills

Book restaurant reservations via browser automation. Use when asked to make dinner reservations, book a table, or find availability at restaurants. Supports OpenTable, Resy, and direct restaurant booking sites.

Productivity & Automation488 installs