content-seo-optimizer

コンテンツ SEO オプティマイザー

コンテンツを、見つけてもらいましょう。 公開済みのコンテンツを検索結果ページの競合と比較して監査し、優先順位を付けた最適化ロードマップを作成するスキルです。

---

使用するタイミング

シナリオ	このスキルを使いますか？
ブログ記事を公開する前	はい。公開前に最適化します
公開後にトラフィックが少ないとき	はい。原因を調べて改善します
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）
• 医療向けスキーママークアップ

---

他のスキルとの連携

公開前のワークフロー

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	検索結果ページの調査	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	検索結果ページの調査	すでに設定済み
PERPLEXITY_API_KEY	検索結果ページの代替調査	すでに設定済み

---

有料ツールとの比較

機能	このスキル	Ahrefs（$99/月）	Semrush（$119/月）
ページ監査	✅	✅	✅
検索結果ページの分析	✅	✅	✅
キーワードの提案	✅	✅	✅
競合分析	✅	✅	✅
医療分野の文脈	✅	❌	❌
コンテンツシステムとの統合	✅	❌	❌
費用	$0	$99/月	$119/月

---

セッション例

ユーザー： https://drshailesh.com/statin-myths の SEO を監査してください

Claude：

3 エージェントのパイプラインを使って、包括的な SEO 監査を行います。

エージェント 1：ページ監査 [ページを取得し、構造を抽出して、キーワードを特定します]

エージェント 2：検索結果ページ分析 ["statin myths" を調査し、上位 10 件の競合を分析します]

エージェント 3：最適化アドバイザー [調査結果を優先順位付きのレポートにまとめます]

---

SEO 監査レポート

[上記に示した完全なレポート]

---

今すぐできる簡単な改善：

1. メタディスクリプションを追加する（レポートからコピー）
2. タイトルに [2026] を追加する
3. H1 を「7 Statin Myths...」に変更する

これらの変更のいずれかを実装するお手伝いをしましょうか？

---

このスキルを使えば、優れたコンテンツを見つけてもらえるコンテンツに変えられます。