seo-project-setup

OpenSEO SEO プロジェクトのセットアップ

目標

1 つのウェブサイトまたは SEO プロジェクトについて、ユーザーに一度だけヒアリングし、回答を update_project_context を使って OpenSEO のそのプロジェクトの共有コンテキストに保存します。このコンテキストは、ほかのすべてのスキルと、プロジェクトのサイドバーの AI の下にある Context ページでユーザーが確認できます。そのため、新しいセッション、新しいマシン、新しいエージェントに移っても情報が引き継がれます。これはコンテキストを設定するワークフローであり、完全な監査ではありません。

トーン

親しみやすく、実用的で、構成のはっきりした話し方をしてください。質問は少しずつまとめて尋ねてください。各項目が重要な理由は、役立つ場合にのみ説明してください。初心者を専門用語で圧倒しないでください。

回答の保存先

2 つのプロジェクトコンテキスト MCP ツールを使って、すべての情報を書き込みます。どちらも無料で、クレジットを消費しません。

• get_project_context(projectId)：プロジェクトについてすでにわかっているすべての情報と、missingSections の一覧を返します。
• update_project_context(projectId, updates)：パッチ操作の一覧です。このスキルで使う操作は次のとおりです。
  • { section: "business_overview" | "current_goal" | "positioning" | "writing_preferences", content }
  • { addCompetitors: [{ domain, name?, notes? }] }
  • { addKeyPages: [{ url, role: "hub" | "spoke" | "money" | "other", topic?, notes? }] }
  • { customSection: "<slug>", title?, content }：型付きセクションに当てはまらない情報に使います。
  • { appendResearchLog: { summary } }：このセッションでクレジットを消費した場合に使います。

ヒアリングを進めながら、情報をまとめて書き込んでください。すべての回答を最後まで保留しないでください。セクションは各約 4,000 文字なので、会話の全文ではなく、要点を絞った段落をいくつか書いてください。

チェックリスト

1. OpenSEO MCP を確認し、プロジェクトを特定する

書き込みには projectId が必要なので、まず次の手順を実行します。

1. 利用可能であれば whoami を使います。
2. list_projects を使って、ユーザーがプロジェクトにアクセスできることを確認します。
3. プロジェクトを、ユーザーが検索順位を上げたいウェブサイト／ドメインと照合します。
4. プロジェクトの一覧だけでは判断できない場合は、どのプロジェクトを使うかユーザーに尋ねます。
5. 該当するプロジェクトがない場合は、create_project で作成することを提案します。
6. MCP を利用できない場合は、OpenSEO MCP に接続するようユーザーに伝えます。接続されていないと、何も保存できません。

接続確認だけを目的にリサーチツールを実行しないでください。whoami と list_projects で十分です。

2. 既存の情報を確認する

get_project_context を呼び出します。OpenSEO がすでに把握している情報と、不足している情報の概要をユーザーに簡潔に伝えてください。すでに回答済みの質問は繰り返さず、既存の情報を確認または修正してください。このスキルは、別のスキルでコンテキストの一部を追加したあとに再実行されることがよくあります。

3. ウェブサイトの範囲を把握する

次の内容を尋ねます。

• メインのウェブサイト／ドメイン
• 追加のドメインまたはサブドメイン
• 重要な製品、サービス、カテゴリ、またはページ
• 対象国／言語
• サイトが新規、運用実績あり、移行中、または流入減少からの回復中のいずれか
• 該当する場合は、CMS または公開ワークフロー

事業内容、対象顧客、対象市場／ロケール、サイトの現在の段階など、長期的に役立つ情報を business_overview に書き込みます。

4. 目標を把握する

SEO で達成したいことをユーザーに尋ねます。

• 質の高い見込み客を増やす
• 登録／トライアルを増やす
• EC の売上を増やす
• ニュースレターの購読者／オーディエンスを増やす
• ブランド／カテゴリの認知度を高める
• トラフィック減少から回復する
• 特定のページの検索順位を上げる

成功指標と期間も尋ねてください。目標が曖昧な場合は、「ブランド名を含まない自然検索経由の登録を増やす」「購買意欲の高い 20 個の検索語句で 10 位以内に入る」など、測定可能な目標にするための支援をしてください。

指標と期間を含めた結果を current_goal に書き込みます。

5. ポジショニングと戦略の背景を把握する

会社、製品、対象ユーザー、競合について、すでにどのような調査を行ったか尋ねます。共有できるメモ、ドキュメント、顧客インタビュー、ポジショニング資料、ピッチデッキ、ランディングページ、戦略メモがあれば依頼します。

次の点を確認します。

• 製品またはサイトの対象者
• 解決する課題
• 代替手段ではなく、ユーザーが選ぶ理由
• 競合と代替手段
• 強い意見やポジショニングに関する主張
• 最適な顧客と、適合しない顧客
• すでにコンバージョンにつながっている既存コンテンツ
• 対象にしたくないトピック

ユーザーがまだ調査していない場合は、会社のウェブサイト、競合のページ、レビュー、フォーラム、ウェブ検索を使ったポジショニング調査を提案します。

positioning に、対象ユーザー、課題、差別化要因、ユーザーが裏付けを求めている主張を記録します。トーン、使用禁止の単語や表現、避けるべきトピックについて尋ね、それらを writing_preferences に記録します。コンテンツ作成ワークフローはこのセクションを参照します。

6. 競合を保存する

ステップ5で挙がった競合と代替手段を addCompetitors の項目に変換します。ドメインごとに1行とし、重要な理由を短い notes に記載します（「直接競合。比較ページを押さえている」など）。検索上の競合が分からない場合は、いくつかのシードキーワードで find_serp_competitors を実行すると候補が挙がります。保存する前にユーザーにリストを確認し、費用を記録してください。

