keyword-research
Finds low-competition, high-intent keywords using Google Keyword Planner and adds them to campaigns. Use when asked to find keywords, expand campaigns, or improve PPC targeting.
70%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/keyword-research/SKILL.mdKeyword Research Skill
Discovers low-competition, high-intent keywords for your campaigns using Google Ads Keyword Planner, then adds them to the appropriate ad groups.
Capabilities
- Find keyword opportunities - Query Google Keyword Planner with seed keywords
- Score & filter keywords - Identify low-competition, high-value opportunities
- Add to campaigns - Automatically add keywords to relevant ad groups
- Competitive analysis - Analyze competitor domains for keyword gaps
Workflow
Step 1: Research Keywords
Run scripts/research-keywords.py with seed keywords:
python3 scripts/research-keywords.py \
--seeds "ppc management,google ads automation,facebook ads management" \
--max-competition 50 \
--min-volume 100 \
--max-cpc 25This outputs a ranked list of keyword opportunities.
Step 2: Add Keywords to Campaigns
Run scripts/add-keywords.py to add keywords:
python3 scripts/add-keywords.py \
--keywords "ppc management tools,marketing automation for agencies" \
--ad-group "Your Campaign - Ad Group 1" \
--match-type PHRASEStep 3: Create Keyword Report
Run scripts/keyword-report.py to see all keywords across campaigns:
python3 scripts/keyword-report.pyFiltering Criteria
Default filters for finding opportunities:
| Criteria | Default | Description |
|---|---|---|
| Competition Index | < 50% | Low competition keywords |
| Search Volume | > 100 | Enough traffic to be worthwhile |
| CPC Range | $1-25 | Valuable but not prohibitively expensive |
Keyword Categories
When adding keywords, map them to appropriate ad groups:
| Category | Target Ad Groups |
|---|---|
| PPC Tools | JTBD - PPC Audit, JTBD - Budget Optimizer |
| Automation | JTBD - Creative Generator, ProductHunt |
| Agency | JTBD - Website Analysis, Trial Campaign |
| Cross-Channel | ProductHunt, Trial Campaign |
| Competitors | JTBD - Optmyzr Alternative |
Match Types
- PHRASE (default): Best for new keywords, balances reach and relevance
- EXACT: Use for high-volume, proven keywords
- BROAD: Use sparingly, only for discovery with Smart Bidding
Best Practices
- Research first - Always run keyword research before adding
- Group by intent - Add keywords to ad groups with matching intent
- Start with PHRASE - Upgrade to EXACT after seeing performance
- Monitor quality score - New keywords should get 6+ quality score
- Check for conflicts - Don't add keywords that match negative keyword lists
Environment Requirements
Requires environment variables:
DATABASE_URLGOOGLE_ADS_DEVELOPER_TOKEN
Account IDs
- MCC Login Customer ID: 7431593382
About this skill
Part of the Synter free skills collection — open-source agent skills for advertising, PPC, and marketing automation.
Want this skill (and 40+ more) running on autopilot against your live ad accounts? Try Synter — AI Agent Media Buyers that connect to Google, Meta, LinkedIn, TikTok, Reddit, Amazon, and 7+ more platforms.
- 🌐 syntermedia.ai
- 📚 All free skills
- 💬 Built by @syntermedia — questions? Open an issue.
- Repository
Synter-Media-AI/free-skills
- Revision
3df48f1
- Last updated
- First committed
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.