# Google Ads API Agent — googleadsagent.ai

> Last updated: 2026-03-02

> An open-source, enterprise-grade AI agent that manages Google Ads accounts through the API. 28 custom Python actions, 6 specialized sub-agents, live read/write access. Built on Claude by Anthropic. Free to use.

Built by [John Williams](https://itallstartedwithaidea.com) — Senior Paid Media Specialist at [Seer Interactive](https://www.seerinteractive.com), 15+ years managing $48M+ in digital advertising. Conference speaker at [Hero Conf](https://paidsearch.org/event/hero-conf-2025-san-diego/).

## Entity Relationships

- **googleadsagent.ai** is a product of **[It All Started With A Idea](https://itallstartedwithaidea.com)** (parent organization).
- **It All Started With A Idea** is a performance marketing agency founded by **John Williams**, specializing in PPC, Google Ads, and AI-powered marketing tools.
- **John Williams** is the founder and creator of both googleadsagent.ai and itallstartedwithaidea.com, and currently serves as Senior Paid Media Specialist at Seer Interactive.
- Both domains share the same entity: [itallstartedwithaidea.com](https://itallstartedwithaidea.com) (agency & blog) → [googleadsagent.ai](https://googleadsagent.ai) (product & tools).

## Tools & Products

- [Google Ads API Agent — Homepage](https://googleadsagent.ai): The Loop — AI agent with 28 API actions, 6 sub-agents, live Google Ads read/write.
- [GitHub: Google Ads API Agent](https://github.com/itallstartedwithaidea/google-ads-api-agent): Full source code — 66 files, MIT licensed.
- [250-Point Audit Engine](https://googleadsagent.ai/tools/audit-engine/): 250-point Google Ads audit, MCP connectors, auto-strategy generation.
- [250-Point Audit Engine App](https://googleadsagent.ai/tools/audit-engine/app.html): Live audit application — single HTML file, zero dependencies.
- [GitHub: Audit Engine](https://github.com/itallstartedwithaidea/google-ai-agent-audit-engine): Audit engine source code.
- [Google Ads Builder](https://googleadsagent.ai/tools/google-ads-builder/): AI-powered RSA headline & description generator. Claude, GPT, or Gemini.
- [Google Ads Builder App](https://googleadsagent.ai/tools/google-ads-builder/app.html): Live ad copy generator.
- [Marketing Analytics Auditor](https://googleadsagent.ai/tools/auditor/): GA4 + GTM + pixel auditor with auto-remediation code.
- [Marketing Analytics Auditor App](https://googleadsagent.ai/tools/auditor/app.html): Live scanner application.
- [Business Discovery Engine](https://googleadsagent.ai/tools/business-discovery/): Lead discovery from public data — 65 categories, 4 sources, 9 email methods.
- [GitHub: Business Discovery Engine](https://github.com/itallstartedwithaidea/business-discovery-engine): Discovery engine source.
- [GitHub: Google Ads Scripts Collection](https://github.com/itallstartedwithaidea): Open-source Google Ads scripts and tools.
- [Ghost Writer — AI Content Engine](https://googleadsagent.ai/tools/writing-agent/): AI content engine with Ghost Protocol — 40-point QA, 18 platform formatters, triple-detector validation (GPTZero + Pangram + Originality.ai), voice fingerprinting. GPT-5.4 powered.
- [Ghost Writer App](https://googleadsagent.ai/tools/writing-agent/app.html): Live content generator with grammar checking, readability scoring, AI detection, and voice profile import.
- [Ghost Writer Docs](https://googleadsagent.ai/tools/writing-agent/docs.html): Full documentation — 40-point QA system, platform specs, voice profiles, API reference.
- [GitHub: Writing Agent](https://github.com/itallstartedwithaidea/writing-agent): Ghost Protocol source code — 5-agent pipeline, 40-point QA, phrase blacklist, voice profiles.

## Mobile App

- [Google Ads Agent — Mobile App](https://googleadsagent.ai/app/): Download the mobile app for iOS and Android.
- [Google Play Store](https://play.google.com/store/apps/details?id=com.itallstartedwithaidea.googleadsagent): Android app — free to download.
- [GitHub: Mobile App](https://github.com/itallstartedwithaidea/googleadsagent-mobile): Full source code — Expo/React Native, MIT licensed.
- Features: Streaming AI chat with Buddy, 9 integrated tools via WebView, Creative Validator (camera + 50 platform specs), haptic feedback, deep linking, skeleton loaders, pull-to-refresh dashboard, dark theme.
- 25 free credits on signup. Creative validation is always free.

## ARGUS — Algorithmic Authenticity Analysis Platform

- [ARGUS Overview](https://googleadsagent.ai/tools/argus/): Free open-source algorithmic authenticity analysis platform for social media profiles.
- [ARGUS Submit Profile](https://googleadsagent.ai/tools/argus/app.html): Submit any social media profile URL for analysis.
- [ARGUS Documentation](https://googleadsagent.ai/tools/argus/docs.html): Complete documentation: setup, API reference, detection methodology, browser extension.
- [ARGUS Dispute / Opt-Out](https://googleadsagent.ai/tools/argus/dispute.html): Challenge or opt-out of an ARGUS authenticity analysis.
- [GitHub: ARGUS](https://github.com/itallstartedwithaidea/argus): Full source code — Worker API, detection pipeline, Chrome extension, D1 schema. MIT licensed.
- Analyzes LinkedIn, Reddit, Instagram, X, and Facebook profiles with four parallel detection engines: Image (Hive AI, C2PA, EXIF), Text (GPTZero, stylometrics), Behavioral (account age, patterns), Network (coordination detection).
- Trust scores from 0-100 with full signal breakdown. Score weights: Network (35%) > Behavioral (30%) > Image (20%) > Text (15%).
- Cloudflare-native: Workers, D1 (SQLite), R2 (evidence vault), KV (cache), Queues (async processing), Pages (frontend). Monthly cost: ~$0-5.
- Chrome MV3 extension injects trust badges on social media platforms in real time.
- Every published page is human-reviewed. All analysis framed as algorithmic opinion, not a verdict. Prominent dispute mechanism.

## Service Landing Pages — Programmatic SEO

- [All Service Pages](https://googleadsagent.ai/services/): 1,971,336 landing pages across 18,744 US cities and 105+ service verticals.
- [Phoenix, AZ — Plumber](https://googleadsagent.ai/services/phoenix-az/plumber/): Example service page.
- [Dallas, TX — HVAC](https://googleadsagent.ai/services/dallas-tx/hvac/): Example service page.
- [Miami, FL — Roofing](https://googleadsagent.ai/services/miami-fl/roofing/): Example service page.
- Edge-rendered via Cloudflare Pages Functions. Each page includes local market intelligence, pain-point analysis, Schema.org ProfessionalService + Organization + Person + WebSite + BreadcrumbList + FAQPage markup (V2 complete schema stack), seasonal demand data, CPC benchmarks, climate/economic signals, and a lead capture form. $500/month flat fee, no contract, free 30-day audit. All pages indexed — zero noindex tags.

## Ecommerce Landing Pages — Programmatic SEO

- [All Ecommerce Pages](https://googleadsagent.ai/ecommerce/): Landing pages across 20 ecommerce industries × 18,744 US cities.
- [Phoenix, AZ — Electronics](https://googleadsagent.ai/ecommerce/phoenix-az/electronics): Example ecommerce page.
- [Dallas, TX — Apparel & Accessories](https://googleadsagent.ai/ecommerce/dallas-tx/apparel-accessories): Example ecommerce page.
- [Miami, FL — Health & Beauty](https://googleadsagent.ai/ecommerce/miami-fl/health-beauty): Example ecommerce page.
- Edge-rendered via Cloudflare Pages Functions. Each page includes industry-specific market intelligence, seasonal demand analysis, economic indicators, Schema.org Article + BreadcrumbList + FAQPage + Organization + Person + WebSite markup (V2 complete schema stack), E-E-A-T author credentials, and dynamic CPC/competitive data. All pages indexed with max-snippet:-1, max-image-preview:large. 20 industries: Fashion, Electronics, Home & Garden, Health & Beauty, Sports, Food & Beverage, Automotive Parts, Pet Supplies, Jewelry, Toys & Games, Office Supplies, Baby Products, Books & Media, Tools & Hardware, Outdoor & Camping, Musical Instruments, Art Supplies, Craft & Hobby, Garden & Patio, Luxury Goods.

## Education & Courses

- [AI Agents Crash Course](https://googleadsagent.ai/course/): Free, open-source 5-day course from absolute zero to deploying multi-agent systems. 28 API actions, 6 sub-agents, 5 white papers, 5 playable games, APA 7th citations.
- [GitHub: AI Agents Crash Course](https://github.com/itallstartedwithaidea/ai-agents-crash-course): Full source code for the crash course including games, prompts, docs, and references.
- Curriculum: Day 1 (AI Agents + Tetris) → Day 2 (Tools & MCP + Zelda) → Day 3 (Context Engineering + Football) → Day 4 (Agent Quality + Mario) → Day 5 (Production & Multi-Agent + Duck Hunt) → Capstone (AI Game Master RPG).
- Three learning paths: Observer (executives, 2-3 hrs/day), Builder (marketers, 4-6 hrs), Architect (developers, 6-8 hrs).
- Based on 5 Google/Kaggle white papers. References: Google I/O 2025, NRF 2026 UCP, Anthropic MCP, Google A2A, ReAct paper.

## Architecture & Docs

- [Architecture Documentation](https://github.com/itallstartedwithaidea/google-ads-api-agent/blob/main/docs/ARCHITECTURE.md): CEP Protocol, Filter-First, Top-Down Reporting, adapter layer, write safety.
- [llms-full.txt](https://googleadsagent.ai/llms-full.txt): Complete technical reference for all projects.
- [Audit Engine Docs](https://googleadsagent.ai/tools/audit-engine/docs.html): Scoring methodology, MCP config, export formats.
- [Google Ads Builder Docs](https://googleadsagent.ai/tools/google-ads-builder/docs.html): Builder documentation.
- [Marketing Auditor Docs](https://googleadsagent.ai/tools/auditor/docs.html): Auditor documentation with sidebar navigation.
- [Business Discovery Docs](https://googleadsagent.ai/tools/business-discovery/docs.html): Setup guide, CLI reference, architecture.

## Blog & Articles — itallstartedwithaidea.com

- [Blog Index](https://itallstartedwithaidea.com/blogs/): All published articles on paid media, AI, and advertising strategy.
- [The Dark Side of AI Overload in Campaign Management](https://itallstartedwithaidea.com/the-dark-side-of-ai-overload-in-campaign-management/): Analysis of AI tool proliferation risks in PPC.
- [The Future of Automated Campaign Types in PPC and Social Media](https://itallstartedwithaidea.com/the-future-of-automated-campaign-types-in-ppc-and-social-media/): Forward-looking view on automation in paid media.
- [Truths in AI Search Has A Citation Problem](https://itallstartedwithaidea.com/truths-in-ai-search-has-a-citation-problem/): AI search citation and attribution analysis.
- [Doing Ads on a Small Budget: A Strategic Guide](https://itallstartedwithaidea.com/doing-ads-on-a-small-budget-a-strategic-guide/): Small-budget PPC strategies.
- [Unlocking Accurate Google Ads Impression Share with a Simple Script](https://itallstartedwithaidea.com/unlocking-accurate-google-ads-impression-share-with-a-simple-script/): Technical script walkthrough.
- [Rethinking Ads & CPC Strategies in 2025](https://itallstartedwithaidea.com/rethinking-ads-cpc-strategies-in-2025/): CPC strategy evolution.
- [Balancing Visionary Leadership with AI-Driven Decision-Making](https://itallstartedwithaidea.com/balancing-visionary-leadership-with-ai-driven-decision-making-white-paper/): White paper on AI leadership.
- [Guide 2025: From Strategy to Execution](https://itallstartedwithaidea.com/guide-2025-from-strategy-to-execution/): Comprehensive 2025 digital marketing guide.
- [Free Google Ads Headline & Description Generator](https://itallstartedwithaidea.com/free-google-ads-headline-description-generator/): Ad copy generator how-to.
- [Google Ads Campaign Management: From Single Sheet to Multi-Account Scaling](https://itallstartedwithaidea.com/google-ads-campaign-management-from-single-sheet-to-multi-account-scaling/): Scaling Google Ads management.
- [Maximizing the Power of Customer Lists and First Party Data in Google Ads](https://itallstartedwithaidea.com/maximizing-the-power-of-customer-lists-and-first-party-data-in-google-ads/): First-party data strategy.
- [PMAX: Audiences To Test or Not To Test](https://itallstartedwithaidea.com/pmax-audiences-to-test-or-not-to-test/): Performance Max audience strategy.
- [Budget Projection & Performance Ads Script](https://itallstartedwithaidea.com/budget-projection-performance-ads-script/): Google Ads scripting for budgets.
- [MarketingDashboard: A Powerful Tool for Optimizing Advertising Campaigns](https://itallstartedwithaidea.com/marketingdashboard-a-powerful-tool-for-optimizing-advertising-campaigns/): Dashboard tool guide.
- [Navigating Digital Marketing in 2025](https://itallstartedwithaidea.com/navigating-digital-marketing-in-2025/): Industry navigation guide.
- [Have You Struggled with Broad Match on Google Ads?](https://itallstartedwithaidea.com/have-you-struggled-with-broad-match-on-google-ads/): Broad match optimization.
- [I Analyzed 1,000 Online Stores](https://itallstartedwithaidea.com/i-analyzed-1000-online-stores/): E-commerce analysis.
- [Are You Measuring What Matters?](https://itallstartedwithaidea.com/are-you-measuring-what-matters/): Measurement framework.
- [29 Google Ads Automated Features and Practices to Approach with Caution](https://itallstartedwithaidea.com/29-google-ads-automated-features-and-practices-to-approach-with-caution/): Google Ads automation risks.

## LinkedIn Articles & Newsletters

- [LinkedIn Profile](https://www.linkedin.com/in/johnmichaelwilliams): John Williams — paid media, AI, and advertising.
- [LinkedIn Newsletter Activity](https://www.linkedin.com/in/johnmichaelwilliams/recent-activity/newsletter/): All published newsletters.
- [Mastering Google Ads and LinkedIn Ads](https://www.linkedin.com/pulse/mastering-google-ads-linkedin-john-williams--3umrc): Cross-platform advertising strategies.
- [Google Ads Campaign Management: From Single Sheet to Multi-Account Scaling](https://www.linkedin.com/pulse/google-ads-campaign-management-from-single-sheet-john-williams--gwcwc): LinkedIn version of scaling article.
- [Have You Struggled with Broad Match?](https://www.linkedin.com/pulse/have-you-struggled-broad-match-google-ads-heres-how-i-john-williams--i3owc): LinkedIn version of broad match strategy.
- [Navigating the Google Ad Representative](https://www.linkedin.com/pulse/navigating-google-ad-representative-john-williams--s5q1c): Working with Google reps.
- [Rethinking Ads & CPC Strategies in 2025](https://www.linkedin.com/pulse/rethinking-ads-cpc-strategies-2025-john-williams--ezupc): LinkedIn version of CPC strategy.
- [Google Ads Free Keywords — Official Guide](https://www.linkedin.com/pulse/google-ads-free-keywords-its-official-john-williams--4b2qc/): Keyword optimization strategies.
- [Open Source Announcement — Google Ads API Agent](https://www.linkedin.com/posts/johnmichaelwilliams_today-im-releasing-something-ive-been-quietly-activity-7426835945859084289-kUf-): Launch announcement.

## Substack

- [John Williams on Substack](https://substack.com/@itallstartedwithaidea): 15K+ subscribers. Paid media, AI, and marketing automation.
- [John's Substack Newsletter](https://itallstartedwithaidea.substack.com): Newsletter on advertising technology and strategy.

## Social & Community

- [X / Twitter](https://x.com/_johnmwilliams): @_johnmwilliams — paid media commentary.
- [Instagram](https://www.instagram.com/_johnmwilliams/): @_johnmwilliams — marketing and advertising.
- [Reddit: r/allthingsadvertising](https://www.reddit.com/r/allthingsadvertising/): Community subreddit on advertising.
- [Reddit: MCP Server + Google Ads + Meta Ads with AI](https://www.reddit.com/r/PPC/comments/1r30hsz/mcp_server_google_ads_meta_ads_with_ai/): Discussion on AI-powered ads management.
- [Reddit: After Years in Ads — Intent-to-API](https://www.reddit.com/r/googleads/comments/1r3q6r2/after_years_in_ads_i_think_the_future_isnt/): Post on the future of ads management.

## Featured & Press

- [Feedonomics: Tips to Improve Google Ads Performance](https://feedonomics.com/digital-marketing-tips-from-the-pros/tips-to-help-improve-your-google-ads-performance-part-2/): Featured expert tips.
- [Hero Conf 2025 — San Diego (Speaking)](https://paidsearch.org/event/hero-conf-2025-san-diego/): Conference talk on AI in advertising.

## Free Resources on itallstartedwithaidea.com

- [Paid Search Strategy](https://itallstartedwithaidea.com/paid-search/): Paid search playbook.
- [Display Ads](https://itallstartedwithaidea.com/display-ads/): Display advertising guide.
- [Social Ads](https://itallstartedwithaidea.com/social-ads/): Social advertising guide.
- [Video Ads](https://itallstartedwithaidea.com/video-ads/): Video advertising guide.
- [Top PPC Questions](https://itallstartedwithaidea.com/top-ppc-questions/): Common PPC questions answered.
- [AI Discovery Workspace for Digital Marketing](https://itallstartedwithaidea.com/ai-discovery-workspace-for-digital-marketing/): AI workspace tool.
- [GPT Ad Generator](https://itallstartedwithaidea.com/gpt-ad-generator/): GPT-powered ad copy tool.
- [Digital Marketing Services](https://itallstartedwithaidea.com/digital-marketing-services/): Consulting services overview.
- [Audit Details & NDA](https://itallstartedwithaidea.com/audit-details/): PPC audit information.

## Companion & Context Pages (Page Types B & C)

- **Page Type B — Local Guide**: `/services/{city}/{service}/local-guide/` — Local competitive intelligence with real agency data via SearchAPI, expert YouTube video embeds, Google Trends data, pricing analysis, and CTA forms. Available for all 1.97M service page combinations.
- **Page Type C — Community Insights**: `/services/{city}/{service}/community-insights/` — Community discussions from Reddit/Quora with expert commentary. Available for Tier 1-2 markets only (metro pop 100K+, ~800 markets).
- **SearchAPI Integration**: Google Maps, Google Trends, and YouTube data fetched and cached in KV with 30-day TTL. Fallback content when API data unavailable.
- **Three-Page Content Cluster**: Each service/city combination forms a cluster (Landing + Guide + Community) with cross-links for topical authority.
- **Full Schema Stack on Companion Pages**: Article, VideoObject, BreadcrumbList (5-level), Organization, Person, WebSite with SearchAction.

## SEO & Indexing Infrastructure

- **V2 Schema Stack**: Every page carries Organization, Person, WebSite (with SearchAction), BreadcrumbList, and page-type-specific schemas (ProfessionalService, Article, FAQPage, SoftwareApplication, VideoObject).
- **All Pages Indexed**: Zero noindex tags across 3.8M+ pages. robots meta: `index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1`.
- **IndexNow Integration**: `/api/indexnow` endpoint for batch URL submission to Bing, Yandex, Naver, and Seznam.
- **Caching**: stale-while-revalidate pattern on all edge-rendered pages for instant TTFB with background revalidation.
- **55+ Sitemaps**: Sitemap index with segmented child sitemaps for services, ecommerce, blog, and core pages.

## GitHub Repositories

- [google-ads-api-agent](https://github.com/itallstartedwithaidea/google-ads-api-agent): 28-action Google Ads AI agent. MIT.
- [googleadsagent-site](https://github.com/itallstartedwithaidea/googleadsagent-site): This website's source code.
- [google-ai-agent-audit-engine](https://github.com/itallstartedwithaidea/google-ai-agent-audit-engine): 250-point audit engine. MIT.
- [business-discovery-engine](https://github.com/itallstartedwithaidea/business-discovery-engine): Lead discovery engine. MIT.
- [argus](https://github.com/itallstartedwithaidea/argus): Algorithmic authenticity analysis platform. MIT.
- [itallstartedwithaidea](https://github.com/itallstartedwithaidea): Organization — Google Ads scripts, templates, and tools.