@hienlh/ppm 0.9.80 → 0.9.81

package/.opencode/skills/seo/references/keyword-clustering-methodology.md

@@ -0,0 +1,175 @@
+# Keyword Clustering Methodology
+
+## Overview
+
+Keyword clustering groups related keywords into thematic clusters to build comprehensive content strategies and establish topical authority.
+
+## Clustering Approaches
+
+### 1. Topic Clustering
+- Group keywords by overarching topic/theme
+- Identify semantic relationships
+- Map to content structure
+- Create pillar-cluster hierarchy
+
+### 2. Intent-Based Grouping
+
+**Informational Intent**
+- How-to, guide, tutorial queries
+- "What is", "how to", "guide to"
+- Target: Educational content, blog posts
+- Example: "how to optimize images for web"
+
+**Navigational Intent**
+- Brand/product seeking queries
+- Company names, product names
+- Target: Landing pages, product pages
+- Example: "semrush pricing", "ahrefs login"
+
+**Transactional Intent**
+- Purchase-ready queries
+- "Buy", "discount", "coupon", "deal"
+- Target: Product pages, checkout flows
+- Example: "buy seo tools", "best seo software discount"
+
+**Commercial Intent**
+- Research before purchase
+- "Best", "top", "review", "vs"
+- Target: Comparison pages, reviews
+- Example: "best keyword research tool", "semrush vs ahrefs"
+
+### 3. Parent Topic Identification
+
+```
+Parent Topic: SEO Tools
+├── Keyword Research Tools (sub-topic)
+├── Backlink Analysis Tools (sub-topic)
+├── Rank Tracking Tools (sub-topic)
+└── Technical SEO Tools (sub-topic)
+```
+
+**Process:**
+1. Extract head terms (1-2 word core topics)
+2. Group long-tail variations under head terms
+3. Identify parent-child relationships
+4. Map difficulty and volume at each level
+
+## Cluster Hierarchy Structure
+
+### Three-Tier Model
+
+**Tier 1: Pillar Page (Hub)**
+- Broad topic coverage (2000-4000 words)
+- High search volume head term
+- Links to all cluster pages
+- Example: "Complete Guide to SEO"
+
+**Tier 2: Cluster Pages (Spokes)**
+- Sub-topic deep dives (1500-2500 words)
+- Medium volume keywords
+- Links back to pillar and between clusters
+- Example: "Technical SEO Guide", "On-Page SEO Guide"
+
+**Tier 3: Supporting Content**
+- Specific long-tail topics (800-1500 words)
+- Lower volume, high intent keywords
+- Links to cluster page and pillar
+- Example: "How to Fix Crawl Errors", "Image Optimization Best Practices"
+
+## Clustering Process
+
+### Step 1: Keyword Collection
+- Export keyword list (min 200-500 keywords)
+- Include: keyword, volume, difficulty, intent
+
+### Step 2: Initial Grouping
+- Sort by semantic similarity
+- Use n-gram analysis for common phrases
+- Group synonyms and variations
+
+### Step 3: Intent Mapping
+- Tag each keyword with intent type
+- Separate informational vs commercial
+- Identify content format match
+
+### Step 4: Cluster Assignment
+- Create 5-15 main clusters
+- 10-50 keywords per cluster
+- Name cluster with primary keyword
+
+### Step 5: Hierarchy Building
+- Identify pillar topics (1-3 pillars)
+- Assign clusters to pillars
+- Map supporting content
+
+## Tools & Automation
+
+### Manual Methods
+- Spreadsheet pivot tables
+- Conditional formatting for grouping
+- Manual tagging and categorization
+
+### Semi-Automated
+- Keyword clustering tools (SEMrush, Ahrefs)
+- SERP similarity analysis
+- Google Keyword Planner grouping
+
+### Fully Automated
+- Python clustering scripts (K-means, DBSCAN)
+- NLP-based semantic analysis
+- Machine learning topic modeling
+
+## Example Cluster Structure
+
+```
+Pillar: Email Marketing Guide (vol: 12,000)
+│
+├── Cluster 1: Email List Building (vol: 3,200)
+│   ├── "how to build email list" (vol: 880)
+│   ├── "email lead magnet ideas" (vol: 320)
+│   ├── "email signup form best practices" (vol: 210)
+│   └── "grow email subscribers fast" (vol: 180)
+│
+├── Cluster 2: Email Copywriting (vol: 2,800)
+│   ├── "email subject line formulas" (vol: 590)
+│   ├── "how to write marketing emails" (vol: 480)
+│   ├── "email call to action examples" (vol: 320)
+│   └── "email personalization tips" (vol: 290)
+│
+└── Cluster 3: Email Analytics (vol: 1,900)
+    ├── "email open rate benchmarks" (vol: 720)
+    ├── "improve email deliverability" (vol: 410)
+    ├── "email click through rate" (vol: 380)
+    └── "email conversion tracking" (vol: 190)
+```
+
+## Cluster Quality Metrics
+
+**Cohesion Score**
+- Semantic similarity within cluster
+- Target: >70% keyword overlap in SERP results
+
+**Volume Concentration**
+- Total search volume in cluster
+- Target: 1,000-10,000 monthly searches
+
+**Intent Alignment**
+- % keywords with same intent
+- Target: >80% same intent type
+
+**Content Opportunity**
+- Gap between cluster coverage and competition
+- Score: (Your coverage - Competitor avg) / Competitor max
+
+## Best Practices
+
+1. Start with 200+ seed keywords minimum
+2. Use SERP analysis to validate clusters
+3. Review top 10 results for overlap
+4. Update clusters quarterly
+5. Track cluster rankings over time
+6. Link strategically between cluster content
+7. Monitor cannibalization between cluster pages
+8. Prioritize commercial intent for revenue goals
+9. Build informational content for top-of-funnel
+10. Create conversion paths between clusters

