← All agents

The Compliance Copywriter

Crawls your own website, drafts Google Ads copy, and checks every headline and description against Google's character limits before you ever paste it in.

What it does

The Compliance Copywriter is a set of Python scripts, wired up to Claude Code (or Cline) through a workflow file, that writes Google Ads copy for you and refuses to hand you anything that would get rejected. It crawls your actual website, works out what you sell, drafts headlines, descriptions and display paths, then runs every single one through Google's own character and count limits before you ever open the Google Ads dashboard.

The video's claim holds up in testing. Cloned fresh, the website crawler (fetch_website.py, built on the open source crawl4ai library) pulled real content off a live site with no API key at all, and the validator scripts genuinely catch a headline or description the moment it goes over Google's limit, flagging it and offering a shorter version.

One honest correction: the ad copy itself is written by whichever AI assistant is driving the scripts, not by the Python code on its own, so the "crawls and writes" claim depends on you having Claude Code or Cline installed. The repo's own workflow files only actually wire up those two, so stick with one of them.

Who it is for

Anyone running their own Google Ads, a business owner or marketer, who is tired of guessing at character limits, getting the ad bounced, and rewriting it two or three times before Google accepts it.

Before you start

• Claude Code or Cline already installed (this test used Claude Code; these are the only two the repo actually supports)
• Python 3 installed (the repo's README specifies 3.13.5; a standard python3 install works)
• git installed
• No AI API key needed for the core crawl-and-validate workflow
• Install took about 10 minutes in testing (virtual environment, two packages, one browser download)

Install

Step 1: Clone the repository and move into it

This downloads the scripts to your machine.

git clone https://github.com/romek-rozen/google-ads-generator-with-ai-assistants.git
cd google-ads-generator-with-ai-assistants

Step 2: Create a Python virtual environment and activate it

This keeps the project's two packages separate from anything else on your machine.

python3 -m venv venv
source venv/bin/activate

Step 3: Install the Python packages the scripts need

This installs the website crawler library and a small helper package.

pip install -r requirements.txt

Step 4: Install the browser the crawler uses in the background

This downloads Chromium so the crawler can load and read real web pages. It only needs to run once.

playwright install chromium

Step 5: Open the project folder in Claude Code

Claude Code (or Cline) reads the repo's own workflow file and drives the scripts for you, crawling your site and writing the ads, when you ask it to.

Run it

Sample input used in testing, a file at tmp/ads.json with headlines that run over Google's 30-character limit:

{
  "headlines": [
    "Free Shipping On All Orders Today",
    "Shop Our New Summer Collection Now",
    "Best Deals Guaranteed Every Day Here"
  ]
}

Run the validator:

python3 scripts/validate_google_ads.py

Real output (abbreviated):

📝 HEADLINES (3 items, max 30 characters):
 1. ❌ [33/30] "Free Shipping On All Orders Today"
    💡 Suggestion: "Free Shipping On All Orders"
 2. ❌ [34/30] "Shop Our New Summer Collection Now"
    💡 Suggestion: "Shop Our New Summer Collection"
 3. ❌ [36/30] "Best Deals Guaranteed Every Day Here"
    💡 Suggestion: "Best Deals Guaranteed Every"

⚠️ LENGTH ERRORS: Found 3 texts exceeding limits!
❌ VALIDATION FAILED - correct errors before generating report

That is the whole point: it catches the rejection before Google does, and hands you a corrected version instead.

Troubleshooting

The shortening suggestion comes back blank. If a single word alone is already longer than the character limit, the script has nothing to split on and suggest_shortening() returns an empty string instead of a shortened version. Fix: shorten or hyphenate that word yourself, then re-run the validator.

playwright install chromium seems stuck. It's downloading a real browser binary the first time, which can take a few minutes on a slow connection. Let it finish, it only runs once.

Nothing generates after validation. That's expected: generate_ads_txt.py refuses to build the final report until validate_google_ads.py passes cleanly (or you force it with -y). Fix the flagged headlines or descriptions and validate again first.

Credit

Built by Roman Rozenberger, romek-rozen on GitHub (https://github.com/romek-rozen/google-ads-generator-with-ai-assistants), MIT license, 8 stars at test time. One correction to claims made about the repo elsewhere: only Claude Code and Cline are actually supported.

Download the PDF version

This guide includes affiliate links for tools mentioned in the setup steps. If you sign up through them, I may earn a commission at no extra cost to you.