Agent skill · marketing growth · sundial-org
google-ads
Query, audit, and optimize Google Ads campaigns. Supports two modes: (1) API mode for bulk operations with google-ads Python SDK, (2) Browser automation mode for users without API access - just attach a browser tab to ads.google.com. Use when asked to check ad performance, pause campaigns/keywords, find wasted spend, audit conversion tracking, or optimize Google Ads accounts.
Why this skill is useful
Provides specific API commands and browser automation workflows for managing Google Ads campaigns that the AI wouldn't reliably generate on its own.
What it needs
Requires google-ads account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Google Ads Skill Manage Google Ads accounts via API or browser automation. Mode Selection Check which mode to use: 1. API Mode - If user has google-ads.yaml configured or GOOGLEADS env vars 2. Browser Mode - If user says "I don't have API access" or just wants quick checks If no config found, ask: "Do you have Google Ads API credentials, or should I use browser automation?" --- Browser Automation Mode (Universal) Requirements: User logged into ads.google.com in browser Setup 1. User opens ads.google.com and logs in 2. User clicks Clawdbot Browser Relay toolbar icon (badge ON) 3. Use browser tool with profile="chrome" Common Workflows Get Campaign Performance Find Zero-Conversion Keywords (Wasted Spend) Pause Keywords/Campaigns Download Reports For detailed browser selectors: See references/browser-workflows.md --- API Mode (Power Users) Requirements: Google Ads API developer token + OAuth credentials Setup Check Common Operations Query Campaign Performance Find Zero-Conversion Keywords Pause Keywords For full API reference: See references/api-setup.md --- Audit Checklist Quick health check for any Google Ads account: Check Browser Path What to Look For ------- -------------- ------------------ Zero-conv keywords Keywords → Filter: Conv<1, Cost>$500 Wasted spend Empty ad groups Ad Groups → Filter: Ads=0 No creative running Policy violations Campaigns → Status column Yellow warning icons Optimization Score Overview page (top right) Below 70% = action needed Conversion tracking Tools → Conversions Inactive/no recent data --- Output Formats When reporting findings, use tables: --- Troubleshooting Browser Mode Issues Can't see data: Check user is on correct account (top right account selector) Slow loading: Google Ads UI is heavy; wait for tables to fully load Session expired: User needs to re-login to ads.google.com API Mode Issues Authentication failed: Refresh OAuth token, check google-ads.yaml Developer token rejected: Ensure token is approved (not test mode) Custome …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/google-ads