content-brief-factory

コンテンツブリーフファクトリー

ほとんどのコンテンツブリーフは役に立ちません。「このキーワードを7回使うこと」と伝え、それを戦略と呼んでいます。このスキルでは、競合分析、実際の顧客の発言から掘り起こした独自の切り口、SERP 機能の獲得戦略、差別化されたアウトラインを盛り込んだブリーフを作成します。これにより、ライターは何を、なぜ検索上位を獲得できるように作成するのかを正確に把握できます。

基本原則： 優れたブリーフは、単に「X について書くこと」と伝えるだけではありません。「すでに何が上位表示されているか、なぜ成果を上げているか、競合が見落としているギャップは何か、そのギャップが重要であることを示す顧客の言葉は何か、そして競合を上回るページを作るにはどのように構成すればよいか」を具体的に示します。

バッチモード： 1回の実行で10〜50件のキーワードを処理します。ブリーフ1件あたりの所要時間は、エンハンスドモードで約30秒、ベースラインモードで約60秒です。

使用する場面

• 「これらのキーワードのコンテンツブリーフを作成してください」
• 「第2四半期のコンテンツカレンダー用のブリーフが必要です」
• 「pSEO テンプレート用のブリーフを作成してください」
• 「このキーワードリストから20件のブリーフを生成してください」
• 「[トピック]について何を書くべきですか？完全なブリーフを作成してください。」

ツールの強化（任意）

実際の SERP データ（実際に上位表示されているページや、表示される SERP 機能）を利用すると、推定による分析よりもブリーフの質が大幅に向上します。

ユーザーへのエージェントのプロンプト

「競合調査と顧客の言葉の分析に基づいて、質の高いコンテンツブリーフを作成できます。最良の結果を得るには、特に正確な SERP 分析やキーワード指標が必要な場合、SERP データ API の接続をおすすめします。」

おすすめ：SerpAPI（月100回まで無料、5,000回で月額50ドル）

• serpapi.com で登録 → API キーを取得
• SERPAPI_KEY 環境変数を設定

利用可能な代替サービス：

• Serper.dev（2,500回まで無料、その後50K回で月額50ドル）→ SERPER_API_KEY を設定
• DataForSEO SERP（従量課金、1回あたり約0.01ドル）→ DATAFORSEO_LOGIN と DATAFORSEO_PASSWORD を設定
• ValueSERP（無料プランあり）→ VALUESERP_API_KEY を設定

「いずれかを使いますか？それともベースラインモードで進めますか？ベースラインモードではウェブ検索で競合ページを分析します。SERP 機能や検索ボリュームのデータはやや不正確ですが、質の高いブリーフを作成できます。」

モードの選択

• エンハンスドモード — キーワードごとに実際の SERP データを取得します。正確な上位表示ページ、表示されている SERP 機能（強調スニペット、PAA、動画カルーセル）、検索ボリューム、キーワード難易度が含まれます。ブリーフには、特定の「この SERP 機能を獲得する」ための戦略が盛り込まれます。
• ベースラインモード — web_search で上位表示ページを特定し、seo-domain-analyzer でドメイン指標を調べます。SERP 機能は推定で検出します。それでも優れたブリーフを作成できます。競合分析や顧客の言葉の要素には SERP API は不要です。

フェーズ0：ヒアリング

1. キーワード — ターゲットキーワードのリスト（1〜50件）。以下の形式を使用できます。
   • 貼り付けたリスト
   • CSV ファイル
   • seo-opportunity-finder の出力
   • programmatic-seo-planner の出力（テンプレートキーワード）
2. 自社サイトの URL — 既存のコンテンツを確認するために使用します
3. ICP — このコンテンツを読むのは誰ですか？（役職、課題、目標）
4. ブランドボイス — フォーマル／カジュアル／技術的のどれですか？（またはブランドボイスのドキュメントへのリンク）
5. 希望するコンテンツタイプ — ブログ記事、ランディングページ、ガイド、用語集の記事など
6. ブリーフの詳細度 — 標準（アウトライン＋切り口＋競合）または詳細（上記すべて＋顧客の引用＋SERP 機能の獲得戦略＋内部リンク）
7. ツールの設定 — SERP API を使うエンハンスドモード、またはベースラインモードのどちらにしますか？（上記の「ツールの強化」を参照）

フェーズ1：既存コンテンツの確認

自社サイトで site-content-catalog を実行します。

python3 skills/site-content-catalog/scripts/catalog_content.py \
  --url "<your_site_url>" \
  --output json

各ターゲットキーワードについて、以下を確認します。

