linkfox-seerfar-ozon-keyword-mining

Seerfar Ozon キーワードマイニング

このスキルは、Seerfar の分析データベースでシードキーワードを中心にOzon マーケットプレイスのキーワードをマイニングし、検索ボリューム、30 日間の成長率、商品数／販売者数／競合数、平均価格、関連性、タイトル密度、カート追加コンバージョン率など、豊富なパフォーマンス指標で見つかった用語を絞り込みます。マイニングされた各キーワードには、市場プロフィール一式（市場規模、返品／キャンセル率、人気商品、中国語訳）が付属するため、Ozon のキーワード拡張、ロングテールキーワードの発見、シード用語の機会分析の出発点となります。

基本概念

市場を閲覧するのではなく、シードから展開：市場キーワード検索とは異なり、このエンドポイントではkeyword（シード）が必須で、シードに関連する用語が市場指標とともに返されます。すでに考えている用語から外側へと展開します。

関連性がマイニングの指標：relevancyは、マイニングされた用語がシードにどの程度関連するかを示します（シード用語自体はrelevancy: 100で返され、関連用語はそれより低い順位になります）。titleDensityは、その用語が商品タイトルにどれほど高密度で含まれているかを示します。どちらもすべての行に設定されます。トピックに沿った展開を維持するには、relevancyの降順で並べ替えてください。

プラットフォームの対象範囲：各キーワードレコードにはplatformフィールドがあります（0＝Ozon、1＝Wildberries）。データセットはOzonを中心としており、利用可能な場合はWildberriesの行も含まれます。プラットフォームを限定する入力項目はありません。必要に応じてクライアント側で絞り込んでください。

一致モード：matchTypeは、シードのkeyword（およびincludeKeywords）の一致方法を制御します。0は完全一致、1はあいまい一致です。幅広く展開するにはあいまい一致、絞り込むには完全一致を選択してください。

日付やカテゴリの選択項目はありません：このエンドポイントではsearchDateやcategoriesを受け付けません。月ごとの比較やカテゴリ別の閲覧が必要な場合は、代わりに市場キーワード検索スキルを使用してください。

パラメーター

パラメーター	型	必須	説明
keyword	string	はい	シードキーワード。これを中心にマイニングを展開します（maxLength 1000）。
page	object	はい	ページネーション{page, pageSize, orders[]}。pageは1から（デフォルトは1）、pageSizeのデフォルトは20です。orders[]は{field, direction}で、directionはDESC／ASCです。
matchType	integer	いいえ	キーワードの一致モード：0は完全一致、1はあいまい一致です。
includeKeywords	array	いいえ	必ず含める用語（最大1000）。展開範囲を絞り込みます。
excludeKeywords	array	いいえ	除外する用語（最大1000）。関連性の低い展開結果を除きます。
wordCount	{min,max}	いいえ	キーワードの単語数／文字数の範囲です。
searchVolume	{min,max}	いいえ	月間検索ボリュームの範囲です。
searchChange30	{min,max}	いいえ	30日間の検索変化の範囲です。
productViews	{min,max}	いいえ	商品閲覧数の範囲です。
products	{min,max}	いいえ	商品数の範囲です。
sellers	{min,max}	いいえ	販売者数の範囲です。
price	{min,max}	いいえ	平均価格の範囲です。
marketSpace	{min,max}	いいえ	市場規模の範囲です。
conversionSharing	{min,max}	いいえ	コンバージョン集中度の範囲です。
relevancy	{min,max}	いいえ	シードとの関連性の範囲です。
uniqQueriesWCa	{min,max}	いいえ	カート追加数の範囲です。
ca	{min,max}	いいえ	カート追加コンバージョン率の範囲です。
titleDensity	{min,max}	いいえ	タイトル密度の範囲です。
adRivalCount	{min,max}	いいえ	広告競合数の範囲です。
uId	string	いいえ	ユーザー ID です。
memberId	string	いいえ	メンバー ID（データの帰属情報）です。

すべての範囲フィルターは{min, max}オブジェクトです。上限と下限のどちらか一方、または両方を指定してください。keywordとpageはどちらも必須です。

呼び出し方法

• API エンドポイント：POST /seerfar/ozon/keywordMining（完全なパラメーター／レスポンス／エラーコードについては references/api.md を参照）
• Python スクリプト：python scripts/seerfar_ozon_keyword_mining.py '<JSON 参数>' [--inline]
• コストに関する制約：このツールは計算リソースを消費します。同一セッションで同じパラメーターの組み合わせを指定した場合、デフォルトでは1回だけ呼び出され、スクリプトには24時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードの変更、ページ送り、郵便番号の変更を自動で連続して試してはいけません。検索を続ける必要がある場合は、追加のコストが発生することを事前にユーザーに説明してください。

出力方針（スクリプトのデフォルト動作）：

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-keyword-mining-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動で集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに保存した後、stdout には概要（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭3件のサンプル）のみを出力します
• --inline を追加すると、stdout への全量出力を強制します（同様にファイルにも保存されます）

データの読み取りに関する推奨事項：まず概要を確認して十分かどうかを判断してください。具体的なフィールドが必要な場合は、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出し、JSON 全体がコンテキストに入るのを避けてください。

認証と計算リソースに関する問題の解決

以下の異常が発生した場合は、references/onboarding.md のガイドに従って問題を解決してください。

異常

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが401または402
• レスポンスに計算リソースまたは残高の不足が示されている：メッセージに「計算リソース残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれています。

使用例

1. シード語を中心に展開する（検索ボリューム順）

