serp-keyword-harvester

SERP キーワード収集ツール

このスキルは、設計前のパイプラインに向けて、検索需要の生データを準備します。最終的なサイト構成やソース／プロキシの方針は決定しません。設定ゲートは serp-source-configurator が管理し、このスキルは構造化した入力を semantic-core-builder に引き渡します。

動作モード

• plan：シードキーワード、ロケール、ソース、承認、フォールバックを定義します。
• harvest-local：ユーザー提供のキーワード、エクスポートした CSV、既存サイトのテキスト、ローカルレポートを正規化します。
• harvest-external：承認済みの SERP／オートコンプリート API またはツールを使用します。ネットワークを呼び出す前に承認が必要です。
• audit：既存の reports/keyword-harvest.json を確認します。

必須ワークフロー

1. references/keyword-harvest-contract.md を読みます。
2. OpenSERP、AKE、プロキシ、API キー、エンジンのチェックボックス、ソース設定、有料プロキシの上限に言及がある場合は、まず設定を serp-source-configurator に依頼し、引き渡された reports/serp-source-config.json（機密情報を除去済み）を使用します。
3. OpenSERP がすでに承認済み／設定済みの場合は、references/openserp-setup.md を読み、assets/openserp-settings.example.json は認証情報の保存場所ではなく、機密情報を除去した契約としてのみ使用します。
4. プライバシーと承認モードを確認します。
   • ローカル入力およびユーザー提供の公開情報：使用可能です。
   • 外部 SERP／API／クロール：明示的な承認が必要です。
   • 非公開／認証が必要なソース：明示的な承認に加え、データ取り扱いに関する注記が必要です。
5. シードキーワード、市場／ロケール、プロジェクトの種類、ソースの来歴を収集または正規化します。
6. assets/keyword-harvest.schema.json をフィールドの契約として使用し、reports/keyword-harvest.json を作成または更新します。
7. データグループごとに Ran、Skipped、Planned、Manual のいずれかをラベル付けします。
8. semantic-core-builder に引き渡します。不足している SERP の証拠を捏造してはいけません。

安全ルール

• 承認なしに外部サービスをスクレイピングしたり、呼び出したりしてはいけません。
• API キー、Cookie、非公開 URL、リカバリーコード、.env の値をレポートに保存してはいけません。
• OpenSERP は optional-cloud／external-network として扱います。明示的な承認、設定済みの認証情報、クエリの範囲、ソース設定、データ転送に関する注記がそろうまでは呼び出してはいけません。
• すでに明示されていない場合、このスキル内でプロキシプロバイダー、有料予算、エンジンの選択を決定してはいけません。serp-source-configurator を使用します。
• 検索 API が 429／503 を返した場合、または利用できない場合は、ソースを Skipped として記録し、ローカル入力／ユーザー提供の入力を使って続行します。

引き渡し形式

Mode:
Locale/market:
Seed keywords:
Sources used:
Sources skipped:
Source config:
Output path:
Privacy/approval note:
Next skill: semantic-core-builder

検証

このスキルを編集するときは、次を実行します。

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/serp-keyword-harvester
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/serp-keyword-harvester