google-ads-research

A Claude Code skill that runs a full Google Ads keyword research and competitive analysis for a new client, powered by the DataForSEO API.

What it does

Give it a company name and it will walk you through a full paid search research workflow:

• Client intake — asks for website, product context, target geography, audience segments, and competitors
• Keyword research — pulls keywords for the client and every competitor domain via DataForSEO
• Keyword expansion — discovers related high-intent terms from top seed keywords
• Ad traffic forecasting — estimates impressions, clicks, CPC, and monthly cost
• Competitive analysis — identifies keyword overlap, competitor brand terms, and conquesting opportunities
• Campaign structure — organizes keywords into themed campaigns and ad groups
• Budget modeling — provides conservative, moderate, and aggressive spend scenarios with lead estimates
• Meeting prep — generates talking points, client questions, ROI scenarios, and retainer pricing suggestions
• Ad copy drafts — writes full RSA ads (15 headlines + 4 descriptions) for top ad groups

Prerequisites

You'll need a DataForSEO account. The skill uses the following API endpoints:

• keywords_data/google_ads/keywords_for_site/live
• keywords_data/google_ads/keywords_for_keywords/live
• keywords_data/google_ads/ad_traffic_by_keywords/live

Install

Clone the repo and copy the skill into your Claude Code skills directory:

Global install (available in all projects):

git clone https://github.com/djforge/google-ads-research.git
mkdir -p ~/.claude/skills/google-ads-research
cp google-ads-research/skills/google-ads-research/SKILL.md ~/.claude/skills/google-ads-research/SKILL.md

Per-project install (available only in a specific project):

git clone https://github.com/djforge/google-ads-research.git
mkdir -p .claude/skills/google-ads-research
cp google-ads-research/skills/google-ads-research/SKILL.md .claude/skills/google-ads-research/SKILL.md

After installing, restart Claude Code. The /google-ads-research command will be available.

Usage

/google-ads-research Acme Corp

Or just:

/google-ads-research

The skill will ask you for:

1. Company name and website URL
2. Product/service context (or it will fetch the URL and extract it automatically)
3. Target geography — Canada, US, UK, etc.
4. Target audience segments — RIAs, family offices, enterprise, SMB, etc.
5. Competitors — names and websites, by region
6. DataForSEO credentials — login email and API password

Output

Three markdown files saved to your working directory:

1. [ClientName]_Google_Ads_Recommendation.md

Section	What's included
Executive Summary	Key findings in 3-4 sentences
Competitive Landscape	Competitor keyword footprints and observations
Campaign Structure	Campaigns, ad groups, and keyword tables with volume/CPC/competition
Budget Recommendations	3 scenarios with estimated clicks, leads, and cost per lead
Negative Keywords	Organized by category to prevent wasted spend
Landing Page Recommendations	Based on current website analysis
Tracking Setup	Conversion tracking recommendations
Timeline	Phased launch plan

2. [ClientName]_Meeting_Prep.md

Section	What's included
The Pitch	2-minute overview bullet points
Key Numbers	Budget, CPC, clicks, lead estimates
Client Questions	Lead value, sales cycle, capacity, positioning
ROI Scenario	Fill-in formula using client's deal size
Retainer Recommendation	Flat monthly fee suggestion based on scope
Meeting Flow	Suggested agenda

3. [ClientName]_Ad_Copy_Drafts.md

Section	What's included
RSA Ads	15 headlines + 4 descriptions per ad, 2 ads per ad group
Coverage	Product, audience, and competitor conquesting ad groups
Best Practices	Differentiators, CTA hierarchy, pinning, A/B testing priorities

Supported Regions

The skill supports any region available in Google Ads. Common location codes:

Region	Code
Canada	2124
United States	2840
United Kingdom	2826
Australia	2036

Full list: DataForSEO Locations

License

MIT