{"keyword": "платье", "page": {"page": 1, "pageSize": 10, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

2. ブルーオーシャン向けに展開する — 検索ボリュームが多く、出品者が少ない

{"keyword": "телефон", "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}, "searchVolume": {"min": 10000}, "sellers": {"max": 50}}

3. 関連性とタイトル密度で、トピックに沿った展開を維持する

{"keyword": "наушники", "page": {"page": 1, "pageSize": 20, "orders": [{"field": "relevancy", "direction": "DESC"}]}, "relevancy": {"min": 50}}

4. include／exclude リストで絞り込む

{"keyword": "часы", "page": {"page": 1, "pageSize": 20}, "includeKeywords": ["женские"], "excludeKeywords": ["ремень"], "matchType": 1}

クエリの作成方法

1. 必ずシードの keyword を先頭に指定します：必須項目であり、展開の中心を定義します。Ozon 向けにはロシア語で指定してください。
2. page.orders を先頭に指定します：重視する指標で並べ替えます（人気度なら searchVolume DESC、トピックとの関連性なら relevancy DESC、競争の少なさなら sellers ASC）。
3. 範囲フィルターを組み合わせて機会を探します：searchVolume の下限を高くし、sellers の上限を低く設定して、ブルーオーシャン向けの展開語を見つけます。シードとの関連性を保つには、relevancy／titleDensity の範囲を追加します。
4. includeKeywords／excludeKeywords で展開を調整します：2回目のクエリを実行せずに、必須の修飾語を含め、不要な語を除外します。

表示ルール

1. データのみを提示します：マイニングしたキーワード指標を、主観的なアドバイスを加えず、分かりやすい表で示します。
2. キーワード列を先頭にします：query／queryCn（中国語訳）、続いて searchVolume、count30GrowthRate、productCount、sellers、avgPrice を表示します。シードとの近さを示すために relevancy も表示します（シード語自体は 100 です）。
3. ロシア語のキーワード：元の query はそのまま維持します。利用可能な場合、queryCn フィールドに中国語訳が含まれます。
4. プラットフォームタグ：Ozon と Wildberries の両方の行がある場合は、ユーザーが区別できるよう platform（0/1）を表示します。
5. 大きな結果セット：total が大きい場合は上位の行を表示し、以下の大容量レスポンスのパターンで完全なレスポンスを保存するか、page.page でさらにページを取得できることをユーザーに伝えます。
6. エラー処理：code が 200 でない場合（または errcode が 200 でない場合）は、msg／errmsg に基づいて理由を説明し、シードキーワードまたはフィルターの調整を提案します。

重要な制限事項

• keyword と page は必須です：どちらかを欠くペイロードは拒否されます。
• 日付セレクターはありません：searchDate はないため、ここではデータの月を選択できません。月単位のデータには、マーケットキーワード検索スキルを使用してください。
• カテゴリセレクターはありません：categories は入力として受け付けられません。返される各キーワードには categories ID 配列が含まれており、クライアント側でグループ化またはフィルター処理できます。
• dimension／categoryInfos は返されません：どちらもスキーマで定義され、columns に表示されますが、このエンドポイントでは実際の data[*] の行に値が設定されません（categoryInfos は関連するマーケットキーワード検索エンドポイントでは設定されますが、同じ仕様だと想定しないでください）。
• ネストされたフィールド：products[*]（上位の商品）は構造化されており、意思決定に役立ちます。サブフィールドについては references/api.md を参照してください（categoryInfos[*] はスキーマの完全性のために記載されていますが、このエンドポイントでは返されません。dimension／columns は不透明、または部分的にしか設定されません）。

ユーザーの表現とシナリオのクイックリファレンス

適用対象 — シードキーワードを起点としたOzonキーワードの拡張：

ユーザーの発言	シナリオ
「XXという語を軸に、Ozonの関連語を掘り下げて」	シードキーワードの拡張
「Ozonのロングテールキーワードを調査／ある語のロングテールを拡張」	シードを軸にしたロングテールの調査
「Ozonのある語のブルーオーシャン向け拡張語、競争率が低く検索数が多い語」	ブルーオーシャン向けの拡張（検索ボリュームが多く、出品者が少ない）
「OzonでXXに関連する語、関連度の高い語は何？」	関連度順の拡張
「Ozonのある語を拡張。ただし、特定の語を除外／必ず含めて」	含める語／除外する語を指定した拡張

適用対象外 — シードを起点としたキーワード調査の範囲を超える場合：

• シードなしで市場全体の人気キーワードを調査／ランキング化する → Seerfar Ozonの市場キーワード検索スキルを使用してください。
• 特定SKUの価格／販売数／在庫 → 商品レベルのSeerfar Ozonデータソースを使用してください。
• 特定の出品者のカタログ → 出品者／ショップレベルのSeerfar Ozonデータソースを使用してください。
• 前月比、またはカテゴリーを指定したキーワード検索 → 市場キーワード検索スキルを使用してください（searchDate／categoriesに対応）。

判断の境界：ユーザーがシード語から関連語を広げ、市場指標に基づいて関連語をランキング化したい場合は、まずこのスキルを使用してください。キーワードの市場全体を調査（シードなし）したい場合や、月／カテゴリーを指定したい場合は、市場キーワード検索スキルに案内してください。

計算リソースの消費ルール

計算リソースを23消費します。

ユーザーは計算リソースの消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

以下のいずれかに該当する場合は、フィードバックAPIを通じて自動的に検出し、報告してください。

1. このスキルで説明されている機能または目的が実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われる点がある

references/api.mdに記載された方法でフィードバックAPIを呼び出してください。ユーザーの作業を中断しないでください。

---

クロスボーダーeコマース向けの高品質で専門的なスキルについては、LinkFox Skillsを設定してください。