citedy/adclaw/google-ads
Claude Code and agent skill by citedy/adclaw
- community
Checking that the SKILL.md file is still in the repository.
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.
Install
npx vskill@latest install citedy/adclaw/google-adsSKILL.md
The same SKILL.md was published earlier as pedronauck/skills/google-ads.
Google Ads Skill
Manage Google Ads accounts via API or browser automation.
Mode Selection
Check which mode to use:
- API Mode - If user has
google-ads.yamlconfigured orGOOGLE_ADS_*env vars - 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
- User opens ads.google.com and logs in
- User clicks Clawdbot Browser Relay toolbar icon (badge ON)
- Use
browsertool withprofile="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)
- Customer ID error: Use 10-digit ID without dashes
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingsrc/adclaw/agents/skills/google-ads/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/citedy/adclaw/google-ads)