mcpField
S
serp-source-configurator

serp-source-configurator

github.com/sergekostenchukマーケティング・グロース3249 回インストール18 週間前に更新
リポジトリ

serp-source-configurator について

検索需要の収集前に、ソースを設定・管理するスキルです。秘匿情報を除いた承認対応の設定を作成し、予算と準備状況を確認してからキーワード収集スキルへ引き継ぎます。自身でキーワードを収集するものではありません。

主な機能

  1. 01ソース設定画面の設計
  2. 02秘匿情報を除いたソース設定の作成と監査
  3. 03ソースの承認状況とプロキシ準備状況の確認
  4. 04クエリ、エンジン、キャッシュ、タイムアウトの上限設定
  5. 05承認済み設定をキーワード収集スキルへ引き継ぎ

活用シーン

  1. 01SERP調査前のソース設定を準備
  2. 02設定内の秘密情報や承認漏れを監査
  3. 03クエリ予算とプロキシ失敗時の扱いを設定

インストール

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

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill serp-source-configurator

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
source-config.template.json
references/
decision-framework.md
safety-boundaries.md
ui-controls.md
scripts/
validate_serp_source_config.py

詳細

SERP ソース設定ツール

このスキルは、検索需要の収集前に必要なセットアップを担当します。キーワードの収集自体は行わず、機密情報を伏せた承認対応のソース設定を作成し、serp-keyword-harvester に引き渡します。

運用モード

  • design-ui：ソース設定パネルに表示するユーザー向けのフィールド、チェックボックス、ステータス、安全なデフォルト値を定義します。
  • configure：機密情報を伏せた reports/serp-source-config.json を作成または更新します。
  • preflight：OpenSERP／ベース URL／プロキシの準備状況を確認し、Ran、Skipped、Planned のいずれかを記録します。
  • budget-gate：クエリ数の上限、エンジン数の上限、キャッシュ TTL、タイムアウト、有料プロキシのルールを設定します。
  • audit：既存のソース設定を確認し、秘密情報、承認漏れ、安全でない有料設定、不明瞭な引き継ぎがないかをチェックします。

必須のワークフロー

  1. references/decision-framework.md を読みます。
  2. プロキシプロバイダー、API キー、OpenSERP、AKE、有料トラフィック、または外部ネットワークへの呼び出しが関係する場合は、references/safety-boundaries.md を読みます。
  3. UI／ダッシュボードの依頼では、references/ui-controls.md と assets/source-config.template.json を使用します。
  4. ソースを分類します。
    • ローカル／手動入力：デフォルトで許可されます。
    • OpenSERP の直接エンジン：外部クエリを実行する前に承認が必要です。
    • プロキシ経由のエンジン：承認に加え、予算とプロキシの事前チェックが必要です。
    • 有料のプロバイダー操作またはアカウントを変更する操作：実行直前に明示的な確認が必要です。
  5. API キー、プロキシ認証情報、Cookie、リカバリーコード、.env の値を、Markdown、HTML、タスク計画、Wiki のメモ、レポート、スクリーンショット、エクスポートされた JSON に保存しないでください。
  6. 機密情報を伏せた設定と、env:AKE_API_KEY などの実行時参照のみを書き込みます。
  7. scripts/validate_serp_source_config.py でソース設定を検証します。
  8. 承認、選択したエンジン、上限、失敗時の動作が明確になってから、serp-keyword-harvester に引き渡します。

システム上の役割

SEO／サイトアーキテクチャ層とキーワードハーベスターの間で、このスキルを使用します。

seo-llm-site-architect
-> serp-source-configurator
-> serp-keyword-harvester
-> semantic-core-builder

serp-source-configurator は、ソース設定、プロキシのゲート、認証情報の取り扱い、予算上限、事前チェックのステータスを担当します。serp-keyword-harvester は、実際のキーワード／SERP の根拠収集を担当します。

出力基準

Mode:
Selected sources:
Disabled sources:
Proxy mode:
Credential handling:
Approval status:
Budget limits:
Preflight:
Output config:
Skipped/planned checks:
Next skill: serp-keyword-harvester

安全ルール

  • OpenSERP とプロバイダー API は external-network として扱います。
  • ユーザーが入力した API キーは実行時入力としてのみ扱い、成果物を書き込む前に伏せてください。
  • ユーザーから個別の操作を明示的に依頼されない限り、プロバイダーのプロキシポートを作成、更新、ローテーション、購入、変更しないでください。
  • まず直接利用できる無料エンジンを優先してください。有料プロキシは、通常は Google／Yandex のように必要なエンジンに限って使用します。
  • プロキシの事前チェックに失敗した場合、プロキシソースは Skipped のままにし、直接／手動のソースを続行します。
  • 有料プロキシで失敗した場合、過度に再試行しないでください。

検証

このスキルを編集した場合は、次を実行します。

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/serp-source-configurator
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/serp-source-configurator
python3 $CODEX_HOME/skills/serp-source-configurator/scripts/validate_serp_source_config.py $CODEX_HOME/skills/serp-source-configurator/assets/source-config.template.json

コメント

Markdown 対応