Gads Transparency

npm version License: MIT

A Model Context Protocol (MCP) server that gives AI assistants like Claude Desktop, Cursor, Windsurf, and any MCP client access to the Google Ads Transparency Center. Research competitor ads, analyze advertiser profiles, and compare ad presence across 42 regions — all through natural language.

100% Free. No API keys. Uses publicly available Google Ads Transparency data. No Google account or API key required.

What Can You Do?

Ask Claude questions like:

• "What ads is Nike running in the US right now?"
• "Search for advertisers in the fitness industry"
• "Compare Shopify's ad presence in the US vs UK vs India"
• "Show me the advertiser profile for amazon.com"
• "Get details on this specific ad creative"

Quick Start

npx gads-transparency-mcp

Or install globally:

npm install -g gads-transparency-mcp

Requirements: Node.js >= 18. Puppeteer downloads Chromium automatically on first install.

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "gads-transparency": {
      "command": "npx",
      "args": ["-y", "gads-transparency-mcp"]
    }
  }
}

Restart Claude Desktop. Done — Google Ads Transparency data is now available in Claude.

Use with Other MCP Clients

Works with any MCP-compatible client including Cursor, Windsurf, VS Code + Cline, and more:

npx gads-transparency-mcp

Available Tools (5 Competitive Intelligence Tools)

Tool	Description
search_advertiser	Search for advertisers by website domain or brand name
get_advertiser_ads	Get all ads currently running for a specific advertiser (filter by format: text, image, video)
get_ad_details	Get detailed information about a specific ad creative
get_advertiser_profile	Get an advertiser's profile, verification status, and ad activity summary
compare_ad_presence	Compare an advertiser's ad presence across multiple regions

Examples

Example 1: Research competitor ads

User prompt: "Show me all ads currently running by Nike in the US"

Expected behavior:

• Calls search_advertiser with query "nike.com" and region "US" to find Nike's advertiser ID
• Then calls get_advertiser_ads with the advertiser ID and region "US"
• Returns a list of Nike's currently running ads with headlines, descriptions, ad format (text/image/video), and thumbnails

Example 2: Get an advertiser's profile and verification status

User prompt: "Show me the advertiser profile for amazon.com"

Expected behavior:

• Calls search_advertiser with query "amazon.com" to find Amazon's advertiser ID
• Then calls get_advertiser_profile with the advertiser ID
• Returns Amazon's advertiser name, Google verification status, total ad count, ad format distribution (text/image/video), and platform presence

Example 3: Compare ad presence across regions

User prompt: "Compare Shopify's ad presence in the US, UK, and India"

Expected behavior:

• Calls search_advertiser with query "shopify.com" to find Shopify's advertiser ID
• Then calls compare_ad_presence with the advertiser ID and regions ["US", "GB", "IN"]
• Returns ad counts and format distribution for each region, highlighting where Shopify is most and least active

Use Cases

• Competitor Ad Research — See what ads your competitors are running right now
• Ad Creative Inspiration — Browse ad creatives by advertiser, format, and region
• Market Intelligence — Understand advertiser activity across different markets
• Brand Safety — Monitor who's advertising alongside your brand
• Regional Strategy — Compare ad presence across 42 countries to plan international campaigns
• Advertiser Verification — Check if an advertiser is verified by Google
• PPC Research — Research ad strategies without expensive competitive intelligence tools

Supported Regions (42 Countries)

Region	Code	Region	Code	Region	Code
United States	US	United Kingdom	GB	India	IN
Canada	CA	Australia	AU	Germany	DE
France	FR	Japan	JP	Brazil	BR
Mexico	MX	Italy	IT	Spain	ES
Netherlands	NL	Sweden	SE	Norway	NO
Denmark	DK	Finland	FI	Poland	PL
Austria	AT	Switzerland	CH	Belgium	BE
Ireland	IE	Portugal	PT	New Zealand	NZ
Singapore	SG	Hong Kong	HK	Taiwan	TW
South Korea	KR	Philippines	PH	Malaysia	MY
Thailand	TH	Indonesia	ID	Vietnam	VN
South Africa	ZA	UAE	AE	Saudi Arabia	SA
Egypt	EG	Nigeria	NG	Kenya	KE
Argentina	AR	Chile	CL	Colombia	CO
Peru	PE

Features

• Built-in Rate Limiting — 2s between requests, max 30/min, with random delays
• Response Caching — 1hr TTL, up to 1000 entries, reduces redundant scraping
• Anti-Detection — Rotating user agents, viewport randomization, stealth plugin
• Automatic Retries — Exponential backoff (5s-30s) on failures, up to 3 attempts
• Graceful Shutdown — Proper cleanup of browser instances on exit

Limitations

• Rate Limited: ~30 requests/minute to avoid blocking
• No Historical Data: Only currently running ads are visible
• Regional: Must specify region for each request
• May Break: Google can change the Transparency Center at any time
• No Spend Data: Ad spend info only available for political ads

Requirements

• Node.js >= 18
• Chrome/Chromium — Puppeteer downloads it automatically on install
• No API keys, no authentication, no Google account needed

Related

• Google Ads Transparency Center — The data source
• Model Context Protocol — The open standard for AI-tool integration
• Claude Desktop — Anthropic's desktop AI assistant
• MCP Server Registry — Curated list of MCP servers

Privacy Policy

See PRIVACY.md for our complete privacy policy.

TL;DR: This extension runs locally on your machine. It accesses only publicly available data from the Google Ads Transparency Center — the same data anyone can view in a browser. No data is collected, stored, or transmitted to any third party by this MCP server. No API keys or authentication required.

License

MIT