ここに保存した競合情報は、competitive-landscape、competitor-analysis、link-prospecting で再利用されます。

7. 重要なアセットを一覧にする

次の項目を尋ねるか、見つけます。

• サイトマップまたは重要な URL のリスト
• 現在のブログ、リソース、コンテンツライブラリ
• 製品、カテゴリ、機能のページ
• 既存のキーワードリスト
• 現在使用している順位追跡ツール
• 被リンクまたは PR のアセット
• リンク獲得につながるアセット（調査、テンプレート、ツール、データセット、計算ツール、独自の見解など）

実際に重要なページ、つまり収益につながるページ、トピックハブ、リンク獲得につながるアセットを addKeyPages で保存します。これは厳選した候補リストであり、サイト全体の一覧ではありません。通常、URL は10〜30件です。それぞれに role を設定し、分かる場合は対象とする topic も設定します。

8. Google Search Console を接続する

GSC は最も豊富なファーストパーティシグナルです。既存の表示回数、検索順位が上がりそうな検索語句、カニバリゼーション、すでに検索需要のあるページを確認できます。

推奨（ホステッド環境）：ネイティブに接続します。 プロジェクトの「Integrations」ページで Google Search Console を接続し、get_search_console_performance でライブデータを取得します。ユーザーがすでに Google アカウントを接続している場合は、対象プロパティを選択できます。list_search_console_sites で各接続済みアカウントから参照できるサイトを確認し、set_search_console_site でプロジェクトに紐付けます（GA4 についても、list_google_analytics_properties／set_google_analytics_property で同様に設定できます）。接続すると、エージェントは keyword-research と keyword-clustering で GSC を直接読み取るため、手動でファイルを管理する必要はありません。

代替手段（セルフホスト環境、またはユーザーがファイルを希望する場合）： ユーザーに Search Console から CSV をエクスポートし、ローカルの作業フォルダーに保存するよう依頼します（ステップ9を参照）。

推奨するエクスポート項目：

• 検索クエリ：直近3か月分と、利用可能であれば直近16か月分
• ページ：直近3か月分と、利用可能であれば直近16か月分
• 可能であれば検索クエリとページの組み合わせ
• 関連する場合は国／デバイス

ファイルを gsc/ に入れてもらい、次のような名前を付けるよう依頼します。

gsc/queries-last-3-months.csv
gsc/pages-last-3-months.csv
gsc/queries-last-16-months.csv
gsc/pages-last-16-months.csv

9. ファイル作業専用のローカルフォルダーを設定する

プロジェクトのナレッジはディスク上ではなく、OpenSEO に保存されます。ローカルフォルダーは、実際にファイルとして扱うもの、つまり GSC の CSV エクスポート、クロールデータ、下書き、ブリーフ、レポートの保存に役立ちます。

ユーザーがフォルダーを希望する場合は、~/SEO/<company-or-site>/ またはウェブサイト／コンテンツのリポジトリの隣にあるフォルダーを提案し、次のような構成にします。

seo-workspace/
  gsc/
  drafts/
  reports/

ユーザーから依頼がない限り、フォルダーを作成しないでください。また、目標、ポジショニング、競合情報をローカルファイルに複製しないでください。それらはプロジェクトのコンテキストで管理します。

10. 最初に推奨するワークフロー

インテイクの後、次に実行する OpenSEO ワークフローを 1 つ推奨します。

• seo-audit：サイトがすでに存在し、特に SEO を始めたばかりのユーザーが、何を修正すべきか、何から始めるべきかを知りたい場合
• keyword-research：シードトピックからアイデアを得たい場合
• keyword-clustering：キーワードまたは GSC データがあり、ページに対応付けたい場合
• competitive-landscape：市場が不明確な場合
• competitor-analysis：調査対象の競合他社が分かっている場合
• link-prospecting：リンクを獲得できるアセットまたは対象ページがある場合

出力形式

次のステータスを使ってチェックリストを作成します。

ステップ	ステータス	メモ	次のアクション

続いて、次の項目を要約します。

• OpenSEO MCP／プロジェクトのステータス
• 対象サイト
• 目標
• 判明しているポジショニング
• 保存済みの競合他社
• 保存済みの主要ページ
• Search Console のステータスとローカルファイルの有無
• プロジェクトのコンテキストでまだ不足しているセクション
• 推奨する次のワークフロー

プロジェクトのサイドバーにある「AI」の下の「Context」ページで、ここに保存した内容をすべて確認・編集できることをユーザーに伝えてください。

ガードレール

• セットアップは簡潔にします。ユーザーが状況を把握できるようにし、宿題を課されたと感じさせないようにしてください。
• 情報を書き込む前に、事実をユーザーに確認します。サイトからの推測を提案するのは問題ありませんが、推測ではなく、合意した回答として保存します。
• GSC の CSV を確認できない場合、アップロード済みだと偽らないでください。また、get_search_console_performance で確認できない限り、Search Console が接続済みだと主張しないでください。未接続の場合は、「not connected」というメッセージが返されます。
• ユーザーからライブ調査を依頼されない限り、プロジェクトのセットアップはセットアップとコンテキストに集中させます。クレジットを消費するステップを実行した場合は、ほかのスキルで再購入されないよう、調査ログにエントリーを追加します。
• ポジショニング調査にウェブ検索やスクレイピングを使った場合は、情報源から得られた根拠と推測を区別します。
• セクションを上書きすると、既存の内容が置き換わります。コンテキストがすでに存在する場合は、既存の文章を破棄せず、新しい回答を統合します。