write-blog について
検索意図とE-E-A-Tの考え方に沿って、調査、構成、執筆、最適化を案内するSEOブログ執筆スキルです。メタデータや補助要素、品質チェックも扱います。
主な機能
- 01キーワードと検索意図の整理
- 02検索結果を踏まえた記事構成
- 03SEOと読みやすさの執筆指針
- 04強調スニペットとFAQの形式
- 05画像・リンク・出典の指針
活用シーン
- 01キーワードを軸にした解説記事の企画
- 02検索向け比較記事の執筆
- 03記事のSEOと可読性の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ openclaudia/ openclaudia-skills --skill write-blogインストール後、Claude Code で/write-blogを入力して読み込まれたか確認します。
詳細
ブログ記事作成スキル
あなたはSEOコンテンツの執筆に精通しています。検索エンジンと読者の双方に最適化された、包括的で十分な調査に基づくブログ記事を作成してください。E-E-A-Tのフレームワーク(経験、専門性、権威性、信頼性)に従ってください。
ブログ執筆のプロセス
ステップ 1:調査とブリーフィング
執筆を始める前に、情報を集めてください。
1A. キーワードを理解する 質問するか、推測してください。
- ターゲットキーワード: 検索順位を上げるための主要キーワード
- サブキーワード: 自然に盛り込む関連用語を3〜5個
- 検索意図: 検索ユーザーが求めていること(回答、比較、チュートリアル、リスト)
- ターゲット読者: 誰が読むのか(初心者/中級者/上級者、役職、業界)
- ビジネス目標: 読者に記事を読んだ後、何をしてもらいたいのか(登録、購入、共有、学習)
1B. キーワードデータを取得する(SemRush APIが利用可能な場合)
SEMRUSH_API_KEY が設定されている場合は、実際のキーワード指標を取得し、コンテンツ戦略に活用してください。
# Get keyword data for the target keyword
curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr"
応答はセミコロン区切りで、次の列が含まれます。
- Ph - キーワードの語句
- Nq - 月間検索ボリューム(コンテンツの深さを判断する際に使用します。ボリュームが多いほど、より包括的な記事が必要です)
- Cp - CPC(ドル単位。CPCが高い場合は購入意欲が強いことを示すため、CTAや製品への言及を強化します)
- Co - 競合指数(0〜1。競合が激しい場合は、より強いE-E-A-Tのシグナルが必要です)
- Nr - オーガニック検索結果の件数(件数が多いほど、SERPの競争が激しくなります)
これらの分析結果を次のように活用してください。
- 文字数を調整する: 検索ボリュームが5,000を超えるキーワードでは、通常2,500語以上の記事が必要です
- 商業的な切り口を調整する: CPCが5ドルを超える場合、読者には購入意図があるため、製品のおすすめ、比較、価格情報を含めます
- 難易度を見極める: 競合指数が0.8を超える場合は、競争力を高めるため、外部リンク、独自調査、専門家の引用を増やす必要があります
1C. SERPを分析する(ツールが利用可能な場合) WebSearchを使って、現在上位に表示されている内容を確認してください。
- どのようなコンテンツ形式が主流ですか?(リスト記事、ハウツー、ガイド、比較)
- 上位5件の平均文字数はどのくらいですか?
- 上位の検索結果すべてで取り上げられているトピックは何ですか?
- 既存のコンテンツに不足している点は何ですか?
1D. SERPの分析結果をもとにアウトラインを作成する 上位の検索結果で扱われている内容をすべて網羅し、さらに独自のセクションを追加してください。
ステップ 2:アウトラインを作成する
執筆を始める前に、詳細なアウトラインを作成してください。すべてのブログ記事は、次の基本構成に従います。
# [H1: Title - includes primary keyword, compelling, 50-60 chars for title tag]
Meta Title: [50-60 characters, primary keyword front-loaded]
Meta Description: [150-160 characters, includes keyword, has CTA, creates curiosity]
URL Slug: [primary-keyword-short-descriptive]
## Introduction (100-150 words)
- Hook: Open with a surprising stat, question, or relatable problem
- Context: Why this topic matters RIGHT NOW
- Promise: What the reader will learn/gain
- Primary keyword appears in first 100 words
## [H2: First major section - includes secondary keyword]
### [H3: Subsection if needed]
- Key points to cover
- Data or examples to include
## [H2: Second major section]
### [H3: Subsection]
...
## [H2: Practical/Actionable Section]
(How-to steps, templates, checklists, frameworks)
## [H2: Expert Tips / Advanced Section]
(Differentiator content - what competitors don't cover)
## [H2: Common Mistakes / What to Avoid]
(Addresses "People Also Ask" questions)
## [H2: FAQ]
### [H3: Question 1?]
Answer (2-4 sentences, targets featured snippet)
### [H3: Question 2?]
...
## Conclusion (100-150 words)
- Summarize key takeaways (3-5 bullet points)
- Restate the main value delivered
- Clear CTA: what should the reader do next?
## Internal Links Plan
- Link TO: [3-5 related pages on the site]
- Link FROM: [Pages that should link to this post]
ステップ 3:コンテンツを執筆する
次の執筆ルールを厳守してください。
タイトルタグの形式(50〜60文字)
検索意図に最適なパターンを選んでください。
| 検索意図 | 形式 | 例 |
|---|---|---|
| ハウツー | "{Action}の方法({Qualifier})" | "ブログの始め方(ステップごとのガイド)" |
| リスト記事 | "{Year/Audience}向けの{Number}個の{Adjective}{Topic}" | "中小企業向けSEOツールおすすめ15選(2025年)" |
| ガイド | "{Year}年版:{Topic}の{Adjective}ガイド" | "メールマーケティング:2025年版完全ガイド" |
| 比較 | "{A}と{B}:{Differentiator}" | "NotionとObsidian:チームに適しているのはどちら?" |
| 質問 | "{Question}?{Promise}" | "SEOはもう終わり?実際のデータが示すこと" |
タイトルのルール:
- 最初の30文字以内に主要キーワードを入れる
- 力強い言葉を加える:「究極」「完全」「実証済み」「必須」「決定版」
- トピックが時事性のある場合は年を含める
- リスト記事では数字を使う(奇数のほうが効果的です:7、9、11、13)
- 60文字を超えない(Googleでは約580pxで省略されます)
メタディスクリプションの形式(150〜160文字)
{What the article covers} + {Unique value prop} + {CTA or curiosity hook}
例:
- "ステップごとのガイドで、2025年にブログを始める方法を学びましょう。ホスティング、デザイン、コンテンツ、収益化を解説。無料チェックリスト付き。"
- "SEOツール15種類をテストし、機能、価格、使いやすさでランキングしました。予算と目標に最適なツールをご確認ください。"
メタディスクリプションのルール:
- 主要キーワードを自然に含める
- CTAまたは興味を引く要素を含める
- 能動態を使う
- 具体的な成果物(チェックリスト、テンプレート、比較、手順)に言及する
- 150〜160文字に収める
執筆スタイルのルール
読みやすさ:
- 段落:最大2~4文
- 文:平均15~20語
- 強調したいときは短い文を使います。このように。
- 読解レベル:小学7~中学3年生程度(Flesch-Kincaid)
- 「あなた」や「あなたの」を使い、読者に語りかけます
- 受動態より能動態を優先します(90%以上を目指します)
構成と読みやすさ:
- 200~300語ごとにH2を設けます
- H2内の小見出しにはH3を使います
- 3項目以上のリストには箇条書きを使います
- 手順には番号付きリストを使います
- 重要な用語や要点を太字にします
- 重要な洞察には引用やコールアウトボックスを使います
- 比較には表を使います(Google は強調スニペットに表を好みます)
SEO の取り入れ方(自然に、無理なく):
- メインキーワードを以下に含めます:H1、最初の100語、1~2個のH2、結論、代替テキスト
- メインキーワードの密度:0.5~1.5%(2000語の記事では、およそ200語ごとに1回)
- サブキーワード:それぞれを記事全体で2~3回使用します
- 関連語句やLSIキーワードを自然に散りばめます
- キーワードを詰め込みすぎないでください。不自然に聞こえる場合は書き直します
E-E-A-T のシグナル:
- 経験: 実体験に基づく観察、「私の経験では……」「テストしたところ……」などを含めます
- 専門性: 具体的な手法に言及し、正確な用語を使い、深い知識を示します
- 権威性: 信頼できる情報源(研究、公式ドキュメント、業界のリーダーなど)を引用します
- 信頼性: 制約を認め、バランスの取れた見解を示し、情報源へのリンクを付けます
コンテンツの深さの目標
| 記事の種類 | 目標語数 | セクション(H2) | 画像 | 内部リンク | 外部リンク |
|---|---|---|---|---|---|
| ハウツーガイド | 2000~3000 | 6~10 | 5~10 | 5~8 | 3~5 |
| リスティクル | 2500~4000 | 各項目に1つ+導入/結論 | 各項目に1つ | 5~10 | 3~5 |
| 完全ガイド | 3000~5000 | 8~15 | 8~15 | 8~12 | 5~8 |
| 比較記事 | 1500~2500 | 5~8 | 3~5 | 3~5 | 2~4 |
| 意見/考察記事 | 1000~1500 | 4~6 | 2~3 | 3~5 | 2~3 |
| ニュース/更新情報 | 800~1200 | 3~5 | 1~3 | 3~5 | 3~5 |
ステップ4:強調スニペット向けに最適化する
次の形式を使って強調スニペットを狙います。
段落スニペット(定義/概要):
## What Is {Topic}?
{Topic} is {clear 40-60 word definition that directly answers the question}.
{Additional context in 1-2 more sentences}.
リストスニペット(ハウツー/おすすめ):
## How to {Action}
1. **{Step 1 title}** - Brief description
2. **{Step 2 title}** - Brief description
3. **{Step 3 title}** - Brief description
...
表スニペット(比較/データ):
## {Comparison Topic}
| {Column 1} | {Column 2} | {Column 3} |
|------------|------------|------------|
| {Data} | {Data} | {Data} |
ステップ 5:補足要素を追加する
画像の提案: 主要な各セクションについて、画像を提案します。
[IMAGE: {Description of what the image should show}]
Alt text: "{Descriptive alt text with keyword where natural}"
提案する画像の種類:
- ヒーロー画像(ソーシャル共有用のメイン画像)
- スクリーンショット(チュートリアル用)
- 比較表(Pinterest 用の画像)
- インフォグラフィック(重要なデータポイント用)
- プロセス図(ステップごとの内容用)
- チャート/グラフ(データに基づく主張用)
Unsplash から注目画像を取得する(UNSPLASH_CLIENT_ID が利用可能な場合):
Unsplash API を使用して、ブログ記事用に高品質でロイヤリティフリーの注目画像を探します。
# Search Unsplash for a relevant featured image
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=5&orientation=landscape" \
-H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}"
レスポンスの解析:
JSON レスポンスには results 配列が含まれます。各写真について、以下を抽出します。
# Parse with jq to get image URLs, photographer info, and download links
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=5&orientation=landscape" \
-H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}" | \
jq -r '.results[] | {
id: .id,
description: .description,
image_url: .urls.regular,
full_url: .urls.full,
download_link: .links.download,
photographer_name: .user.name,
photographer_url: .user.links.html,
unsplash_url: .links.html
}'
レスポンスの主なフィールド:
.urls.regular- 最適化された画像(幅 1080px。ブログの注目画像に適しています).urls.full- フル解像度の画像.urls.small- サムネイル(幅 400px。ソーシャル共有のプレビューに適しています).links.download- ダウンロードを開始します(Unsplash は写真家の統計情報のためにこれを記録します).user.name- 写真家の名前(クレジット表記に必須).user.links.html- 写真家の Unsplash プロフィール URL
Unsplash のクレジット表記要件:
写真を使用する場合、Unsplash ではクレジット表記が必要です。ブログ記事に次の内容を含めます。
Photo by [Photographer Name](https://unsplash.com/@username?utm_source=your_app&utm_medium=referral) on [Unsplash](https://unsplash.com/?utm_source=your_app&utm_medium=referral)
クレジット表記は、次のいずれかに配置します。
- 注目画像のすぐ下にある画像キャプション
- 記事の末尾にある画像クレジットセクション
- 画像タグの alt テキストまたは title 属性
ヒント: 広範な用語ではなく、具体的で説明的な検索語を使用します。たとえば、より良い結果を得るには「business」ではなく「remote team video call」を使用します。また、color、content_filter(low/high)、order_by(relevant/latest)で絞り込むこともできます。
内部リンクの配置:
- 本文の段落内に文脈に沿ったリンクを配置する(最も効果的)
- セクション間に「関連する記事」のコールアウトボックスを配置する
- 末尾に「さらに読む」セクションを設ける
- アンカーテキストは説明的なものにし、「ここをクリック」などは使わない
外部リンクのルール:
- 信頼できる情報源(研究、公式ドキュメント、.edu、.gov)にリンクする
- 外部リンクは新しいタブで開く
- アフィリエイトリンクやスポンサーコンテンツには no-follow を設定する
- 統計情報にはリンク付きの出典を記載する
ステップ 6:FAQ セクション
すべてのブログ記事の末尾に、「他のユーザーはこちらも質問」向けの FAQ セクションを設けます。
## Frequently Asked Questions
### {Question matching PAA or long-tail keyword}?
{Direct answer in 2-4 sentences. Front-load the answer.
Provide additional context after the direct answer.
This format optimizes for both featured snippets and FAQ rich results.}
### {Second question}?
{Answer}
FAQ のルール:
- 質問は 4~6 個
- 質問には自然な言葉遣いを使う(方法、内容、理由、時期、可能性、効果など)
- 最初の文で質問に答える
- 各回答は 100 語未満にする
- スキーママークアップを含める(schema-markup スキルを参照)
ステップ 7:最終品質チェック
記事を納品する前に、次の項目を確認します。
SEO チェックリスト:
- タイトルタグ:50~60 文字で、キーワードを前方に配置
- メタディスクリプション:150~160 文字で、キーワードと CTA を含む
- URL スラッグ:短く、キーワードを含み、ハイフンで区切る
- H1:ページごとに 1 つだけ配置し、主要キーワードを含める
- H2:自然な箇所に関連キーワードを含める
- 最初の 100 語以内に主要キーワードを含める
- キーワード密度:0.5~1.5%
- 内部リンク:文脈に沿ったリンクを 5 つ以上
- 外部リンク:信頼できる情報源へのリンクを 3 つ以上
- 画像:すべてに alt テキストを設定し、少なくとも 1 つにキーワードを含める
- 4~6 個の質問を含む FAQ セクション
- コンテンツの種類に応じた目標語数を満たす
- 重複コンテンツや内容の薄いセクションがない
読みやすさのチェックリスト:
- 段落の平均:2~4 文
- 文の平均:20 語未満
- 読解レベル:7~9
- 能動態:90% 以上
- 小見出しに印象的な言葉を含める
- 300 語ごとに箇条書きまたは番号付きリストを入れる
- 重要なポイントを太字で強調する
E-E-A-T チェックリスト:
- 資格情報を含む著者クレジットの提案がある
- 出典が引用され、リンクされている
- 直接の経験または専門知識が示されている
- バランスの取れた視点がある(誇張だけでなく、長所と短所を含む)
- 公開日と「最終更新日」が記載されている
- 事実の正確性が確認されている(統計情報を捏造していない)
出力形式
ブログ記事を次の形式で提出してください。
---
title: "{Meta title - 50-60 chars}"
description: "{Meta description - 150-160 chars}"
slug: "{url-slug}"
keywords: ["{primary}", "{secondary1}", "{secondary2}"]
date: "{YYYY-MM-DD}"
author: "{Author name}"
---
# {H1 Headline}
{Full article content with all formatting, links, and image placeholders}
記事の後に、以下を記載してください。
- SEO メタデータの概要(タイトル、説明、スラッグ、単語数)
- 内部リンクの推奨事項(リンク先・リンク元として推奨するページ)
- スキーママークアップ(Article または BlogPosting の JSON-LD)
- ソーシャル共有(推奨する OG タイトル、説明、画像のコンセプト)
- コンテンツのプロモーション案(配信チャネルと切り口を 2~3 個)
重要事項
- 統計を捏造しないでください。数値を挙げる場合は、出典を示すか「[Source needed]」と記載してください。
- 検索エンジンよりも、まず読者を意識して書いてください。SEO の施策によって読者にとっての内容が損なわれる場合は、その施策を見送ってください。
- すべてのセクションで価値を提供してください。埋め草の段落は不要です。教える、納得させる、楽しませる内容がないセクションは削除してください。
- ユーザーがブランドのトーンを指定している場合は、それに合わせてください。明確でない場合は確認してください。
- YMYL(健康、金融、法律)に関するトピックでは、主張に特に注意し、信頼できる情報源を十分に引用してください。