setup-openseo について
setup-openseoは、AIエージェントへのOpenSEO導入を案内するスキルで、接続とスキルの設定を扱います。ホスト型とセルフホスト型を区別し、設定完了の前に動作確認を求めます。
主な機能
- 01エージェントの種類と既存のOpenSEO設定を確認
- 02プラグインまたはMCP接続の導入を案内
- 03対応環境では公開SEOスキルをインストール
- 04ホスト型とセルフホスト型の認証手順を区別
- 05再読み込み後にツールとスキルを検証
活用シーン
- 01対応するコーディングエージェントにOpenSEOを設定
- 02ホスト型またはセルフホスト型接続を構成
- 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 をインストールすることはできません。コマンドを実行したり、ファイルを編集したりしないでください。代わりに、以下の手順を案内して、そこで止めてください。
- ChatGPT 用 OpenSEO プラグインを開き、Install plugin を選択します。
- OpenSEO にサインインし、接続を承認します。
- 新しいチャットを開始し、+ メニューから 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語以内とし、次のテンプレートに従ってください。
状況 [成功したこと、またはセットアップを妨げた要因を簡潔に伝えます。]
次の手順
- [必要な場合のみ、このエージェントでのネイティブな再読み込みコマンドまたは UI 操作を示します。]その後、「OpenSEO が接続されていることを確認してください。」と伝えます。サインインを求められた場合は承認してください。
- 次のいずれかを試します。
- [SEO Audit の呼び出し方法](推奨) — ウェブサイトの主な SEO の問題を見つけます。
- [SEO Project Setup の呼び出し方法]— ウェブサイトについて質問し、プロジェクトのコンテキストを設定します。
- [Keyword Research の呼び出し方法]— 対象にする価値のあるキーワードを見つけます。
- [Local SEO の呼び出し方法]— Google ビジネス プロフィールと地域の競合他社を確認します。
何をセットアップしたか知りたい場合は、お尋ねください。
実際の結果に合わせてテンプレートを調整してください。
- Claude Cowork のように、プラグインを手動でインストールする必要がある場合は、ステップ 1 をクリック操作に置き換えてください。
- インストールに失敗した場合は、妨げとなった要因を示し、再読み込みの代わりに解決策を記載してください。完全に確認できた場合は、準備完了と伝え、再読み込みの案内は省略してください。ツールの再読み込みが必要というだけの理由で、サインインに失敗した、またはサインインが必要だと伝えてはいけません。
- インストール済みの各スキルを呼び出す際は、このエージェントに適した方法を案内してください。ネイティブなコマンド、メンション、ピッカー、または自然言語での依頼を使用します。検出されたスキル名とプラグインの名前空間を使い、どの環境でも
/skill-nameが使えると決めつけたり、無理に使えるようにエイリアスを作成したりしてはいけません。使い方が不明な場合は、エージェントのヘルプまたは公式ドキュメントを確認してください。スキルがサポートされていない場合は、接続済みのツールを使った同等の自然言語での依頼を案内してください。ワークフローを推奨するだけにとどめ、インストール中に実行してはいけません。 - whoami や list_projects などのツール名は確認時にのみ使用し、最終返信には含めないでください。妨げとなる要因を説明する場合や、私から求められた場合を除き、バージョン、パス、接続の詳細、スキル数、その他の連携、クリーンアップコマンドは省略してください。セクションを追加したり、確認チェックリストを加えたりしてはいけません。