• このキーワードをターゲットにしたページはすでにありますか？ → 新規ページではなく、ブリーフを更新
• この記事にリンクすべき関連ページはありますか？ → 内部リンク候補
• どのようなコンテンツギャップがありますか？ → このキーワードを狙う価値があることを確認します

フェーズ2：キーワードごとの分析（バッチ処理）

可能な場合は並列で、各キーワードについて以下を実行します。

2A: SERP 分析

拡張モード（SerpAPI / Serper / DataForSEO）：

# SerpAPI example
GET https://serpapi.com/search?q={keyword}&api_key={key}&num=10

キーワードごとに抽出します：

• 上位10件のランキング URL
• 表示される SERP 機能（強調スニペット、PAA、動画、ナレッジパネル、画像）
• 強調スニペットの掲載元（ある場合）とスニペットの内容 -「他の人はこちらも質問」の質問（上位5件）
• 関連検索
• 検索ボリュームとキーワード難易度（API から取得可能な場合）

ベースラインモード：

各キーワードについて web_search を使用します：

• 上位5～10件の検索結果を記録します
• 検索結果の形式から明らかな SERP 機能を特定します
• ボリューム／難易度の推定には seo-domain-analyzer を使用します

2B: 競合ページ分析

キーワードごとに上位3～5件のランキングページを fetch_webpage で取得します：

各ページを分析します：

• 単語数 — ランキングページの長さはどの程度ですか？
• 構成 — H1、H2 のアウトライン、コンテンツの流れ
• コンテンツの種類 — ハウツー、リスト記事、比較、ガイド、定義
• 独自データ — 独自調査、アンケート、スクリーンショットが含まれていますか？
• 鮮度 — 最終更新日はいつですか？
• 深度スコア — 概要のみか、包括的なリソースか
• 不足しているトピック — 掲載すべきなのに取り上げられていない内容は何ですか？

2C: 顧客の言葉の収集

トピックについて review-site-scraper と reddit-post-finder を実行します：

# Reviews — find how ICP talks about this problem
python3 skills/capabilities/review-site-scraper/scripts/scrape_reviews.py \
  --platform g2 \
  --url "<relevant_product_review_url>" \
  --output json

# Reddit — find real questions and pain language
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit "<relevant_subs>" \
  --keywords "<keyword>,<topic>" \
  --days 365 --sort top --time year

抽出する内容：

• このトピックについて実際に人々が尋ねている質問 → 含めるべきセクション
• 悩みを表す言葉 → 導入のフックの切り口
• 誤解 → 誤解を解くセクションの機会
• 具体的なユースケース → 含める具体例
• 引用 → コンテンツに織り込む根拠となる情報

フェーズ3：ブリーフの作成

キーワードごとに、次の内容を作成します：

# Content Brief: [Target Keyword]

## Metadata
- **Target keyword:** [primary keyword]
- **Secondary keywords:** [2-5 related keywords to include naturally]
- **Search volume:** [monthly, if available] | **Difficulty:** [score, if available]
- **Content type:** [blog post / guide / comparison / glossary / landing page]
- **Target word count:** [X-Y words] (based on competing pages)
- **Priority:** [P0/P1/P2]

---

## Search Landscape

### What's Currently Ranking
| # | Page | Domain | Type | Words | Strengths | Weaknesses |
|---|------|--------|------|-------|-----------|------------|
| 1 | [title] | [domain] | [type] | [count] | [what they do well] | [what they miss] |
| 2 | ... | | | | | |
| 3 | ... | | | | | |

### SERP Features Present
- Featured snippet: [Yes/No — current holder + content]
- People Also Ask: [list of PAA questions]
- Video carousel: [Yes/No]
- Images: [Yes/No]
- Knowledge panel: [Yes/No]

### SERP Feature Targets
- [ ] **Win featured snippet** — Structure answer in [format] under H2 "[heading]"
- [ ] **Answer PAA questions** — Include sections covering: [list]
- [ ] **Image pack** — Include [type of images/diagrams]

---

## Differentiation Angle

**The gap in existing content:** [What ALL ranking pages miss or do poorly]

