mcpField
S
setup-openseo

setup-openseo

github.com/every-appマーケティング・グロース25.5k135 回インストール2 日前に更新
リポジトリ

setup-openseo について

setup-openseoは、AIエージェントへのOpenSEO導入を案内するスキルで、接続とスキルの設定を扱います。ホスト型とセルフホスト型を区別し、設定完了の前に動作確認を求めます。

主な機能

  1. 01エージェントの種類と既存のOpenSEO設定を確認
  2. 02プラグインまたはMCP接続の導入を案内
  3. 03対応環境では公開SEOスキルをインストール
  4. 04ホスト型とセルフホスト型の認証手順を区別
  5. 05再読み込み後にツールとスキルを検証

活用シーン

  1. 01対応するコーディングエージェントにOpenSEOを設定
  2. 02ホスト型またはセルフホスト型接続を構成
  3. 03設定の問題を調べ、利用可能なプロジェクトを確認

MCP 対応

互換性のあるエージェントにOpenSEOのMCPエンドポイントを追加し、ツールへのアクセスを確認する手順を案内します。ホスト型では https://app.openseo.so/mcp を使い、セルフホスト型では独自のエンドポイントを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/every-app/open-seo --skill setup-openseo

インストール後、Claude Code で/setup-openseoを入力して読み込まれたか確認します。

詳細

このエージェントに OpenSEO を設定してください。できる範囲で作業し、私の入力が必要な場合は手順を案内してください。

1. このエージェントを確認する

  • このエージェントとそのバージョンを特定してください。特定できない場合に限り、質問してください。
  • 既存の OpenSEO 接続があるか確認してください。他の連携は維持し、重複を避けてください。
  • OpenSEO のスキルも別途確認してください。スキルのない接続は不完全です。

2. ChatGPT の場合

これを通常の ChatGPT の会話(Codex ではなく、ウェブ版またはデスクトップアプリ)に貼り付けた場合、ここから OpenSEO をインストールすることはできません。コマンドを実行したり、ファイルを編集したりしないでください。代わりに、以下の手順を案内して、そこで止めてください。

  1. ChatGPT 用 OpenSEO プラグインを開き、Install plugin を選択します。
  2. OpenSEO にサインインし、接続を承認します。
  3. 新しいチャットを開始し、+ メニューから OpenSEO を選択して、次のように送信します:「OpenSEO を使って接続を確認し、プロジェクトの一覧を表示してください。」

このプラグインは、ホスト型 OpenSEO にのみ接続します。https://app.openseo.so/mcp が openseo.so 上にない場合(セルフホストの場合)、またはお使いのアカウントでプラグインを利用できない場合は、そのサーバー URL を使って ChatGPT セットアップガイドのカスタム接続手順を案内してください。ChatGPT には、インターネットからアクセス可能な HTTPS URL が必要です。Codex を使っている場合は、以下に進んでください。

3. まずプラグインをインストールする

公式プラグインには MCP と SEO スキルがまとめられており、OpenSEO の名前空間と共通のアップデートが適用されます。

  • Codex: プラグインガイドに従ってください。
  • Claude Code: プラグインガイドに従ってください。
  • Claude Cowork または Claude デスクトップアプリ: このチャットからプラグインをインストールすることはできないため、コマンドを実行しないでください。Customize(Cowork の場合は、まず Cowork タブ)→ Plugins → + または Add → Add marketplace → Add from a repository を開き、https://github.com/every-app/open-seo を入力して、OpenSEO をインストールするよう案内してください。その後、新しいタスクを開始して / と入力し、OpenSEO のスキルが表示されることを確認してもらいます。すでにカスタム OpenSEO コネクターを使っている場合は、プラグインでサインインした後に一度削除してもらいます。プラグインの利用には有料プランが必要です。このプラグインはホスト型 OpenSEO にのみ接続するため、https://app.openseo.so/mcp が openseo.so 上にない場合(セルフホストの場合)、または Free プランを利用している場合は、プラグインを使わないでください。代わりに、Customize → Connectors → Add custom connector からそのエンドポイントを追加し、Customize → Skills で公開スキルをアップロードしてもらいます。その後、ステップ 5 に進んでください。
  • その他のエージェント: 現行のドキュメントでプラグインとの互換性を確認してください。
  • コマンドを実行する前に、インストール済みクライアントのヘルプを確認してください。

4. MCP とスキルを使う代替手順

プラグインがサポートされていない場合:

  • MCP ガイドに従って、https://app.openseo.so/mcp を追加してください。
  • このエージェントにのみ公開 SEO スキルをインストールしてください。
  • 内部リポジトリのスキルをコピーしたり、同梱済みのスキルを重複して追加したりしないでください。
  • スキルがサポートされていない場合は、MCP のみを使い、ワークフローガイドへのリンクを案内してください。

