indranilbanerjee/keyword-research

/digital-marketing-pro:keyword-research

Purpose

Standalone keyword research and clustering tool. Produces a prioritized keyword list with estimated search volume, keyword difficulty, search intent classification, and content recommendations mapped to each cluster.

Input Required

The user must provide (or will be prompted for):

• Seed keywords or topic: Starting keywords, a topic area, or a URL to extract keyword themes from
• Target audience: Who the content is intended to reach (demographics, expertise level, pain points)
• Industry: The vertical or niche to contextualize volume and difficulty estimates
• Competitor domains: Optional -- 1-3 competitor domains to run content gap analysis against
• Target market/language: Geographic and language targeting for volume estimates
• Content goals: Traffic, leads, thought leadership, product sales, or brand awareness
• Existing content inventory: Optional -- URLs or topics already published to avoid duplication

Process

1. Load brand context: Read ~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply voice, compliance, industry context. Check guidelines/_manifest.json for restrictions, messaging, channel styles, voice-and-tone rules, and templates. If a template matching this command exists in ~/.claude-marketing/brands/{slug}/templates/, apply its format. If no brand exists, prompt for /digital-marketing-pro:brand-setup or proceed with defaults.
2. Check campaign history: Run python campaign-tracker.py --brand {slug} --action list-campaigns to identify previous keyword research and content campaigns to build upon rather than duplicate.
3. Load reference files: Consult skills/content-engine/ for content strategy context and skills/context-engine/industry-profiles.md for industry-specific keyword benchmarks and search behavior patterns.
4. Run keyword clustering: Execute scripts/keyword-clusterer.py with seed keywords to generate an expanded keyword list with volume estimates, difficulty scores, and trend signals.
5. Classify search intent: Categorize every keyword into intent buckets -- informational (how-to, what-is), navigational (brand, product names), commercial (best, reviews, comparison), and transactional (buy, pricing, demo, free trial).
6. Map keywords to content types: Assign each cluster a recommended content format -- blog post, landing page, pillar page, comparison page, FAQ, video, tool, or interactive content -- based on intent and SERP feature analysis.
7. Identify content gaps vs competitors: If competitor domains were provided, cross-reference their ranking keywords against the brand's current coverage to surface missed opportunities and underserved topics.
8. Discover long-tail opportunities: Expand each cluster with long-tail variants, question-based keywords (People Also Ask patterns), and related search modifiers that represent lower-difficulty entry points.
9. Assess SERP feature opportunities: For each primary keyword, identify which SERP features are present (featured snippets, People Also Ask, knowledge panels, image packs, video carousels) and note which are attainable.
10. Identify seasonal and trending opportunities: Flag keywords with notable seasonal patterns or rising search trends that present time-sensitive content opportunities requiring prioritized scheduling.
11. Prioritize by impact and difficulty: Score each keyword cluster on a composite priority metric weighing estimated volume, ranking difficulty, business relevance, conversion potential, and content gap opportunity.
12. Generate keyword strategy document: Compile the full analysis into a structured deliverable with clear next-step recommendations for content creation sequencing.

Output

A structured keyword strategy document containing:

• Keyword clusters organized by topic theme, each with individual keywords listed
• Estimated monthly search volume and keyword difficulty per keyword
• Search intent classification (informational, navigational, commercial, transactional) per keyword
• SERP feature opportunities per cluster (featured snippets, PAA, video, image pack)
• Recommended content type and format for each cluster
• Priority score (high/medium/low) with rationale for sequencing
• Content gap analysis showing competitor-owned keywords the brand is missing
• Long-tail keyword opportunities with lower difficulty and high relevance
• Question-based keyword list for FAQ and People Also Ask targeting
• Recommended content creation roadmap based on priority ranking
• Quick-win keywords (low difficulty, decent volume, high relevance) flagged for immediate action
• Seasonal or trending keyword opportunities with timing recommendations
• Internal linking opportunities between keyword clusters and existing content

Agents Used

• seo-specialist -- Keyword research, volume and difficulty estimation, SERP analysis, content gap identification, and priority scoring
• content-creator -- Content type mapping, content angle recommendations, and editorial planning for keyword-targeted pieces