package/.opencode/skills/seo/references/keyword-research-workflow.md

@@ -0,0 +1,63 @@
+# Keyword Research Workflow (ReviewWeb.site API)
+
+## Prerequisites
+Set `REVIEWWEB_API_KEY` in `.env` (copy from `.env.example`)
+
+## Workflow A: Seed Keyword Research
+
+```bash
+# Get keyword ideas + difficulty for a topic
+node scripts/analyze-keywords.cjs -k "your topic" -c us -o report.md
+```
+
+**Output includes:** keyword ideas, search volume, difficulty, CPC, intent, priority
+
+## Workflow B: Competitor Analysis
+
+```bash
+# Analyze competitor's traffic, keywords, backlinks
+node scripts/analyze-keywords.cjs -d "competitor.com" -o competitor.md
+```
+
+**Output includes:** organic traffic, top pages, top keywords, backlink profile
+
+## Workflow C: Batch Analysis
+
+```bash
+# Analyze multiple keywords from JSON file
+echo '["keyword1", "keyword2"]' > keywords.json
+node scripts/analyze-keywords.cjs -f keywords.json --format json -o results.json
+```
+
+## Priority Classification
+
+| Priority | Criteria | Action |
+|----------|----------|--------|
+| 1 (Quick Win) | Vol >500, Diff <40 | Target immediately |
+| 2 (Medium) | Vol >100, Diff <50 | Short-term target |
+| 3 (Long-term) | Diff <70 | Build authority first |
+| 4 (Skip) | Diff >70 | Too competitive |
+
+## Intent → Content Type
+
+| Intent | Signals | Content |
+|--------|---------|---------|
+| Informational | how, what, guide | Blog/Guide |
+| Commercial | best, review, vs | Comparison |
+| Transactional | buy, price | Landing/Product |
+| Navigational | brand terms | Homepage |
+
+## Output Format
+
+Script generates markdown report with:
+- Summary (total keywords, quick wins count)
+- Quick wins table (high priority keywords)
+- Full keyword table (sorted by priority)
+- For domains: traffic overview, top pages, backlinks
+
+## API Endpoints Used
+
+- `/seo-insights/keyword-ideas` - expand seed keywords
+- `/seo-insights/keyword-difficulty` - volume, difficulty, CPC
+- `/seo-insights/traffic` - domain traffic analysis
+- `/seo-insights/backlinks` - backlink profile