セルフホスト型 OpenSEO では、エンドポイントを直接使ってください。公式プラグインはホスト型サービスを対象としています。

5. サインインする

  • ホスト型 OpenSEO: OAuth を優先し、ブラウザーでログインを承認してもらってください。このクライアントが OAuth を使えない場合は、https://app.openseo.so/settings → API keys に案内してください。クライアントのシークレット設定または環境変数にキーを入力してもらい、チャットやリポジトリには入力しないでください。
  • セルフホスト型 OpenSEO: デプロイ環境の認証手順に従ってください。認証なしで設定されたローカルサーバーでは、OAuth も OpenSEO API キーも必要ありません。Cloudflare Access を使ったデプロイでは、セルフホストガイドに従って、MCP クライアント用の Managed OAuth を設定してください。
  • 手動での設定が必要な場合: このエージェントの現行ドキュメントを使い、私自身が行う必要のある手順だけを案内してください。

6. 再読み込みと確認

  • 現在のエージェントに対応したネイティブな再読み込み手順を使用し、インストール済みのバージョンやヘルプ、公式ドキュメントを確認してください。自動検出またはその場での再読み込みを優先し、新しいツールやスキルの読み込みに必要な場合に限り、再起動してください。
  • このセッションでツールが読み込まれたら、whoami と list_projects を実行してください(どちらも無料の読み取り操作です)。スキルの検出状況も確認してください。再読み込みに私の操作が必要な場合は、利用できないツールを何度も再試行せず、手順を案内してください。
  • インストール、サインイン、確認はそれぞれ別に管理してください。サーバーに接続されていても、このセッションでツールを使えることの証明にはなりません。無料の読み取り操作が成功する前に、確認済みだと伝えてはいけません。
  • list_projects の結果にプロジェクトがない場合は、私のウェブサイトを尋ね、create_project を使ってそのウェブサイトのプロジェクトを作成してください。プロジェクトの作成にクレジットは必要ありません。
  • インストール中に有料のリサーチを実行してはいけません。

7. 簡潔な引き継ぎで完了する

進捗報告は簡潔にしてください。最終返信は140語以内とし、次のテンプレートに従ってください。

状況 [成功したこと、またはセットアップを妨げた要因を簡潔に伝えます。]

次の手順

  1. [必要な場合のみ、このエージェントでのネイティブな再読み込みコマンドまたは UI 操作を示します。]その後、「OpenSEO が接続されていることを確認してください。」と伝えます。サインインを求められた場合は承認してください。
  2. 次のいずれかを試します。
    • [SEO Audit の呼び出し方法](推奨) — ウェブサイトの主な SEO の問題を見つけます。
    • [SEO Project Setup の呼び出し方法]— ウェブサイトについて質問し、プロジェクトのコンテキストを設定します。
    • [Keyword Research の呼び出し方法]— 対象にする価値のあるキーワードを見つけます。
    • [Local SEO の呼び出し方法]— Google ビジネス プロフィールと地域の競合他社を確認します。

何をセットアップしたか知りたい場合は、お尋ねください。

実際の結果に合わせてテンプレートを調整してください。

  • Claude Cowork のように、プラグインを手動でインストールする必要がある場合は、ステップ 1 をクリック操作に置き換えてください。
  • インストールに失敗した場合は、妨げとなった要因を示し、再読み込みの代わりに解決策を記載してください。完全に確認できた場合は、準備完了と伝え、再読み込みの案内は省略してください。ツールの再読み込みが必要というだけの理由で、サインインに失敗した、またはサインインが必要だと伝えてはいけません。
  • インストール済みの各スキルを呼び出す際は、このエージェントに適した方法を案内してください。ネイティブなコマンド、メンション、ピッカー、または自然言語での依頼を使用します。検出されたスキル名とプラグインの名前空間を使い、どの環境でも /skill-name が使えると決めつけたり、無理に使えるようにエイリアスを作成したりしてはいけません。使い方が不明な場合は、エージェントのヘルプまたは公式ドキュメントを確認してください。スキルがサポートされていない場合は、接続済みのツールを使った同等の自然言語での依頼を案内してください。ワークフローを推奨するだけにとどめ、インストール中に実行してはいけません。
  • whoami や list_projects などのツール名は確認時にのみ使用し、最終返信には含めないでください。妨げとなる要因を説明する場合や、私から求められた場合を除き、バージョン、パス、接続の詳細、スキル数、その他の連携、クリーンアップコマンドは省略してください。セクションを追加したり、確認チェックリストを加えたりしてはいけません。

コメント