content-seo-optimizer

内容 SEO 优化器

让更多人发现你的内容。 此技能会将你已发布的内容与 SERP 竞争对手进行对比审查，并生成按优先级排序的优化路线图。

---

何时使用

场景	使用此技能？
发布博客文章前	是 — 发布前进行优化
发布后流量较低	是 — 诊断并修复
优化 YouTube 视频	是 — 优化标题、说明和标签
新闻简报落地页	是 — 提高可发现性
学术／医疗内容	是 — 聚焦医疗关键词

---

工作原理

YOUR CONTENT URL
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ AGENT 1: PAGE AUDITOR                                        │
│                                                              │
│ • Scrapes your page (Firecrawl/WebFetch)                    │
│ • Extracts: title, meta, headings, word count, links        │
│ • Identifies: primary keyword, secondary keywords           │
│ • Flags: technical issues, content gaps                     │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ AGENT 2: SERP ANALYST                                        │
│                                                              │
│ • Searches Google/Perplexity for your primary keyword       │
│ • Analyzes top 10 competitors                               │
│ • Extracts: title patterns, content formats, themes         │
│ • Identifies: differentiation opportunities                 │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────────────────┐
│ AGENT 3: OPTIMIZATION ADVISOR                                │
│                                                              │
│ • Synthesizes audit + SERP data                             │
│ • Generates McKinsey-style recommendations                  │
│ • Prioritizes: P0 (critical), P1 (important), P2 (nice)     │
│ • Outputs: actionable report with expected impact           │
└─────────────────────────────────────────────────────────────┘
    │
    ▼
SEO AUDIT REPORT (Markdown)

---

用法

在 Claude Code 中（推荐）

Audit SEO for https://yoursite.com/article-about-statins

或

Use content-seo-optimizer for my blog post: [URL]

用于 YouTube 内容

Optimize SEO for my YouTube video: https://youtube.com/watch?v=xxxxx

Claude 将：

1. 获取视频页面
2. 分析标题、说明和标签
3. 调研竞争视频
4. 提出优化建议

CLI 模式

python skills/cardiology/content-seo-optimizer/scripts/seo_audit.py \
    --url "https://yoursite.com/article" \
    --keyword "statins cardiovascular risk"  # Optional override

---

输出：SEO 审查报告

# SEO Audit Report

**URL:** https://yoursite.com/statin-myths-debunked
**Audit Date:** 2026-01-01
**Primary Keyword:** statin myths

---

## Executive Summary

Your article targets "statin myths" with moderate optimization.
The title is strong but meta description is missing key terms.
Competitors are using listicle formats (5 myths, 7 facts) which
you should consider adopting. Word count (1,200) is below
competitor average (2,100).

**Overall Score:** 65/100
**Quick Wins Available:** 3 changes could boost score to 80+

---

## Technical & On-Page Findings

### Title Tag
**Current:** "Debunking Statin Myths - Dr. Singh"
**Length:** 38 characters (optimal: 50-60)
**Recommendation:** "7 Statin Myths Exposed: Cardiologist Reveals Truth [2026]"
**Rationale:** Add number, year, and authority signal

### Meta Description
**Current:** [MISSING]
**Recommendation:** "Interventional cardiologist debunks the 7 most
dangerous statin myths. Evidence-based analysis of side effects,
muscle pain, and who really needs statins."
**Length:** 158 characters (optimal)

### Heading Structure
- H1: ✅ Present ("Debunking Statin Myths")
- H2s: ⚠️ Only 2 (competitors average 7)
- H3s: ❌ None (add for each myth)

### Content Depth
- **Your word count:** 1,200
- **Competitor average:** 2,100
- **Gap:** 900 words
- **Recommendation:** Expand with clinical evidence, patient stories

### Link Profile
- Internal links: 3 (low - aim for 8-10)
- External links: 2 (good - both to journals)
- Suggested internal links:
  - Your article on LDL targets
  - Your cholesterol video
  - Your cardiovascular risk calculator

---

## Keyword Analysis

### Primary Keyword
**Target:** "statin myths"
**Search Volume:** ~2,400/month
**Competition:** Medium
**Your Current Ranking:** Not in top 100

### Secondary Keywords (add to content)
- statin side effects myths (1,200/mo)
- do statins cause muscle pain (800/mo)
- statin benefits vs risks (600/mo)
- should I take statins (1,500/mo)

### Search Intent
**Dominant:** Informational
**User Need:** Reassurance, evidence-based answers
**Content Angle:** Counter misinformation with authority

---

## Competitive SERP Analysis

### Top 5 Competitors

| Rank | Title | Word Count | Format |
|------|-------|------------|--------|
| 1 | "5 Statin Myths That Could Kill You" | 2,400 | Listicle |
| 2 | "The Truth About Statins: What You Need to Know" | 1,800 | Guide |
| 3 | "Statin Myths and Facts - Harvard Health" | 2,100 | FAQ |
| 4 | "7 Common Statin Myths Exposed" | 1,900 | Listicle |
| 5 | "Statins: Benefits, Risks, and Myths" | 2,500 | Comprehensive |

