ドキュメント » プレイブック:週次SEOプラン
週次SEOプラン:AIエージェント向けの手順書
このページはAIエージェント向けに書かれています。週に1回、Claude、ChatGPTなど、ご利用のMCPクライアントに次の1行を貼り付けます。
https://kafkai.com/ja/docs/weekly-seo-plan.md を読んで、サイトの週次SEOプランを実行してください。
ほかに2つの始め方があります。
- プロンプトとして実行する:クライアントがKafkaiのプロンプトを一覧表示する場合は、
kafkai_weekly_seo_planを選択します。 - スキルとして導入する:クライアントがスキルに対応している場合は、スキルファイルを一度導入し、「週次SEOプランを実行して」と依頼します。
ここから先は、エージェント向けの内容です。
エージェントの役割
Kafkaiのお客様が、週次SEOプランを依頼しました。Kafkaiがプロジェクトについて保存しているデータを読み、今週の施策を3つ、優先順に提案します。お客様が書いた言語で返答します。質問は1回に1つだけにします。
名前が kafkai_ で始まるツールを利用できない場合は、Kafkaiを使わない場合に進みます。
開始前の確認
kafkai_list_projectsを呼び出します(無料)。プロジェクトが複数ある場合は、対象のプロジェクトを尋ねます。プロジェクトがない場合は、https://kafkai.com/ja/docs/onboarding.md を案内して終了します。kafkai_get_project_summaryを呼び出します(無料)。last_research、競合サイトの一覧、backlinks、search_console.statusを読みます。last_research.statusがpendingの場合は、調査が実行中です。その旨を伝えて終了します。調査が完了してからプランを実行します。- データの日付を確認します。順位、キーワード、被リンクのデータは、最後の全体調査の時点のものです。
last_research.kindがupdateで、last_research.statusがsuccessの場合、その日付はlast_research.completed_atです。最後の調査がfailedまたはpartialの場合や、kindがcompetitor_addの場合、その日付は保存データの日付ではありません。データがそれより古い可能性があることを、お客様に伝えます。この日付が30日より前の場合は、日付をお客様に伝え、調査の更新を提案します。更新の料金は、対象サイトの分が500クレジット、競合サイト1件ごとに350クレジットです。このプロジェクトでの合計を伝えます。お客様がその合計に同意するまで、kafkai_update_keywordsを呼び出さないでください。お客様が更新を希望しない場合は、保存済みのデータで進めます。 - 検索結果の1ページ目を確認するキーワードを尋ねます。5件までとし、毎週同じキーワードを使います。お客様にリストがない場合は、ステップ2をステップ3の後に実行します。ステップ1とステップ3の結果から5件を提案し、
kafkai_check_search_resultsを呼び出す前に確認を取ります。 - 料金を伝え、お客様の同意を得ます。すべてのステップを実行した場合、プランの料金は約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:レポート
次の順で、短いレポートを作成します。
- 今週の施策を3つ、優先順に:それぞれに、実施する内容、対象のページまたはキーワード、根拠となる数値を記載します。
- 変化のまとめ:順位、検索結果の1ページ目、被リンクを、それぞれ1〜2行で記載します。
- スキップしたステップ:1行ずつ、有効にする方法とあわせて記載します。
- データの日付と料金:最後の調査の日付と、今回消費したクレジット数を記載します。消費したクレジット数は、各応答の
_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/ を案内します。