package/.opencode/skills/seo/references/keywords.md

@@ -0,0 +1,131 @@
+Conduct keyword research for a topic or niche.
+
+<topic>$ARGUMENTS</topic>
+
+## Workflow
+
+1. **Understand Intent**
+   - Parse topic from `$ARGUMENTS`
+   - Determine search intent (informational/transactional/navigational)
+
+2. **Research Keywords via ReviewWeb API**
+   - **Keyword Ideas**: `POST /seo-insights/keyword-ideas` with topic
+   - **Keyword Difficulty**: `POST /seo-insights/keyword-difficulty` for top keywords
+   - Use `attraction-specialist` agent for expanded discovery
+   - Use `WebSearch` for competitive analysis
+   - Activate `seo` skill for keyword clustering
+
+3. **Analysis**
+   - Primary keywords (high volume, relevant)
+   - Long-tail variations
+   - Question-based keywords
+   - Related topics
+   - Competitor keywords
+   - Difficulty scores from API
+
+4. **Output Strategy**
+   - Keyword clusters by intent
+   - Content recommendations
+   - Priority ranking
+   - Output to `assets/seo/keywords/`
+
+## API Reference
+
+Uses ReviewWeb SEO Insights API:
+- Skill: `seo/references/reviewweb-api.md`
+- Endpoints: `/seo-insights/keyword-ideas`, `/seo-insights/keyword-difficulty`
+- Auth: `$REVIEWWEB_API_KEY` via X-API-Key header
+
+## Agents Used
+- `attraction-specialist` - Keyword discovery
+- `seo-specialist` - Keyword analysis
+
+## Skills Used
+- `seo` - Keyword research frameworks, ReviewWeb API
+- `assets-organizing` - Standardized output paths
+
+## Output Requirements
+
+1. **Minimum 20 keywords** across all clusters
+2. **Difficulty scores** for top 10 primary keywords (via API)
+3. **Intent classification** for each keyword cluster
+4. **Priority ranking** (High/Medium/Low) based on:
+   - Search volume potential
+   - Difficulty score (lower = higher priority)
+   - Relevance to topic
+5. **Content recommendations** per cluster
+
+## Output Template
+
+```markdown
+# Keyword Research: {topic}
+
+**Date**: {YYYY-MM-DD}
+**Topic**: {topic}
+**Search Intent**: {primary intent}
+
+## Executive Summary
+
+{2-3 sentence overview of findings}
+
+## Primary Keywords
+
+| Keyword | Difficulty | Volume Est. | Intent | Priority |
+|---------|------------|-------------|--------|----------|
+| {kw}    | {0-100}    | {High/Med/Low} | {I/T/N} | {H/M/L} |
+
+## Keyword Clusters
+
+### Cluster 1: {Theme}
+**Intent**: {Informational/Transactional/Navigational}
+**Priority**: {High/Medium/Low}
+
+- {keyword 1}
+- {keyword 2}
+- {keyword 3}
+
+**Content Recommendation**: {suggested content type/angle}
+
+### Cluster 2: {Theme}
+...
+
+## Long-tail Keywords
+
+| Long-tail Keyword | Parent Keyword | Intent |
+|-------------------|----------------|--------|
+| {long-tail kw}    | {parent}       | {I/T/N} |
+
+## Question Keywords
+
+- {question keyword 1}
+- {question keyword 2}
+
+## Competitor Keywords
+
+| Competitor | Key Terms | Gap Opportunity |
+|------------|-----------|-----------------|
+| {domain}   | {terms}   | {opportunity}   |
+
+## Recommendations
+
+1. **Quick Wins**: {low difficulty, high relevance keywords}
+2. **Strategic Targets**: {medium difficulty, high value}
+3. **Long-term Goals**: {high difficulty, brand-building}
+
+## Next Steps
+
+- [ ] Create content calendar for top clusters
+- [ ] Prioritize quick-win keywords
+- [ ] Monitor competitor movements
+```
+
+## Output Path
+
+`assets/seo/keywords/{date}-{topic-slug}-keywords.md`
+
+## Examples
+```
+/seo:keywords "AI writing tools"
+/seo:keywords "project management software"
+/seo:keywords "sustainable fashion"
+```

