Quick Start

Quick Start

Get the agent running in under 5 minutes.

Option 1: Install as Package

pip install google-ads-agent

Option 2: Clone from Source

git clone https://github.com/itallstartedwithaidea/google-ads-api-agent.git
cd google-ads-api-agent
pip install -r requirements.txt

Configure Credentials

cp .env.example .env
# Edit .env with your API keys (see Credentials Setup)

Validate

python scripts/validate.py

This checks:

• All 28 action files exist and are importable
• Required environment variables are set
• Google Ads API connection works (optional live test)

Run

Interactive CLI

python scripts/cli.py

REST API Server

uvicorn deploy.server:app --host 0.0.0.0 --port 8000

Docker

docker compose up -d

First Commands to Try

Command	What It Does
Test my Google Ads connection	Verifies API credentials work
Show me an account summary	Pulls spend, clicks, conversions for last 30 days
List my top 5 campaigns by spend	Ranked campaign performance
Find wasted spend	Search terms with zero conversions
Create a test label called "Agent Test"	Tests write operations (with confirmation)

Next Steps

• Credentials Setup — Detailed credential configuration
• Tool Reference — All 47 read + 62 write operations
• Architecture Overview — How the system works