skill
google-ads-research
A Claude Code skill for Google Ads keyword research and competitive analysis using DataForSEO
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/djforge/google-ads-research itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 23, 2026google-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/livekeywords_data/google_ads/keywords_for_keywords/livekeywords_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:
- Company name and website URL
- Product/service context (or it will fetch the URL and extract it automatically)
- Target geography — Canada, US, UK, etc.
- Target audience segments — RIAs, family offices, enterprise, SMB, etc.
- Competitors — names and websites, by region
- 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