**Your unique angle:** [How to approach this differently — based on customer language, product positioning, or data you have that competitors don't]

**Customer voice evidence:**
> "[Quote from review/Reddit showing the gap]" — [Source]
> "[Another quote]" — [Source]

---

## Recommended Outline

### Title Options (pick one)
1. [Title option A — SEO-optimized]
2. [Title option B — curiosity-driven]
3. [Title option C — outcome-focused]

### Meta Description
[155 characters, includes keyword, has clear value prop]

### Content Structure

**H1: [Exact H1]**

**H2: [Section 1 — Hook/Problem Statement]**
- What to cover: [specific guidance]
- Length: [~X words]
- Include: [customer pain quote as hook]

**H2: [Section 2 — Core Content]**
- What to cover: [specific guidance]
- Length: [~X words]
- Include: [comparison table / step-by-step / framework]

**H2: [Section 3 — Differentiated Angle]**
- What to cover: [the thing competitors miss]
- Length: [~X words]
- This is your competitive edge

**H2: [Section 4 — Practical Application]**
- What to cover: [concrete examples, use cases]
- Include: [screenshots, templates, or data]

**H2: [Section 5 — FAQ / PAA Answers]**
- [PAA question 1] — [brief answer guidance]
- [PAA question 2] — [brief answer guidance]
- [PAA question 3] — [brief answer guidance]

**H2: [Section 6 — CTA / Next Steps]**
- What to cover: [natural transition to your product]

---

## Internal Linking Plan
- **Link FROM this page TO:** [existing pages that are relevant]
- **Link TO this page FROM:** [existing pages that should reference this]
- **Anchor text suggestions:** [specific anchor text for each link]

---

## Content Requirements
- [ ] Include at least [N] original examples/screenshots
- [ ] Use customer language: "[specific phrases to work in]"
- [ ] Include structured data: [FAQ schema / HowTo schema / etc.]
- [ ] Add last-updated date (for freshness signals)
- [ ] Target readability: [grade level / reading time]

---

## Competitive Advantage Checklist
- [ ] Covers everything top 3 pages cover
- [ ] Adds [unique angle] they all miss
- [ ] Uses real customer language (not generic marketing speak)
- [ ] Targets [SERP feature] with optimized format
- [ ] Has stronger internal linking than competitors
- [ ] Includes original [data/images/templates] competitors lack

フェーズ4：一括出力

一括実行（ブリーフ10件以上）の場合：

# Content Brief Batch — [Product/Client] — [DATE]

## Summary
- Briefs generated: [N]
- Total target search volume: [X]/month
- Content types: [N] blog posts, [N] guides, [N] comparisons, etc.

## Priority Order
| # | Keyword | Volume | Difficulty | Content Type | Unique Angle | Status |
|---|---------|--------|-----------|-------------|-------------|--------|
| 1 | [kw] | [vol] | [diff] | [type] | [angle summary] | Ready |
| 2 | [kw] | [vol] | [diff] | [type] | [angle summary] | Ready |
...

## Individual Briefs
[Brief 1]
---
[Brief 2]
---
...

現在の作業ディレクトリ、またはユーザーが希望する場所に保存します。一括モードでは、概要 CSV もエクスポートします。

費用

項目	費用
サイトカタログ（一度のみ）	~$0.05-0.10
レビュースクレイパー（トピッククラスターごと）	~$0.10-0.30
Reddit スクレイパー（トピッククラスターごと）	~$0.05-0.10
ページ取得（キーワードごとに3～5件）	~$0.01-0.03 per keyword
SerpAPI（拡張、キーワードごと）	~$0.01-0.05 per keyword
Serper.dev（拡張、キーワードごと）	~$0.001 per keyword
分析	無料（LLM による推論）
ブリーフ1件あたりの合計（ベースライン）	~$0.05-0.15
ブリーフ1件あたりの合計（拡張）	~$0.08-0.25
ブリーフ20件の一括処理（ベースライン）	~$1.00-3.00
ブリーフ20件の一括処理（拡張）	~$1.60-5.00

必要なツール

• Apify API トークン — APIFY_API_TOKEN env var
• 上流スキル： site-content-catalog、seo-domain-analyzer、review-site-scraper、reddit-post-finder、fetch_webpage
• オプション（拡張）： SerpAPI（SERPAPI_KEY）、Serper.dev（SERPER_API_KEY）、DataForSEO（DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD）、または ValueSERP（VALUESERP_API_KEY）

スケジュール設定

継続的なコンテンツ運用では、毎週実行します：

• 入力：seo-opportunity-finder またはコンテンツカレンダーからのキーワード
• 出力：執筆チーム向けの最新ブリーフ
• スケジュール：編集計画の前の月曜日の朝

トリガーフレーズ

-「これらのキーワードのコンテンツブリーフを作成して」 -「[keyword] についてブリーフを作成して」 -「コンテンツブリーフを20件生成して」 -「[topic] について何を書くべき？」 -「コンテンツカレンダー用のブリーフを作成して」 -「これらのキーワードのブリーフを一括作成して」