content-brief について
content-brief は、ライターや SEO チーム向けに、1 つのターゲットキーワードから記事ブリーフを作るスキルです。対象読者、切り口、検索結果、執筆方針をまとめ、記事そのものは作成しません。Semrush データ、手動観察、モデルの判断を区別します。
主な機能
- 01単一キーワードを軸にしたブリーフ作成
- 02対象読者、目標、記事の切り口の整理
- 03検索結果と上位ページの分析
- 04タイトル、メタディスクリプション、構成案の提案
- 05範囲、リンク、文体の計画
- 06根拠の出所と不足データの明示
活用シーン
- 01ターゲットキーワードに基づく記事ブリーフ作成
- 02検索結果にあるページ形式や切り口の比較
- 03読者と事業目標に沿った記事方針の決定
- 04Semrush MCP が使えない場合の代替根拠の利用
MCP 対応
Semrush MCP を使い、キーワード、自然検索結果、URL やドメインを調査できます。レポートの発見、スキーマ取得、クエリ実行の手順を取り、API ユニット消費を考慮しつつ、手動観察やモデル推論を Semrush データと区別します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ semrush/ skills --skill content-briefインストール後、Claude Code で/content-briefを入力して読み込まれたか確認します。
詳細
コンテンツブリーフ
このスキルでは、1つのターゲットキーワードから、ライターが公開可能な記事を仕上げるためのコンテンツブリーフを作成します。ブリーフに含めるべき内容と、含めるべきでない内容について、明確な考え方があります。優れたブリーフは、範囲を定め、切り口を示し、あとはライターに任せます。
ブリーフは記事を代わりに書くものではありません。細かく指定しすぎたブリーフはコンプライアンスチェックリストのようになり、コンプライアンスチェックリストのようなコンテンツを生み出します。ブリーフの役割は、ライターが実質的な判断を下せるだけの背景を伝えることであり、判断の余地をなくすほど細かく指定することではありません。
始める前に
以下の情報を一度に確認してください。
- ターゲットキーワード。 1つのブリーフにつき、主要キーワードは1つです。ユーザーが複数のキーワードを提示した場合は、ユーザーと相談して選ぶか、関連性、ビジネス価値、検索意図との適合性、上位表示の実現可能性、SERP の根拠に基づいて優先順位を付けます。検索ボリュームが最も高い語をデフォルトで選ばないでください。
- ドメイン。 任意ですが、関連する既存ページ、検索順位、内部リンク先を確認できるため、結果が向上します。テスト済みの公開 MCP が、指定ドメインに合わせてパーソナライズされたキーワード難易度を返すとは主張しないでください。
- Semrush MCP が接続されているかどうか。 接続されている場合、ライブ SERP データに基づく Semrush のキーワードレポートやオーガニック検索レポートを利用できます。接続されていない場合でもブリーフは作成できますが、SERP 分析は手動または参考情報として明記してください。Semrush MCP は Semrush 独自の認証フローで接続するため、貼り付ける API キーはありません。
- ターゲットオーディエンス。 オーディエンスの定義がないブリーフでは、誰にも語りかけないコンテンツが生まれます。書面化された ICP、コンテンツガイドライン、オーディエンスに関するメモがあるか、一度確認してください。ない場合は、読者がどのような人かを2文で説明してもらいます。
- 目標。 トラフィック獲得のための検索順位向上、既存キャンペーンの支援、トピカルハブの構築、成果の低いページの更新などです。目標によってブリーフの内容は変わります。
Semrush MCP の使い方
Semrush MCP のみを使用してください。
呼び出し可能な MCP ツール名は、調査のエントリーポイントとスキーマ実行です。Keyword Overview や Keyword Magic Tool などのレポート/製品名は、ツールとして直接呼び出すのではなく、スキーマのフローを通じて選択します。
- 一般的なキーワード指標(検索ボリューム、一般的な KD、検索意図、CPC など)を取得するには、
keyword_research→phrase_thisを使用します。テスト済みのスキーマには、ドメイン入力、PKD フィールド、SERP 機能フィールドはありません。 - 関連キーワードや質問形式のキーワードには、
keyword_research→phrase_relatedおよびphrase_questionsを使用します。これらのレポートが返すのはキーワード行であり、Keyword Magic Tool のグループ、自動クラスター、アウトラインではありません。 - ランキング URL には、
positions_type: organicを指定してkeyword_research→phrase_organicを使用します。機能別の順位行が意図的に必要な場合に限り、positions_type: allを使用し、それらの行はオーガニック検索のランキングとは分けてください。すべての生データ行を保持しますが、ページのレビューや形式別の件数を集計する際は同一 URL を重複排除し、返されたすべての順位を記録してください。このレポートから、語数、ページのトラフィック、ページレベルの参照ドメイン数、Authority Score を推定しないでください。
レポートの出力は慎重に解釈してください。
- 数値の検索意図コードと SERP 機能コードは、返された値をそのまま保持してください。現在確認済みのスキーマまたは公式ドキュメントに対応付けが示されている場合に限り、コードを人が読めるラベルに変換します。それ以外の場合は、未解決の値として生のコードを表示し、手動で分類した検索意図や機能は、モデルによる推論または観察として別に記載してください。
- 関連キーワードと質問形式のキーワードの行は、ブリーフで使用する前に、重複、明示的な検索演算子、エンコードの破損、明らかな誤字、トピックとの無関係を確認してください。元の行を保持し、スクリーニングルールと除外件数を記載します。また、除外した行の指標を修正後の表記に割り当てないでください。
- Semrush のレポート間で値が異なる場合は、レポート名、データベース、対象、取得可能な日付またはスナップショットの情報とともに、両方の値を保持してください。暗黙に統合したり、より有利な値を選んだりしないでください。判断にどの値を使用したか、またその理由を説明します。使用する値がない場合は、指標に不整合があると明記してください。
標準的なワークフローは変わりません。Semrush MCP の keyword_research または organic_research で調査を開始し、対象レポートの get_report_schema を取得してから、パラメーターを指定して execute_report を実行します。
構造化された SERP Analysis の成果物が提供されている場合は、同じ調査をやり直すのではなく、そのキーワードのコンテキスト、検索意図、機能マップ、ランキング URL、エビデンスの有無、形式の分布、ギャップ、信頼度を利用してください。提供されていない場合は、上記のレポートでエビデンスを作成し、必要な場合にのみ、追加のドメインまたは URL のエビデンスを取得します。手動での確認、形式の分類、ギャップの検出、クラスタリング、アウトラインの判断は、Semrush が返すフィールドではなく、アナリストまたはモデルによる判断として明示してください。
MCP のアクセスとコストに関するガードレール
- 最初の
execute_report呼び出しの前に、Semrush MCP のクエリは API ユニットを消費することをユーザーに伝えてください。必要なフィールドのみをリクエストし、質問に答えられる最小の結果件数を使用します。最初のバッチを確認してから、必要に応じて拡張してください。デフォルトで全行をリクエストしないでください。 - 認証が不完全な場合、必要なツール、レポート、スキーマ、フィールドが利用できない場合、またはアクセスやユニットが原因で実行に失敗した場合は、その MCP の処理を中止してください。利用できないものと、それによってブリーフのどの部分に影響があるかを伝え、以下のうち最も有効な代替手段を使用してください。Semrush の指標が欠けていても、捏造したり、黙って別のものに置き換えたりしないでください。
代替手段の優先順位
利用可能な中で最も信頼できるデータソースを使用し、どれを使用したかを明記してください。
- Semrush MCP のキーワード、SERP、URL/ドメインのレポート。
- ユーザーから提供された Semrush UI のエクスポート。
- 対象国での手動による SERP の確認。
- ユーザー提供の競合 URL と、自社のオーディエンスに関するメモ。欠けている指標は推測せず、不明と記載してください。
エビデンスの取り扱い方針
情報源の出所と確信度は分けて扱います。重要な入力情報と推奨事項には、次のラベルを使用してください。
- Semrush のデータ: 名称が明記された MCP レポートから返された値です。レポート名を記載してください。
- Semrush が裏付けるガイダンス: リンク先の Semrush の情報源に裏付けられた編集上の推奨事項です。検索エンジンの要件として提示しないでください。
- ユーザー提供情報: 第一者の目標、オーディエンスに関する知見、コンバージョンの根拠、制約、または承認済みの情報源です。
- 手動での観察: MCP から返されたものではなく、SERP またはページを直接確認して得られた特徴です。
- モデルによる推論: 形式、切り口、グルーピング、アウトライン構成など、利用可能なエビデンスから導き出した推奨事項です。
- 設定可能なデフォルト: 汎用的な SEO ルールではなく、使いやすさを考慮して選んだ開始時の範囲です。
ユーザー向けのブリーフでは、主張の信頼性の判断に関わる場合に、情報源の出所を示してください。すべての文にラベルを付けるのではなく、エビデンスまたは根拠の注記に簡潔なラベルを記載します。確信度は高・中・低で別途評価し、確信度を下げる不足エビデンスも明記します。
ブリーフの構成
実用的なブリーフは、次の8つのセクションで構成されます。それ以外は任意です。
- ターゲットキーワードと検索意図
- オーディエンスと切り口
- SERP の状況(上位10件の分析)
- タイトルとメタディスクリプション
- アウトライン(H1、H2、H3)
- 範囲の指針
- リンク計画(内部および外部)
- スタイルと文体の注記
この順番で進めます。各セクションの内容は、次のセクションにつながります。
1. ターゲットキーワードと検索意図
主要キーワードと、利用可能な phrase_this の指標(検索ボリューム、汎用 KD、CPC、生の検索意図の値など)を記録します。利用できない項目は不明とし、それぞれの値を該当する Semrush レポートと結び付けてください。SERP の機能を phrase_this に帰属させないでください。ブリーフはキーワードから始め、ライターがほかの内容を読む前に、想定される検索ターゲットを把握できるようにします。
返されたコードに検証済みの対応関係がある場合、または実際の SERP のエビデンスが独立したモデル判断を裏付ける場合に限り、検索意図を情報収集型、案内型、商用型、または取引型に分類します。どちらの方法を使用したかを明記してください。検索意図によって、ライターが作成すべき形式は変わります。
- 情報収集型の検索意図では、ガイドや記事が適していることが多いですが、実際の SERP に照らして形式を確認してください。
- 商用型の検索意図では、比較、代替案、レビュー、価格情報が適していることが多いです。
- 取引型の検索意図では、商品、カテゴリ、サービス、または価格ページが適していることが多いです。ワークフローを自動的に止めるのではなく、適切なページタイプを推奨してください。
- 案内型の検索意図では、商品ページやブランドページが適していることが多いです。検索意図が混在または分散している可能性もあるため、判断する前に観察した SERP の分布を確認してください。
同じページで、互いに矛盾する検索意図を混在させることなく対応できるセカンダリーキーワードだけを追加します。Semrush のデータ行に加え、透明性のある検索意図と SERP の重複分析に基づいて選定してください。含めたすべての語句でページが上位表示されると約束してはいけません。
2. オーディエンスと切り口
短い段落を2つだけにします。それ以上は書きません。
オーディエンスの段落では、読者が誰で、トピックについてすでに何を知っていて、記事に何を求めているのかを示します。「B2B SaaS のシニア SEO 担当者で、このテーマのガイドをすでに3本読み、ほかの誰も扱っていない内容を知りたい」は有用です。「マーケター」では不十分です。
切り口の段落では、ページの訴求点を示します。上位10件が扱っていないことを、この記事は何として伝えるのでしょうか。一文で答えられない場合、ブリーフはまだ完成していません。すでに上位10件がテーマを扱っているため、一般的な内容だけでは既存の上位10件に勝てません。
切り口の例:
- 第一者データのポイント(ライターが引用できる調査、実験、ツールの結果)。
- 通説に反する見解(ここでは従来のアドバイスが誤っており、それを証明できます)。
- より具体的な範囲(上位10件は一般的な内容ですが、こちらは特定の業界やユースケースを対象とします)。
- より実用的な形式(上位10件は文字ばかりですが、こちらはツール、計算機、テンプレート、またはチェックリストです)。
3. SERP のコンテキスト
Semrush MCP を利用するか、SERP を直接確認して、主要キーワードのオーガニック検索結果の上位 10 件を取得します。
順位付けされている代表的な結果について、次の情報を記録します。
- URL
- ページの種類(ガイド、リスト記事、比較、計算ツール、製品ページ)
- 直接測定できる場合に限り、単語数。目標やランキング要因ではなく、競合の参考情報として明記します
- 注目すべき切り口や差別化要素
- そのページがサイト内のトピックハブの一部かどうか
phrase_organic コードとの対応が確認できる場合、または SERP を直接確認できる場合に限り、表示される SERP 機能も記録します。対象は、強調スニペット、PAA ボックス、動画カルーセル、ショッピング結果、AI Overview です。対応関係が確認できていない数値コードから、機能名を推測してはいけません。検証済みの機能を使って、適したフォーマットと検索者のニーズを特定します。回答の長さを一律に決めたり、AI Overview が常にクリック数を減らすと主張したりせず、観察した証拠が裏付ける内容のみを説明します。
ライターに伝えるべき一般的な傾向です。
- あるフォーマットが優勢な場合、その傾向の強さと、別のフォーマットでも同じ検索意図をより適切に満たせるかどうかを記します。
- 上位ページに一貫した深さや範囲が見られる場合は、それを参考情報として示しつつ、読者に必要な内容を定義します。競合ページの単語数をランキング要件に置き換えてはいけません。
- 1 つのサイトが複数の検索結果を占める場合は、その集中状況を観察結果として記録します。それだけを根拠に、そのサイトがトピックを独占していると判断してはいけません。
4. タイトルとメタディスクリプション
タイトル候補を 2 つ、メタディスクリプションを 1 つ作成します。
タイトル:
- Semrush が推奨する指針: 切り詰めや書き換えのリスクを減らすため、550 ピクセル以内を目安とします。通常は 50〜60 文字です。検索エンジンや AI システムは上限を適用しないため、この範囲を厳格な不合格基準として扱わず、プレビューを利用してください。
- 内容を正確に表し、簡潔で、ページの実際のトピックと検索意図に合ったタイトルにします。
- トピックを正確に伝えられる場合は、主要キーワードを 1 回、自然に含めます。関連する類義語を詰め込まないでください。
- ページで実際に提供する場合に限り、対象読者、範囲、根拠、フォーマットなど、価値が伝わる要素を加えます。
- ユーザーが選べるよう、妥当性のある異なる切り口を提案します。完全一致させる必要はありませんが、タイトルと H1 は同じページのトピックを伝える程度に近づけます。
メタディスクリプション:
- Semrush が推奨する指針: デバイスを問わず切り詰められるリスクを減らすため、135 文字以内を目安とします。ランキング要因や厳格な検証基準ではなく、編集上の目標として扱ってください。
- ページの内容を正確に要約し、検索者が訪問する価値を伝えます。
- 関連性と明確さが高まる場合は、主要キーワードまたは近い表現を自然に含めます。
- 観察された検索意図に対応し、簡潔な回答が有用であれば、中心的な質問への回答も検討します。
- デバイスの幅、文字幅、クエリの太字表示、検索エンジンによる書き換えが表示されるスニペットに影響するため、結果をプレビューしてください。
クリックを促すためだけに有用な回答を控えてはいけません。タイトルと説明は、誤解を招く表現やクリックベイトを避け、ページで実際に提供する内容を正確に表す必要があります。
5. アウトライン
アウトラインはブリーフの骨格です。ここを適切に作成すれば、あとはライターが仕上げられます。
次の3つの情報源をもとにアウトラインを作成します。
- SERP 分析。繰り返し登場するテーマや意味のあるギャップを特定し、読者層と検索意図に照らして、このページで扱う内容を決定します。競合ページの見出しをそのままコピーしないでください。
- People Also Ask。関連する質問をリサーチの手がかりとして活用します。ページの目的を満たすうえで役立つ場合にのみ取り入れ、自動的に H2 や FAQ の項目にしないでください。
- Semrush のキーワード行。検索意図と SERP の重複を透明性のある方法で分析し、関連語句をグループ化したうえで、得られたトピックをアウトラインの根拠として使用します。MCP が意味的なクラスターを返す、あるいは一定数の用語が1つの見出しに対応すると示唆しないでください。
ページの内容を説明し、主要な検索意図に応え、タイトルのトピックと一貫性のある、明確な H1 を1つ提案します。**Semrush に基づくガイダンス:**メインタイトルには H1 を1つ使用し、その後は主要セクションに H2、下位セクションに H3 を使用します。H1 を1つにすることは編集上および構成上の推奨事項として扱い、ランキングを保証するものでも、自動的な不合格条件でもありません。
見出しは明確で、簡潔かつ具体的にします。可能であれば60文字未満を目指しますが、その目標を達成するために明確さを犠牲にしないでください。「料金」のような簡潔なラベルでも、セクションの内容を明確に示していれば問題ありません。各見出しでは、1つのトピックや考えに焦点を当てます。
主要キーワードを H1 に含め、関連する副次キーワードや質問は、自然に収まる場合に H2 と H3 に含めます。読者を最優先し、完全一致の表現を無理に使わないでください。H1 と最初の H2 で主要な検索意図に応え、その後の見出しで関連する補足的な検索意図を扱います。
H3 は、視覚的なリズムを作るためだけに使うのではなく、H2 の直下に置く実質的な下位セクションとして使用します。階層は論理的かつ一貫性のあるものにしてください。
**設定可能なデフォルト:**アウトラインの各項目には、そのセクションで扱う内容、引用する具体的な情報源、盛り込むデータポイントを記したメモを1〜3行添えます。セクション本文そのものは書かないでください。ライターに必要なのは文章ではなく構成です。
6. 範囲に関するガイダンス
読者層と検索意図を満たすために、ページで扱う必要がある質問、根拠、事例、判断事項を定義します。競合ページの文字数を直接測定した場合、SERP の状況を説明する情報として報告してもかまいません。ただし、最低文字数、上限文字数、ランキング保証、または水増しの計算式として扱わないでください。
ライターから計画上の目安を求められた場合は、承認済みのアウトラインと想定される深度に基づく編集上の見積もりであることを明記します。競合ページの文字数に合わせることより、有用な内容を十分に網羅することが重要であると説明してください。
7. リンク計画
内部リンク。
- 執筆者が書き始める前に、関連性の高いリンク先を特定します。Semrush のオーガニックレポート、提供されたエクスポート、または手動で作成したサイトマップを使って、ユーザーがすでに公開しているサイトから候補を探します。
- リンクの両方向を計画します。新しいページから内容に関連する既存ページへのリンクと、関連性の高い既存ページや信頼できるページから新しいページへのリンクです。
- Semrush が推奨する指針: 新しいコンテンツには、少なくとも 2〜3 件の内部リンクを向けることを目指します。これは編集上の目安として扱い、自動的な不合格条件にはしません。新しいページからの内部リンクは、固定件数ではなく、文脈上の関連性に基づいて推奨します。
- サイトの実際の構造に合致する場合は、ピラーページからクラスターへのリンクと、クラスターからピラーページへのリンクを設けます。ホームページやピラーページへのリンクを自動的に必須としないでください。
- 簡潔で説明的なアンカーテキストを使います。理想は 5 語以内です。関連性があれば、完全一致の内部アンカーも使用できますが、キーワードの詰め込みや、「ここをクリック」「このページ」のような汎用的なアンカーは避けます。
外部リンク。
- 主張の裏付けや、有益な背景情報の提供に必要な、関連性が高く信頼できる専門的な外部ソースを特定します。
- 設定可能なソース品質のデフォルト: 利用できる場合は、政府機関の情報源、独自調査、製品の一次資料、信頼できる業界誌を優先します。すべてのアグリゲーターを自動的に不適切と見なさず、実際のソースと根拠を評価します。
- 外部リンクの固定件数は設けません。簡潔で説明的なアンカーテキストを使い、読者に価値をもたらす場合にのみリンクを推奨します。
- クリックベイト、質の低い情報、質の低いディレクトリやブックマークサイト、ランキング操作を目的としたリンク施策は避けます。
- 信頼できるソースへの通常の編集上のリンクに、特別なリンク属性は不要です。推奨や関連付けを避けるべきサイトには
rel="nofollow"を使います。スポンサーリンクやアフィリエイトリンクにはrel="sponsored"またはrel="nofollow"を付けます。一律に禁止しないでください。
8. 文体と語り口に関するメモ
箇条書きは 3〜5 項目にします。以下を含めます。
- 読者のレベル(技術者向け、一般向け、初心者向け)。
- 一人称、二人称、または人称を使わない文体。いずれかを選び、執筆者に伝えます。
- 例の方針。実際の数値や実名を使うか、仮のプレースホルダーを使うか。
- ユーザーが以前に指摘した、禁止フレーズや AI らしい表現。
- 組織内のスタイルに関するリンク(トーン・オブ・ボイス文書、スタイルガイドの URL)。
ブリーフの報告方法
ブリーフは単一の Markdown 文書として出力します。上記 8 セクションに対応する H2 見出しを使います。構成済みのセクションに収まらない内容は、末尾の「執筆者へのメモ」セクションに記載します。
ブリーフ自体に関する 2 つのルール。
- 実際の値を出典とともに記載します。「Semrush
phrase_this:検索ボリューム 2,400、KD 38%、インテントコード 1(対応付け未解決)」のように、検証済みの対応付けがない場合でも役立つ情報を示します。「有望な候補」のような表現は避けます。 - 記載するデータポイントには、それぞれ具体的な出典を提案します。調査名を示さずに「最近の調査によると」と書いたブリーフは、執筆者に事実を捏造させることになります。
- 手動で得た所見と、モデルが生成した提案を区別して示します。不完全な根拠が、提案する形式、切り口、またはアウトラインに重大な影響を及ぼす場合は、確信度に関する短い注記を加えます。
トピックの複雑さと執筆者のニーズに見合った分量にします。執筆者の判断を変えない指示は削除します。
出典
このスキルは、以下のSemrush編集記事を参考にしています。
- コンテンツブリーフの作成方法
- コンテンツアウトラインの作成方法
- ブログ記事の書き方
- SEOのためのキーワード調査
- 検索意図とは
- タイトルタグとは?
- メタディスクリプションとは?
- 見出しタグとは?
- 内部リンク:完全ガイドと戦略
- 外部リンクとは?
- アンカーテキストとは?
これらの記事は、手法の参考資料として使用してください。ユーザーが手法に関する引用を求めた場合、または特定の主張の検証が必要な場合にのみ、ユーザー向けブリーフに記事へのリンクを含めてください。