Skip to content

Home

Jump to bottom
John Williams edited this page Mar 31, 2026 · 2 revisions

Gemini CLI Google Ads Agent — Wiki

Open-source Google Ads management commands and AI agent skills for Gemini CLI. Analyze campaigns, audit accounts, and optimize PPC performance directly from your terminal.

Part of the Advertising Hub ecosystem | googleadsagent.ai | Built by John Williams

Last updated: March 26, 2026

Wiki Pages

Page Description
Getting Started Installation, authentication, and first run
Commands Reference Full documentation for /google-ads-analyze, /google-ads-audit, /google-ads-optimize
Google Ads Agent Skill Domain knowledge skill — GAQL, API v22, campaign analysis, write safety
Configuration Settings, environment variables, model selection
Related Projects Ecosystem links — MiniAgent, advertising-hub, MCP servers, free scripts

Quick Start

# Clone and build
git clone https://github.com/itallstartedwithaidea/gemini-cli-googleadsagent.git
cd gemini-cli-googleadsagent
npm install && npm run build

# Run (authenticates via Google on first launch — free tier: 60 req/min, 1,000 req/day)
npm start

Once inside the Gemini CLI prompt, use any of the Google Ads commands:

/google-ads-analyze  Top spending campaigns with declining ROAS last 30 days
/google-ads-audit    Full audit of our nonprofit Google Ads account
/google-ads-optimize Reduce CPA by 15% without losing conversion volume

What's Included

Component File Description
/google-ads-analyze .gemini/commands/google-ads-analyze.toml Campaign and account performance analysis with GAQL query suggestions
/google-ads-audit .gemini/commands/google-ads-audit.toml 7-area account audit with Critical/High/Medium/Low severity ratings
/google-ads-optimize .gemini/commands/google-ads-optimize.toml Top 3-5 optimization recommendations prioritized by effort vs. impact
Google Ads Agent Skill .gemini/skills/google-ads-agent/skill.md Domain knowledge auto-activated for any advertising-related question

Use in Any Project

You don't need to clone the full repo. Copy the commands and skill into any project:

mkdir -p your-project/.gemini/commands your-project/.gemini/skills
cp .gemini/commands/google-ads-*.toml your-project/.gemini/commands/
cp -r .gemini/skills/google-ads-agent/ your-project/.gemini/skills/

cd your-project && gemini

Links

Clone this wiki locally