### Patterns in Top Results
- **Titles:** Numbers (5, 7), emotional words (truth, exposed, kill)
- **Formats:** Listicles dominate (4 of 5)
- **Authority:** Medical credentials mentioned (Harvard, MD)
- **Length:** All 1,800+ words

### People Also Ask
- Are statin side effects exaggerated?
- What are the real risks of statins?
- Do statins cause memory loss?
- Should everyone over 50 take statins?

### Your Differentiation Opportunity
- **Angle:** Active interventional cardiologist perspective
- **Unique:** Real cath lab stories, patient outcomes
- **Voice:** Hinglish content not available in English SERP

---

## Prioritized Recommendations

### P0 - Critical (Do This Week)

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Add meta description | Missing entirely - major SEO gap | High | Low |
| Restructure as listicle (7 myths) | Top 4 competitors use this format | High | Medium |
| Add year to title [2026] | Freshness signal, higher CTR | Medium | Low |

### P1 - Important (Do This Month)

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Expand to 2,000+ words | Below competitor average by 900 | High | Medium |
| Add FAQ schema | Capture People Also Ask | Medium | Low |
| Add 5+ internal links | Low link density hurting authority | Medium | Low |
| Include patient stories | Differentiation + engagement | Medium | Medium |

### P2 - Nice to Have

| Action | Rationale | Impact | Effort |
|--------|-----------|--------|--------|
| Add video embed | Mixed media boosts dwell time | Low | Low |
| Create infographic | Shareable, backlink potential | Medium | High |
| Hindi/Hinglish version | Capture India market gap | Medium | High |

---

## Next Steps

1. **Immediate:** Add meta description (5 minutes)
2. **This week:** Restructure as "7 Statin Myths" listicle
3. **This month:** Expand content with evidence + FAQ schema
4. **Measure:** Check ranking in 2-4 weeks
5. **Iterate:** Re-audit after changes

---

## Measurement Plan

| Metric | Current | Target | Timeline |
|--------|---------|--------|----------|
| Google ranking (primary KW) | 100+ | Top 20 | 4 weeks |
| Organic traffic | 0/month | 200/month | 8 weeks |
| CTR from search | N/A | 5%+ | 4 weeks |
| Avg. time on page | Unknown | 3+ min | 4 weeks |

---

医疗内容专属功能

预配置医疗关键词

此技能能够理解医疗／心脏病学领域的语境：

你的主题	建议关键词
他汀类药物	他汀类药物误区、他汀类药物副作用、降胆固醇药物
SGLT2	SGLT2 抑制剂、糖尿病心脏药物、Jardiance 的益处
心力衰竭	心力衰竭治疗、射血分数、HFpEF
CAC 评分	冠状动脉钙化评分、心脏扫描、心脏 CT
血压	高血压治疗、高血压药物

医疗权威信号

建议包括：

• 在标题／简介中添加 MD／心脏病专家资历
• 引用 PubMed 研究（附 PMID）
• 参考指南（ACC/AHA/ESC）
• 添加医疗 Schema 标记

---

与其他技能集成

发布前工作流

1. Write content with cardiology-newsletter-writer
2. Research with quick-topic-researcher (PMIDs)
3. Check with viral-content-predictor (engagement score)
4. Audit with content-seo-optimizer (SEO score)  ← This skill
5. Refine based on recommendations
6. Publish

发布后工作流

1. Publish content
2. Wait 2-4 weeks for indexing
3. Audit with content-seo-optimizer
4. Implement P0/P1 recommendations
5. Re-audit in 4 weeks

---

技术架构

使用的工具

工具	用途	备用方案
Firecrawl MCP	页面抓取	WebFetch
Perplexity MCP	SERP 调研	WebSearch
Claude	分析与报告	-

依赖项

# Optional - for CLI mode with Firecrawl
pip install firecrawl-py

# For Google ADK version (advanced)
pip install google-adk pydantic>=2.7.0

API 密钥

密钥	用途	是否必需？
FIRECRAWL_API_KEY	页面抓取	可选（使用 WebFetch 备用方案）
GOOGLE_API_KEY	SERP 调研	已有
PERPLEXITY_API_KEY	替代 SERP	已有

---

与付费工具的比较

功能	此技能	Ahrefs（$99/月）	Semrush（$119/月）
页面审查	✅	✅	✅
SERP 分析	✅	✅	✅
关键词建议	✅	✅	✅
竞争对手分析	✅	✅	✅
医疗语境	✅	❌	❌
与你的内容系统集成	✅	❌	❌
费用	$0	$99/月	$119/月

---

会话示例

用户： 审查 https://drshailesh.com/statin-myths 的 SEO

Claude：

我将使用 3 Agent 流程进行全面的 SEO 审查。

Agent 1：页面审查员 [获取页面、提取结构、识别关键词]

Agent 2：SERP 分析员 [调研“statin myths”，分析排名前 10 的竞争对手]

Agent 3：优化顾问 [综合结果，生成按优先级排序的报告]

---

SEO 审查报告

[完整报告如上所示]

---

你现在就可以采取的快速改进措施：

1. 添加元描述（从报告中复制）
2. 在标题中添加 [2026]
3. 将 H1 改为“7 个他汀类药物误区……”

需要我帮你实施其中任何一项更改吗？

---

此技能能让你的优质内容更容易被发现。