
Keyword Research
- 63 installs
- 31 repo stars
- Updated April 12, 2026
- itallstartedwithaidea/agent-skills
Structure Google Ads keyword universes, match types, and negatives so paid campaigns cover intent without bleeding budget on irrelevant queries.
About
Keyword Research is an Agent Skills package skill from the googleadsagent.ai lineage that teaches agents a repeatable Google Ads keyword workflow. Starting from seed terms, it expands coverage through semantic variants, competitor keyword mining, search term report analysis, long-tail discovery, and intent-based grouping so campaigns map to how buyers actually search. Match type selection is treated as economics: each keyword is weighed against conversion likelihood, volume, competition, and CPC before recommending broad, phrase, or exact match, including when to lean on smart bidding with broad match. Negative keyword management mirrors the expansion work—irrelevant queries from STRs become structured negatives at account, campaign, and ad-group tiers. Solo and indie builders shipping products with limited ad budgets use it when they need agent-guided rigor instead of dumping everything into one match type or skipping negatives until spend balloons.
- Builds keyword universes from seeds via five expansion vectors: semantic variations, competitor mining, search term repo
- Recommends broad, phrase, and exact match types from conversion probability, volume, competition, and CPC economics
- Pairs broad match with smart bidding guidance and refines match types from search term report feedback loops
- Mines search term reports for irrelevant queries and builds hierarchical negative lists at account, campaign, and ad-gro
- Optimizes for relevant coverage while minimizing wasted spend on low-intent traffic
Keyword Research by the numbers
- 63 all-time installs (skills.sh)
- +5 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #1,253 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/itallstartedwithaidea/agent-skills --skill keyword-researchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 63 |
|---|---|
| repo stars | ★ 31 |
| Security audit | 2 / 3 scanners passed |
| Last updated | April 12, 2026 |
| Repository | itallstartedwithaidea/agent-skills ↗ |
What it does
Structure Google Ads keyword universes, match types, and negatives so paid campaigns cover intent without bleeding budget on irrelevant queries.
Files
Keyword Research
Part of Agent Skills™ by googleadsagent.ai™
Description
The Keyword Research skill delivers a systematic approach to keyword discovery, expansion, and optimization for Google Ads campaigns. Starting from seed keywords, it builds comprehensive keyword universes through multiple expansion vectors: semantic variations, competitor keyword mining, search term report analysis, long-tail discovery, and intent-based grouping. The result is a structured keyword strategy that maximizes relevant coverage while minimizing wasted spend.
Match type selection is a critical component. The skill evaluates each keyword against conversion probability, search volume, competition intensity, and cost-per-click economics to recommend the optimal match type. Broad match keywords are paired with smart bidding strategies, phrase match captures high-intent variations, and exact match locks in proven converters. The skill continuously refines match type assignments based on search term report feedback loops.
Negative keyword management is equally important. The skill mines search term reports for irrelevant queries, builds hierarchical negative keyword lists (account-level, campaign-level, ad-group-level), and maintains shared negative keyword lists across campaigns. Proactive negative keyword discovery prevents budget waste before it occurs by identifying common irrelevant query patterns for each industry vertical.
Use When
- User asks for "keyword research" or "keyword ideas"
- User wants to "expand keywords" or "find new keywords"
- User mentions "negative keywords" or "search term mining"
- User asks about "match types" (broad, phrase, exact)
- User wants to "reduce wasted spend" on irrelevant queries
- User asks to "build a keyword list" or "keyword strategy"
- User mentions "keyword grouping" or "ad group structure"
- User wants "long-tail keywords" or "low competition keywords"
- User asks to "analyze search terms" or "query mining"
Architecture
flowchart TD
A[Seed Keywords] --> B[Expansion Engine]
B --> C[Semantic Expansion]
B --> D[Competitor Mining]
B --> E[Search Term Report]
B --> F[Long-Tail Discovery]
B --> G[Question Queries]
C --> H[Raw Keyword Universe]
D --> H
E --> H
F --> H
G --> H
H --> I[Deduplication & Normalization]
I --> J[Intent Classification]
J --> K[Informational]
J --> L[Commercial]
J --> M[Transactional]
J --> N[Navigational]
L --> O[Match Type Assignment]
M --> O
N --> O
K --> P[Negative Keyword Candidates]
O --> Q[Keyword Grouping Engine]
Q --> R[Themed Ad Groups]
P --> S[Negative Keyword Lists]
S --> T[Account-Level Negatives]
S --> U[Campaign-Level Negatives]
S --> V[Ad Group-Level Negatives]
R --> W[Final Keyword Strategy]
T --> W
U --> W
V --> WImplementation
Keyword expansion and match type assignment engine:
const MATCH_TYPES = {
BROAD: 'BROAD',
PHRASE: 'PHRASE',
EXACT: 'EXACT'
};
const INTENT_CATEGORIES = ['informational', 'commercial', 'transactional', 'navigational'];
async function expandKeywords(seedKeywords, config) {
const { customerId, industry, maxKeywords = 500 } = config;
const expansionResults = await Promise.all([
semanticExpansion(seedKeywords),
competitorKeywordMining(seedKeywords, industry),
searchTermReportMining(customerId),
longTailDiscovery(seedKeywords),
questionQueryExpansion(seedKeywords)
]);
const rawKeywords = deduplicateAndNormalize(expansionResults.flat());
const classifiedKeywords = rawKeywords.map(kw => ({
...kw,
intent: classifyIntent(kw.text),
suggestedMatchType: assignMatchType(kw)
}));
return classifiedKeywords.slice(0, maxKeywords);
}
function assignMatchType(keyword) {
if (keyword.conversionRate > 0.05 && keyword.volume < 1000) {
return MATCH_TYPES.EXACT;
}
if (keyword.intent === 'transactional' && keyword.wordCount >= 3) {
return MATCH_TYPES.PHRASE;
}
if (keyword.volume > 5000 && keyword.competitorPresence) {
return MATCH_TYPES.BROAD;
}
return MATCH_TYPES.PHRASE;
}
function classifyIntent(keywordText) {
const transactionalSignals = ['buy', 'order', 'purchase', 'price', 'cost', 'cheap', 'deal', 'discount', 'coupon', 'hire', 'book'];
const commercialSignals = ['best', 'top', 'review', 'compare', 'vs', 'alternative', 'recommended'];
const informationalSignals = ['how', 'what', 'why', 'when', 'guide', 'tutorial', 'tips'];
const text = keywordText.toLowerCase();
if (transactionalSignals.some(s => text.includes(s))) return 'transactional';
if (commercialSignals.some(s => text.includes(s))) return 'commercial';
if (informationalSignals.some(s => text.includes(s))) return 'informational';
return 'commercial';
}Negative keyword mining and list management:
async function mineNegativeKeywords(customerId, lookbackDays = 30) {
const searchTerms = await getSearchTermReport(customerId, lookbackDays);
const negatives = searchTerms.filter(term => {
const hasClicks = term.clicks > 0;
const noConversions = term.conversions === 0;
const highSpend = term.costMicros > 5000000;
const lowCTR = term.ctr < 0.01;
const irrelevantIntent = term.classifiedIntent === 'informational';
return hasClicks && noConversions && (highSpend || lowCTR || irrelevantIntent);
});
return categorizeNegatives(negatives);
}
function buildNegativeKeywordLists(negatives) {
return {
accountLevel: negatives.filter(n => n.universallyIrrelevant),
campaignLevel: groupBy(negatives.filter(n => n.campaignSpecific), 'campaignId'),
adGroupLevel: groupBy(negatives.filter(n => n.adGroupSpecific), 'adGroupId'),
sharedLists: buildSharedLists(negatives)
};
}
function groupKeywordsIntoAdGroups(keywords, maxPerGroup = 20) {
const groups = [];
const themes = extractThemes(keywords);
for (const theme of themes) {
const themeKeywords = keywords.filter(kw => kw.theme === theme.id);
if (themeKeywords.length <= maxPerGroup) {
groups.push({ theme: theme.name, keywords: themeKeywords });
} else {
const subGroups = splitBySubTheme(themeKeywords, maxPerGroup);
groups.push(...subGroups);
}
}
return groups;
}Integration with Buddy™ Agent
The Keyword Research skill serves as the strategic foundation within Buddy™ Agent. When a user connects their account, Buddy™ immediately analyzes existing keyword coverage and identifies expansion opportunities. The skill runs continuously in the background, monitoring search term reports for emerging query patterns and new negative keyword candidates.
Buddy™ presents keyword recommendations through an interactive interface where users can approve, modify, or reject suggestions before they're applied. Approved keywords flow into the appropriate campaigns with match types and bids pre-configured based on predicted performance. Negative keywords are automatically categorized and applied at the correct level.
The skill cross-references with the Competitor Analysis skill to identify keyword gaps where competitors are capturing traffic the account is missing, and feeds into the Ad Copy Generation skill to ensure new keywords have corresponding ad copy.
Best Practices
1. Start with 5-10 core seed keywords that represent your highest-value products or services 2. Group keywords by intent and theme into tightly themed ad groups of 10-20 keywords 3. Use exact match for proven high-converting terms to maintain bid precision 4. Pair broad match exclusively with smart bidding strategies (Target CPA, Target ROAS) 5. Review search term reports weekly and add negatives before wasted spend accumulates 6. Build shared negative keyword lists for universally irrelevant terms (jobs, free, DIY) 7. Include long-tail keywords (3+ words) to capture specific, high-intent searches 8. Monitor keyword Quality Scores and pause keywords consistently scoring below 4 9. Use campaign-level negatives to prevent keyword cannibalization between campaigns 10. Re-run keyword expansion quarterly to capture seasonal and trending queries
Platform Compatibility
| Platform | Supported |
|---|---|
| Claude Code | ✅ |
| Cursor | ✅ |
| Codex | ✅ |
| Gemini | ✅ |
Related Skills
- Ad Copy Generation - New keywords require corresponding ad copy with keyword-ad alignment
- Competitor Analysis - Competitor keyword gaps reveal expansion opportunities
- Quality Score Optimization - Keyword Quality Scores guide match type and ad group restructuring decisions
- Knowledge Base Injection - Domain knowledge patterns power automated keyword intent classification
Keywords
keyword research, keyword expansion, negative keywords, match type optimization, broad match, phrase match, exact match, search term mining, keyword grouping, ad group structure, long-tail keywords, keyword intent, keyword strategy, google ads keywords, ppc keywords
---
© 2026 googleadsagent.ai™ | Agent Skills™ | MIT License
Related skills
FAQ
Is Keyword Research safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.