seo-implement

/digital-marketing-pro:seo-implement

スクリプトの場所。 ホストで ${CLAUDE_PLUGIN_ROOT} が設定されていない場合、スクリプトはこのプラグインの scripts/ フォルダー内の skills/ と同じ階層にあります。Python 3.10 以降で実行してください。python が見つからない場合（macOS、多くの Linux システム）は python3 を使用してください。

目的

接続済みの CMS プラットフォームで SEO の実装変更を実行します。分析にとどまらず、メタタグの更新、JSON-LD スキーママークアップのデプロイ、canonical URL の管理、301/302 リダイレクトの作成、インデックス登録のリクエストを、WordPress または Webflow の MCP 接続を通じて実際に行います。このコマンドは、SEO の推奨事項を実際のサイトへ反映する橋渡しを行い、監査結果や最適化計画が、完全な監査証跡とロールバック機能を備えたページ単位の変更として確実に適用されるようにします。

実行ゲート（必須 — 省略不可）

1. ライブページに触れる前に、すべてのメタ／スキーマ／canonical／リダイレクト変更について、変更前後の差分に加え、適用範囲とコンプライアンスを含む完全なプレビューを 実行サマリー として提示してください。
2. ユーザーは yes（または同等の明示的な承認）を入力する必要があります。それ以外の入力は、曖昧、暗黙、部分的、または承認なしのいずれであっても、実行をキャンセルします。
3. 曖昧な入力を根拠に処理を進めてはいけません。失敗した実行を自動で再試行してはいけません。再実行する前に、人による確認が必要です。
4. ユーザーが yes を入力した後に限り、承認を記録してください。python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"seo-implement","platform":"<platform>","content_summary":"<実行サマリーからの一行>","risk_level":"<tier>"}' を実行し、続けて python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id} を実行してください。どちらかのコマンドでエラーが発生した場合は停止してエラーを報告してください。別のツールを使って回避してはいけません。この記録は、このアクションについて承認手順が実行されたことを証明しますが、誰が yes を入力したかまでは証明できません。
5. 実行してください。connector_executor.py を通じて送信する書き込みには --approval-id が必要であり、一致する未使用かつ有効期限内の記録がある場合にのみ実行されます（/digital-marketing-pro:execute-action を参照）。接続済み MCP サーバーのツールを通じた書き込みは、このコードによるチェックの対象外です。ユーザーが入力した yes と、ホストの権限確認プロンプトに依存します。その後、python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（または failure）を実行してください。

必要な入力

ユーザーは次の情報を指定する必要があります（または入力を求められます）。