package/.opencode/skills/seo/references/link-building-campaign-framework.md

@@ -0,0 +1,246 @@
+# Link Building Campaign Framework
+
+## Campaign Types
+
+### 1. Guest Post Outreach
+**Best For**: Building authority, brand awareness
+**Target DA**: 40+
+**Success Rate**: 10-15%
+**Timeline**: 2-4 weeks per placement
+
+**Process**:
+1. Identify blogs accepting guest posts
+2. Analyze content quality and audience
+3. Pitch relevant topic ideas
+4. Write high-quality content (1500+ words)
+5. Include contextual link (1-2 per post)
+
+### 2. Resource Page Link Building
+**Best For**: Quick wins, educational content
+**Target DA**: 30+
+**Success Rate**: 15-20%
+**Timeline**: 1-2 weeks
+
+**Process**:
+1. Find resource pages (search: "intitle:resources" + keyword)
+2. Create valuable resource (tool, guide, infographic)
+3. Pitch addition to existing lists
+4. Highlight unique value proposition
+
+### 3. Broken Link Building
+**Best For**: Replacing dead competitor links
+**Target DA**: 35+
+**Success Rate**: 20-30%
+**Timeline**: 2-3 weeks
+
+**Process**:
+1. Find broken links on target sites (Check My Links extension)
+2. Create replacement content
+3. Notify site owner of broken link
+4. Suggest your content as replacement
+
+### 4. HARO (Help A Reporter Out)
+**Best For**: High-authority press links
+**Target DA**: 60+
+**Success Rate**: 5-10%
+**Timeline**: Ongoing daily
+
+**Process**:
+1. Subscribe to HARO emails (3x daily)
+2. Respond to relevant queries within 2 hours
+3. Provide expert quotes with credentials
+4. Follow up if featured
+
+### 5. Digital PR
+**Best For**: Brand mentions, high-DA links
+**Target DA**: 70+
+**Success Rate**: 5-8%
+**Timeline**: 4-8 weeks
+
+**Process**:
+1. Create newsworthy content (data study, survey, report)
+2. Build journalist outreach list
+3. Craft press release
+4. Pitch to relevant journalists
+5. Follow up strategically
+
+### 6. Niche Directory Submissions
+**Best For**: Local SEO, niche authority
+**Target DA**: 25+
+**Success Rate**: 80-90%
+**Timeline**: 1 week
+
+**Process**:
+1. Identify quality directories (not spam farms)
+2. Submit accurate business info
+3. Track submission status
+4. Monitor for approval
+
+## Target Selection Criteria
+
+### Domain Metrics
+- **Minimum DA/DR**: 30 (adjust by campaign type)
+- **Organic Traffic**: 5k+/month
+- **Spam Score**: <30%
+- **Active Content**: Published within 30 days
+
+### Relevance Criteria
+- **Topical Alignment**: Same/adjacent niche
+- **Audience Overlap**: Target demographics match
+- **Content Quality**: Well-written, valuable
+- **Engagement**: Comments, shares, backlinks
+
+### Link Opportunity Signals
+- "Write for us" page exists
+- Resource/links page exists
+- Competitor backlinks present
+- Active blog with guest authors
+- Contact info easily accessible
+
+## Outreach Workflow
+
+### Phase 1: Research (Week 1)
+- Identify 100 target prospects
+- Score by DA, relevance, opportunity
+- Export to outreach spreadsheet
+- Find decision maker contact info
+
+### Phase 2: Initial Outreach (Week 2)
+- Send personalized emails (20-30/day)
+- A/B test subject lines
+- Track open/response rates
+- Log all communications
+
+### Phase 3: Follow-Up (Week 3-4)
+- First follow-up: 3 days after initial
+- Second follow-up: 7 days after first
+- Final follow-up: 14 days after second
+- Mark unresponsive as "dead"
+
+### Phase 4: Execution (Week 5-8)
+- Fulfill content requirements
+- Submit for review
+- Make revisions if needed
+- Confirm publication + link
+
+### Phase 5: Tracking (Ongoing)
+- Monitor link status monthly
+- Track referral traffic
+- Measure ranking impact
+- Build relationship for future opportunities
+
+## Follow-Up Sequences
+
+### Guest Post Sequence
+**Email 1 (Day 0)**: Personalized pitch with topic ideas
+**Email 2 (Day 3)**: "Just checking in" + additional value
+**Email 3 (Day 10)**: Alternative angle/topic offer
+**Email 4 (Day 21)**: Final attempt with social proof
+
+### Resource Link Sequence
+**Email 1 (Day 0)**: Notify of resource + value prop
+**Email 2 (Day 5)**: Brief reminder with quick link
+**Email 3 (Day 14)**: Final gentle nudge
+
+### Broken Link Sequence
+**Email 1 (Day 0)**: Helpful broken link notification
+**Email 2 (Day 4)**: Offer replacement content
+**Email 3 (Day 12)**: Last follow-up
+
+## Success Metrics
+
+### Campaign KPIs
+- **Response Rate**: Target 30%+
+- **Conversion Rate**: Target 10%+ (link secured)
+- **Average DA**: Target 40+
+- **DoFollow Ratio**: Target 70%+
+- **Time to Link**: Target <30 days
+
+### ROI Metrics
+- **Cost per Link**: Track time/money invested
+- **Link Value**: DA × Relevance × Placement score
+- **Ranking Impact**: Target keyword position changes
+- **Referral Traffic**: Clicks from acquired links
+- **Domain Authority Growth**: Monthly DR/DA tracking
+
+### Quality Metrics
+- **Link Retention**: >95% after 6 months
+- **Toxic Score**: <5% of acquired links
+- **Editorial Ratio**: 80%+ editorial (not footer/sidebar)
+- **Anchor Text Diversity**: <10% exact match
+
+## Campaign Planning Template
+
+```markdown
+# Link Building Campaign Plan
+
+## Campaign Details
+- **Type**: [Guest Post / Resource / Broken Link / HARO / Digital PR]
+- **Start Date**: [YYYY-MM-DD]
+- **Duration**: [weeks]
+- **Target Links**: [count]
+- **Budget**: [$amount or hours]
+
+## Target Criteria
+- **Minimum DA**: [score]
+- **Niche**: [specific topics]
+- **Geographic**: [any/specific]
+- **Language**: [any/specific]
+
+## Prospect List
+- **Total Prospects**: [count]
+- **Tier 1 (DA 60+)**: [count]
+- **Tier 2 (DA 40-59)**: [count]
+- **Tier 3 (DA 30-39)**: [count]
+
+## Outreach Strategy
+- **Daily Volume**: [emails/day]
+- **Template**: [reference template name]
+- **Personalization**: [fields to customize]
+- **Follow-up**: [sequence timing]
+
+## Content Requirements
+- **Topics**: [list 3-5 topic ideas]
+- **Word Count**: [target]
+- **Assets**: [images, data, infographics needed]
+
+## Success Targets
+- **Response Rate**: [%]
+- **Conversion Rate**: [%]
+- **Average DA**: [score]
+- **Total Links**: [count]
+
+## Weekly Tracking
+| Week | Sent | Opened | Replied | Links Secured | Avg DA |
+|------|------|--------|---------|---------------|--------|
+| 1    |      |        |         |               |        |
+| 2    |      |        |         |               |        |
+| 3    |      |        |         |               |        |
+| 4    |      |        |         |               |        |
+
+## Notes
+[Campaign-specific notes, learnings, optimizations]
+```
+
+## Campaign Optimization
+
+### A/B Testing Elements
+- Subject lines (test 2-3 variants)
+- Email length (short vs detailed)
+- Call-to-action wording
+- Personalization depth
+- Send day/time
+
+### Performance Analysis
+- Track response rates by template
+- Identify high-converting topics
+- Monitor DA correlation with success
+- Analyze follow-up effectiveness
+- Measure seasonal trends
+
+### Continuous Improvement
+- Update templates based on data
+- Refine targeting criteria
+- Adjust outreach volume
+- Optimize follow-up timing
+- Build relationship database