linkfox-seerfar-ozon-market-keyword-search

Seerfar Ozon Market キーワード検索

このスキルは、Seerfar 分析データベースで Ozon マーケットプレイスのキーワードを検索し、検索ボリューム、30 日間の成長率、商品／販売者／競合数、平均価格、月間販売数／売上高、コンバージョン率と閲覧数の集中度、評価／レビュー数など、豊富なパフォーマンス指標で絞り込みます。返される各キーワードには、市場プロファイル全体（市場規模、返品／キャンセル率、人気商品、中国語訳）が含まれるため、Ozon のキーワード選定、ブルーオーシャンキーワードの発掘、市場機会の分析の出発点になります。

基本概念

データの単位は SKU ではなくキーワードです：商品検索とは異なり、このエンドポイントはマーケットプレイスの検索語句（「热词」）を返し、それぞれに市場指標が付加されています。Ozon でターゲットにする価値のある検索語句を見つけられます。

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

日付の意味：searchDate はデータの月を指定します。2026-04-01 を渡すと 2026 年 3 月のデータが取得されます。省略した場合は直近 30 日間のデータが使われます。searchVolume（月間検索人気度）や count30GrowthRate（月間検索成長率）などの指標は、選択した期間を基準にしています。

一致モード：matchType は keywords 配列の照合方法を制御します。0 は完全一致、1 はあいまい一致です。キーワードテキストで絞り込む場合は、検索意図に合ったモードを選択してください。

パラメーター

パラメーター	型	必須	説明
page	object	はい	ページネーション {page, pageSize, orders[]}。page は 1 から（デフォルトは 1）、pageSize のデフォルトは 20 です。orders[] = {field, direction} で、direction は DESC／ASC です。
keywords	array	いいえ	絞り込み対象のキーワードリスト（最大 1000 件）。matchType と組み合わせて使用します。
matchType	integer	いいえ	キーワードの一致モード：0 は完全一致、1 はあいまい一致です。
searchDate	string	いいえ	データの日付 yyyy-MM-dd。デフォルトは直近 30 日間です。2026-04-01 → 2026 年 3 月のデータです。
categories	array	いいえ	カテゴリー ID のリスト（最大 1000 件）。
searchVolume	{min,max}	いいえ	月間検索ボリュームの範囲。
searchChange30	{min,max}	いいえ	30 日間の検索数変化の範囲。
monthlySales	{min,max}	いいえ	月間販売数の範囲。
monthlyRevenue	{min,max}	いいえ	月間売上高の範囲。
price	{min,max}	いいえ	平均価格の範囲。
productViews	{min,max}	いいえ	商品閲覧数の範囲。
products	{min,max}	いいえ	商品数の範囲。
volume	{min,max}	いいえ	ボリュームの範囲。
marketSpace	{min,max}	いいえ	市場規模の範囲。
conversionSharing	{min,max}	いいえ	コンバージョン集中度の範囲。
reviews	{min,max}	いいえ	レビュー数の範囲。
ratings	{min,max}	いいえ	評価の範囲。
sellers	{min,max}	いいえ	販売者数の範囲。
weight	{min,max}	いいえ	重量の範囲。
uId	string	いいえ	ユーザー ID。
memberId	string	いいえ	メンバー ID（データの帰属先）。

すべての範囲フィルターは {min, max} オブジェクトです。上限または下限のいずれか、あるいは両方を指定してください。必須なのは page のみです。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-market-keyword-search-<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. 現在の人気キーワード（検索ボリューム順）

{"page": {"page": 1, "pageSize": 10, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

2. ブルーオーシャンキーワード — 検索ボリュームが多く、出品者が少ない

{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}, "searchVolume": {"min": 10000}, "sellers": {"max": 50}}

3. キーワード文字列で絞り込み（あいまい検索、ロシア語）

{"page": {"page": 1, "pageSize": 20}, "keywords": ["телефон"], "matchType": 1}

4. 販売数の下限を指定した特定のデータ月

{"page": {"page": 1, "pageSize": 20}, "searchDate": "2026-04-01", "monthlySales": {"min": 1000}}

クエリの作成方法

1. page.orders を最初に指定します：データセットが大きいため、必ず対象の指標で並べ替えます（人気順は searchVolume DESC、上昇中のキーワードは count30GrowthRate DESC、競合が少ない順は sellers ASC）。
2. 範囲フィルターを組み合わせて機会を見つけます：searchVolume の下限を高くし、sellers の上限を低く設定してブルーオーシャンキーワードを抽出します。需要を評価するには、conversionSharing / marketSpace の範囲も追加します。
3. keywords + matchType でニッチを絞り込みます：ロシア語のシードキーワードを渡し、matchType: 1（あいまい検索）を指定して、関連するロングテールキーワードを列挙します。
4. 適切な searchDate を選びます：現在のトレンド（過去30日間）を調べる場合は省略し、月ごとの比較には明示的な日付を渡します。

表示ルール

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

重要な制限事項

• page は必須です：page を含まないペイロードは拒否されます。
• プラットフォームセレクターはありません：Ozon と Wildberries の混在はサーバー側で制御されます。platform フィールドでクライアント側の絞り込みを行ってください。
• カテゴリ ID は不透明です：categories には、人が読める名前ではなく Seerfar のカテゴリ ID が必要です。
• ページネーションの上限：pageSize と page を使ってページを取得します。非常に大きな pageSize はサーバー側で上限が適用される場合があります。
• ネストされたフィールド：products[*]（Top 商品）と categoryInfos[*]（カテゴリーパスおよび越境対応の可否を示すフラグ）は構造化されており、判断に役立ちます。サブフィールドについては references/api.md を参照してください。dimension / columns は不透明、または一部しか設定されていません。relevancy / titleDensity / wordCount は通常含まれません。

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

該当する用途 — Ozon のキーワード市場調査：

ユーザーの発言	シナリオ
"Ozon の人気キーワード／急上昇ワードは何ですか"	検索ボリューム順で人気キーワードを取得
"Ozon のブルーオーシャンキーワード、競合が少なく検索数の多いキーワード"	ブルーオーシャンキーワードの抽出（検索ボリュームが多く、出品者が少ない）
"Ozon の上昇キーワード／最近伸びているキーワード"	上昇中のキーワード（成長率順）
"特定のロシア語キーワードのロングテールキーワード"	あいまい検索によるキーワードの拡張
"Ozon の特定のキーワードの市場規模／競合商品数／出品者数"	キーワードの市場プロファイル

該当しない用途 — キーワード市場データ以外が必要な場合：

• 特定の SKU の価格／販売数／在庫 → このキーワードエンドポイントではなく、商品レベルの Seerfar Ozon データソースを使用します。
• 特定の出品者のカタログ → 出品者／ショップレベルの Seerfar Ozon データソースを使用します。
• カテゴリーツリーの参照 → カテゴリーレベルの Seerfar Ozon データソースを使用します。
• Ozon／Wildberries 以外のマーケットプレイス → ここでは対象外です。

判断の基準：Ozon の市場指標に基づいて検索キーワードを見つけて順位付けしたい場合は、まずここを使用します。SKU／出品者／カテゴリーがすでに決まっており、その配下の情報を探したい場合は、対応する Seerfar Ozon データソースに振り分けます。

計算リソース消費ルール

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

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

フィードバック：

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

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

references/api.mdに記載されているとおりにFeedback APIを呼び出してください。ユーザーの作業を中断しないでください。

---

より高品質でプロフェッショナルな越境ECスキルを利用するには、LinkFox Skillsを設定してください。