# 週次SEOプラン：AIエージェント向けの手順書

このページはAIエージェント向けに書かれています。週に1回、Claude、ChatGPTなど、ご利用のMCPクライアントに次の1行を貼り付けます。

> `https://kafkai.com/ja/docs/weekly-seo-plan.md を読んで、サイトの週次SEOプランを実行してください。`

ほかに2つの始め方があります。

- **プロンプトとして実行する**：クライアントがKafkaiのプロンプトを一覧表示する場合は、`kafkai_weekly_seo_plan` を選択します。
- **スキルとして導入する**：クライアントがスキルに対応している場合は、[スキルファイル](https://kafkai.com/docs/weekly-seo-plan/skill.zip)を一度導入し、「週次SEOプランを実行して」と依頼します。

ここから先は、エージェント向けの内容です。

## エージェントの役割

Kafkaiのお客様が、週次SEOプランを依頼しました。Kafkaiがプロジェクトについて保存しているデータを読み、今週の施策を3つ、優先順に提案します。お客様が書いた言語で返答します。質問は1回に1つだけにします。

名前が `kafkai_` で始まるツールを利用できない場合は、[Kafkaiを使わない場合](#kafkaiを使わない場合)に進みます。

## 開始前の確認

1. `kafkai_list_projects` を呼び出します（無料）。プロジェクトが複数ある場合は、対象のプロジェクトを尋ねます。プロジェクトがない場合は、https://kafkai.com/ja/docs/onboarding.md を案内して終了します。
2. `kafkai_get_project_summary` を呼び出します（無料）。`last_research`、競合サイトの一覧、`backlinks`、`search_console.status` を読みます。
3. `last_research.status` が `pending` の場合は、調査が実行中です。その旨を伝えて終了します。調査が完了してからプランを実行します。
4. データの日付を確認します。順位、キーワード、被リンクのデータは、最後の全体調査の時点のものです。`last_research.kind` が `update` で、`last_research.status` が `success` の場合、その日付は `last_research.completed_at` です。最後の調査が `failed` または `partial` の場合や、`kind` が `competitor_add` の場合、その日付は保存データの日付ではありません。データがそれより古い可能性があることを、お客様に伝えます。この日付が30日より前の場合は、日付をお客様に伝え、調査の更新を提案します。更新の料金は、対象サイトの分が500クレジット、競合サイト1件ごとに350クレジットです。このプロジェクトでの合計を伝えます。お客様がその合計に同意するまで、`kafkai_update_keywords` を呼び出さないでください。お客様が更新を希望しない場合は、保存済みのデータで進めます。
5. 検索結果の1ページ目を確認するキーワードを尋ねます。5件までとし、毎週同じキーワードを使います。お客様にリストがない場合は、ステップ2をステップ3の後に実行します。ステップ1とステップ3の結果から5件を提案し、`kafkai_check_search_results` を呼び出す前に確認を取ります。
6. 料金を伝え、お客様の同意を得ます。すべてのステップを実行した場合、プランの料金は約43クレジットです。スキップするステップの分は除きます。`kafkai_get_credit_balance` を呼び出します（無料）。残高が不足する場合は https://kafkai.com/ja/pricing/ を案内して終了します。

## ステップ

各ステップに、料金とスキップの条件を記載しています。スキップしたステップについては、何をスキップしたかと、有効にする方法を、レポートに1行で記載します。

### ステップ1：順位の変動

このステップは、全体調査が直近7日以内に完了している場合にだけ実行します。新しい調査がなければ、結果は先週と同じです。スキップして、データの日付を伝えます。

`kafkai_get_ranking_changes` を `days=7`、`limit=20` で呼び出します。最初に `summary` を読み、次に変動の大きいキーワードを読みます。重要な変動には、考えられる理由を添えます。推測の場合は、推測であることを明記します。

料金：約4クレジット。

### ステップ2：検索結果の1ページ目

`kafkai_check_search_results` を、開始前の確認で決めたキーワードで呼び出します。Kafkaiは検索結果を新しく取得するため、このステップの結果は毎週変わります。お客様のサイトの位置を報告し、`changes` から、新しく入ったサイト、外れたサイト、順位が動いたサイトを読みます。キーワードを初めて確認したときは、`changes` は `null` です。`domain` が `null` の行は「不明」であり、「存在しない」ではありません。

料金：呼び出し1回につき1クレジット、新しく取得したキーワード1件につき5クレジット。キーワード5件の場合は、最大26クレジットです。

### ステップ3：次に書くキーワード

`kafkai_get_catchup_keywords` を `limit=20` で呼び出します。競合サイトが順位を持っていて、お客様のサイトがまだ順位を持っていないキーワードです。プロジェクトに競合サイトがない場合は、この呼び出しをスキップします。続けて `kafkai_get_complement_keywords` を `limit=20` で呼び出します。プロジェクト内のどのサイトもまだ狙っていない関連キーワードです。

次に書くキーワードを3件まで選択します。検索ボリュームが大きく、難易度が低いキーワードを優先します。お客様がすでに記事にしたキーワードは除きます。分からない場合は尋ねます。

料金：約6クレジット。

### ステップ4：被リンクの増減

このステップは、全体調査または被リンクの更新が直近7日以内に完了している場合にだけ実行します。それ以外の場合はスキップして、データの日付を伝えます。お客様から依頼があり、料金に同意するまで、`kafkai_update_backlinks` を呼び出さないでください。

`kafkai_get_backlink_changes` を `competitor_domain="all"`、`days=7` で呼び出します。増減は `period_totals` から読みます。2つの合計値を引き算しないでください。続けて `kafkai_get_link_gaps` を `limit=20` で呼び出します。競合サイト2件以上にリンクしていて、お客様のサイトにはリンクしていないサイトです。連絡する価値のあるサイトを3件まで挙げます。

料金：約4クレジット。

### ステップ5：最初に直す箇所（Search Console）

このステップは、`search_console.status` が `ready` の場合にだけ実行します。それ以外の場合はスキップして、https://kafkai.com/ja/docs/google-search-console/ を案内します。

`kafkai_update_search_console` を呼び出します（無料。取得は1日に1回まで）。取得が開始された場合は、1分ほど待ちます。続けて `kafkai_get_search_console_insights` を `limit=5` で呼び出します。`limit` は指摘の種類ごとに適用されます。`striking_distance` と `ctr_gap` から確認します。最も早く成果につながる指摘です。

料金：約3クレジット。

### ステップ6：レポート

次の順で、短いレポートを作成します。

1. **今週の施策を3つ、優先順に**：それぞれに、実施する内容、対象のページまたはキーワード、根拠となる数値を記載します。
2. **変化のまとめ**：順位、検索結果の1ページ目、被リンクを、それぞれ1〜2行で記載します。
3. **スキップしたステップ**：1行ずつ、有効にする方法とあわせて記載します。
4. **データの日付と料金**：最後の調査の日付と、今回消費したクレジット数を記載します。消費したクレジット数は、各応答の `_usage` または `billing` に含まれます。

1つ目の施策について、記事の執筆やページの修正を提案します。依頼がない限り、開始しないでください。

## Kafkaiを使わない場合

ステップ2、5、6は、手作業が増えますが、Kafkaiなしでも実行できます。

- **ステップ2**：キーワードごとにWebを検索し、1ページ目のサイトを一覧にします。翌週に比較できるよう、一覧を保存します。
- **ステップ5**：直近28日間とその前の28日間について、Search Consoleの検索クエリのエクスポートをお客様に依頼します。掲載順位が8〜20位のクエリと、表示回数が多くクリック数が少ないクエリを探します。
- **ステップ6**：手元の情報からレポートを作成します。

ステップ1、3、4には、Kafkaiが保存しているデータが必要です。Kafkaiを接続するには、https://kafkai.com/ja/docs/onboarding.md を読みます。サイトの競合を無料で調べるには、https://kafkai.com/ja/find-competitors/ を利用します。

## ルール

- クレジットを消費する呼び出しの前には、必ず消費するクレジット数を伝え、お客様の同意を得てください。
- 保存済みのデータだけを読みます。調査の更新は、お客様が決めます。
- データソースが接続されていないステップはスキップします。未接続のデータソースを「データなし」と報告しないでください。
- 数値には、必ず日付を添えます。
- パスワードやAPIトークンを、この会話に貼り付けるよう求めないでください。
- ツールがエラーを返した場合は、メッセージをお客様に表示し、https://kafkai.com/ja/docs/troubleshooting/ を案内します。
