Skip to content

PPC Assistant

Repo: savvydealer-adam/ppc-assistant · Path: C:/Users/adam/ppc-assistant · Owner: Adam Status: Live · % Done: 75 · Last commit: 2026-03-18 Deployed: Installable pip package (CLI), not a hosted service

What it is

Python/Typer CLI + Pydantic toolkit that builds, parses, and analyzes Google Ads campaigns for car dealerships. Codifies the SavvyDealer PPC playbook in YAML config so accounts come out consistent.

Why it exists

Manual PPC setup for each new dealer burned hours and drifted from best practices. PPC Assistant generates a compliant account structure from a few inputs (dealer, make, URL, hosting platform) and reviews existing exports against the playbook.

How it works

Python 3 + Typer CLI + Pydantic models. YAML configs for everything dealer-specific. - Parsers auto-detect Google Ads Editor TSV vs template CSV. - Builder generates campaigns, ad groups, keywords, RSAs, final URLs per hosting platform. - Analyzer flags drift from best practices + compliance issues. - Budget projector rolls daily spend to monthly, prorated. - Exporter produces Google Ads Editor import CSV.

What's done

  • Account build, parse, analyze, budget, export commands.
  • 7 hosting platforms supported (DealerOn, DealerInspire, Dealer.com, Dealer eProcess, Fox Dealer, Sincro, SavvyDealer).
  • YAML configs: best practices, make lineups, URL patterns, ad copy templates, negative keyword lists.
  • Test data from Coleman Chevrolet, Alan Jay Kia, Jarrett Scott Ford.

What's next

  • Recurring drift analysis per client (ppc_drift_analysis.py in place).
  • Account-level reporting dashboard (dashboard/ scaffolded).
  • Broader keyword analysis (analyze_keywords.py).

Where the code lives

  • CLI entry: ppc_assistant/cli.py
  • Models: ppc_assistant/models/
  • Configs: ppc_assistant/config/*.yaml
  • Builder, analyzer, budget, parsers, exporters: ppc_assistant/*/
  • Docs: ppc_assistant/CLAUDE.md

Integrations

Feeds from dealer info kept in CRM / Contracts tool. Exports land in Google Ads Editor for ingestion. No direct runtime integrations with other SavvyDealer products yet.

Don't rebuild this — extend it

Brian's Google Ads AI work should extend this, not rebuild. The playbook, YAML configs, and generator are already here — plug AI on top of the existing builder/analyzer instead of starting over.