• 対象 URL：変更する 1 つ以上の URL。対象を絞った更新では単一ページを指定し、サイト全体へのスキーマ適用や移行に伴うメタタグ更新などの一括操作では複数の URL を指定します。
• 変更の種類：実行する SEO 変更。meta-update（タイトルタグ、メタディスクリプション、robots ディレクティブ）、schema-deploy（JSON-LD 構造化データ）、canonical（canonical URL の設定または更新）、redirect（301/302 リダイレクトの作成）、または indexing-request（Search Console 経由で Google に URL のクロールをリクエスト）のいずれかです。1 つの URL に対して複数の変更の種類を組み合わせることもできます。
• 具体的な値：適用する新しいデータ。新しいタイトルタグのテキストと文字数、新しいメタディスクリプションのテキストと文字数、JSON-LD スキーマオブジェクトまたは自動生成するスキーマの種類（Article、Product、FAQ、HowTo、LocalBusiness、BreadcrumbList）、canonical URL の指定先、リダイレクト元とリダイレクト先および種類（301 または 302）、またはインデックス登録の優先度（normal または urgent）を指定します。
• CMS プラットフォーム：wordpress または webflow。対応する CMS MCP サーバーが接続されている必要があります。WordPress の場合、SEO フィールドの管理に Yoast、RankMath、All in One SEO のどれを使用しているかを指定してください。Webflow の場合は、標準の SEO 設定を直接使用します。

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み込み、有効なスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのトーン、対象市場のコンプライアンスルール（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.json にガイドラインがあるか確認し、存在する場合は制限事項を読み込みます。~/.claude-marketing/sops/ にエージェンシーの SOP があるかも確認します。ブランドが存在しない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. 提案する変更を現在のページ状態と照合して検証する：CMS MCP を通じて、対象 URL ごとに既存のメタタグ、スキーママークアップ、canonical 設定、リダイレクトルールの変更前スナップショットを取得します。提案する変更を SEO のベストプラクティスと照合します。具体的には、タイトルタグの長さ（50～60 文字）、メタディスクリプションの長さ（150～160 文字）、Google の構造化データ要件に照らしたスキーマの有効性、canonical URL のアクセス可能性、リダイレクト先のステータスコードを確認します。
3. URL ごとに変更仕様を作成する：提案する変更を CMS API のフィールドに対応付けます。WordPress の場合は Yoast のメタフィールド（_yoast_wpseo_title、_yoast_wpseo_metadesc）、RankMath の同等フィールド、または AIOSEO のフィールドを使用します。Webflow の場合は、ページの SEO 設定オブジェクトを使用します。スキーマをデプロイする場合は、指定されたタイプ、ページコンテンツ、ブランドデータから有効な JSON-LD を生成するか、ユーザー提供の JSON-LD を schema.org の仕様と Google のリッチリザルト要件に照らして検証します。
4. 承認ゲートを設ける：すべての変更を差分（変更前／変更後）として提示し、ユーザーのレビューを受けます。古いタイトルタグと新しいタイトルタグ、古いスキーマと新しいスキーマ、現在の canonical と提案する canonical を示します。リスクレベルを評価します。単一ページへの単純な変更は medium、5 ページを超えるページに影響する一括更新、リダイレクトの作成、インデックス登録に影響する可能性のある canonical の変更は high とします。推定される影響と警告（例：タイトルが長すぎる、スキーマの必須フィールドが不足している）を表示します。
5. 承認後、CMS MCP を通じて変更を実行する：接続された WordPress または Webflow MCP サーバーを通じて、承認済みの変更をデプロイします。メタ情報を更新する場合は、SEO プラグインのフィールドに新しい値を書き込みます。スキーマの場合は、ページの head または SEO プラグインのスキーマフィールドに JSON-LD を挿入します。リダイレクトの場合は、Redirection プラグイン API、RankMath のリダイレクト機能、または Webflow のネイティブリダイレクト API を通じてルールを作成します。インデックス登録をリクエストする場合は、Google Search Console MCP を通じて URL を送信します。
6. デプロイ後に検証する：CMS から更新後のページデータを読み戻し、変更が反映されたことを確認します。デプロイされた値を承認済みの仕様と照合します。リダイレクトの場合は、HTTP レスポンスコードと転送先をテストします。インデックス登録リクエストの場合は、送信が受け付けられたことを確認します。意図した状態と実際にデプロイされた状態に相違があれば報告します。
7. seo-executor.py を通じてすべての変更を記録する：各変更について、タイムスタンプ、URL、変更タイプ、変更前の状態、変更後の状態、CMS プラットフォーム、承認の参照情報、ロールバックデータを記録します。必要に応じて変更を元に戻せるよう、ロールバック用スナップショットを保存します。

出力

以下を含む、構造化された実装レポートです。

• 変更の確認：URL と変更タイプごとに変更前／変更後を比較し、変更内容を正確に示します。メタタグの文字数とスキーママークアップの検証ステータスも記載します。
• 検証ステータス：デプロイ後の確認結果を記載し、各変更が反映され、承認済みの仕様と一致していることを確認します。相違があれば明示します。
• ロールバック手順：必要に応じて各変更を元に戻す手順を、保存済みのスナップショットとともに段階的に示します。以前のメタ情報の値、削除したスキーマ、削除したリダイレクト、復元した canonical などを記載します。
• 実行ログエントリ：監査証跡用に、タイムスタンプ付きの記録を作成します。変更メタデータ一式、CMS API のレスポンス、承認の参照情報、ロールバックデータを含めます。

使用するエージェント

• seo-specialist — ベストプラクティス（タイトルの長さ、説明文の長さ、スキーマ要件、canonical のロジック、リダイレクトルール）に基づく変更前の SEO 検証、SEO フィールドを CMS API パラメーターに対応付ける変更仕様の生成、schema.org および Google の構造化データガイドラインに準拠した JSON-LD スキーマの生成と検証、デプロイ後の SEO の正確性の検証
• execution-coordinator — WordPress（Yoast、RankMath、AIOSEO、Redirection プラグイン）および Webflow（標準の SEO 設定とリダイレクト API）向けの CMS MCP 実行、変更の範囲と種類に応じたリスク評価を伴う承認ワークフロー、ロールバックデータの取得と保存、完全な監査証跡を含む実行ログ