linkfox-seerfar-ozon-keyword-back-search

Seerfar Ozon キーワード逆引き

このスキルでは、Seerfar の分析データベースから、商品 SKU ID のリストを指定して Ozon の検索キーワードを逆引きします。SKU（自社商品または競合商品）を最大 20 件渡すと、それらの商品が表示される検索語が返されます。自然検索、広告検索のいずれか、または両方が対象となり、各検索語には市場全体の詳細なプロファイル（検索ボリューム、過去 30 日間の成長率、商品数／販売者数／競合数、平均価格、コンバージョンの集中度、上位商品に加え、dimension オブジェクト内の検索語ごとの自然検索／広告チャネル、自然検索順位、露出度、コンバージョン）が付与されます。Ozon キーワード逆引き、商品タイトルの最適化、競合商品の流入キーワード発見の出発点となります。

主な概念

キーワード起点ではなく SKU 起点：シード検索語からキーワードを展開するキーワードマイニングや、市場全体を閲覧する市場キーワード検索とは異なり、このエンドポイントでは skuIds を指定し、その特定の商品がランクインしている検索語を返します。方向は商品 → キーワード（逆引き）です。

hasVariant は必須です：すべてのリクエストで、バリエーションを除外するかどうかを指定する必要があります。0 はバリエーションを含める、1 は除外することを意味します。親商品リスティングのキーワードを重複なしで取得したい場合は、1 を選択してください。

自然検索語と広告検索語：type で検索語のチャネルを絞り込みます。["0"] は自然検索語のみ、["1"] は広告検索語のみを指定します。両方を取得する場合は省略してください。naturalRank／adRank の範囲フィルターと組み合わせて、掲載位置を絞り込めます。

逆引きの指標は dimension に格納されます：返される各検索語には dimension オブジェクトが含まれ、逆引き固有の指標が格納されます。type（0 は自然検索／1 は広告）、naturalRank（その検索語における SKU の自然検索順位）、exposure（露出シェア、0～1）、conversion（コンバージョン率、0～1）、x（詳細不明の掲載位置指標）です。入力フィルターの type／naturalRank／adRank／exposure／conversion は、同じ検索語ごとの値を対象に絞り込みます。注：スキーマで定義されている relevancy は、このエンドポイントでは返されません。

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

マッチモード：matchType で includeKeywords／excludeKeywords の照合方法を指定します。0 は完全一致、1 はあいまい一致です。

パラメーター

パラメーター	型	必須	説明
skuIds	array	はい	逆引きするSKUのリスト。最大20件です。
hasVariant	integer	はい	バリエーションの除外：0 はバリエーションを含める、1 はバリエーションを除外します。
page	object	はい	ページネーション {page, pageSize, orders[]}。page は1から（デフォルトは1）、pageSize のデフォルトは20です。orders[] は {field, direction} で、direction は DESC／ASC です。
matchType	integer	いいえ	キーワードの一致モード：0 は完全一致、1 はあいまい一致です。
type	array	いいえ	検索語のチャネルフィルター：0 はオーガニック、1 は広告です。両方を対象にする場合は省略します。
historyDate	string	いいえ	過去の月 yyyy-MM（例：2026-02）。現在の期間を対象にする場合は省略します。
includeKeywords	array	いいえ	含める必要がある語句（最大1000件）。
excludeKeywords	array	いいえ	除外する語句（最大1000件）。
searchVolume	{min,max}	いいえ	月間検索ボリュームの範囲。
searchChange30	{min,max}	いいえ	30日間の検索数変化の範囲。
wordCount	{min,max}	いいえ	キーワードの単語数／文字数の範囲。
productViews	{min,max}	いいえ	商品閲覧数の範囲。
products	{min,max}	いいえ	商品数の範囲。
sellers	{min,max}	いいえ	出品者数の範囲。
marketSpace	{min,max}	いいえ	市場規模の範囲。
conversionSharing	{min,max}	いいえ	コンバージョン集中度の範囲。
uniqQueriesWCa	{min,max}	いいえ	カート追加数の範囲。
ca	{min,max}	いいえ	カート追加コンバージョン率の範囲。
conversion	{min,max}	いいえ	コンバージョン率の範囲。
titleDensity	{min,max}	いいえ	タイトル密度の範囲。
adRivalCount	{min,max}	いいえ	広告競合数の範囲。
adRank	{min,max}	いいえ	広告ランクの範囲。
naturalRank	{min,max}	いいえ	オーガニックランクの範囲。
exposure	{min,max}	いいえ	露出数の範囲。
uId	string	いいえ	ユーザーID。
memberId	string	いいえ	メンバーID（データの帰属先）。

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

呼び出し方法

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

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

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

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

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

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

異常な状況

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

使用例

1. 1つのSKUのトラフィックキーワードを逆引きする（検索ボリューム順に並べ替え）

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

2. SKU が上位にランクインしているオーガニック検索語

{"skuIds": [4380710124], "hasVariant": 1, "type": ["0"], "naturalRank": {"max": 10}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

3. 広告ランクの下限を指定して、広告検索語のみを取得する

{"skuIds": [4380710124], "hasVariant": 0, "type": ["1"], "adRank": {"max": 50}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

4. 含める語句／除外する語句のリストで絞り込む

{"skuIds": [4380710124], "hasVariant": 0, "page": {"page": 1, "pageSize": 20}, "includeKeywords": ["платье"], "excludeKeywords": ["ремень"], "matchType": 1}

クエリの作成方法

1. 必ず skuIds + hasVariant から始める：どちらも必須で、逆引きの対象を定義します。実際の Ozon SKU ID（Seerfar Ozon の商品／ショップ／カテゴリのスキルが返すものと同じ ID）を使用してください。
2. page.orders から始める：重視する指標で並べ替えます（トラフィックの重みを確認する場合は searchVolume DESC、競争が少ない条件を確認する場合は sellers ASC、上昇中の語句を確認する場合は count30GrowthRate DESC）。
3. type でオーガニックと広告を分ける：掲載最適化（オーガニック）または広告の分析に絞るには、["0"] または ["1"] を渡し、続けて naturalRank / adRank の範囲を指定して掲載順位を絞り込みます。これらのフィルターは、各行の dimension に表示される値を対象にします。
4. includeKeywords / excludeKeywords で調整する：2回目のクエリを実行せずに、必須の修飾語を含め、不要な語句を除外します。

表示ルール

1. データのみを提示する：逆引きしたキーワード指標を、主観的なアドバイスを加えず、分かりやすい表で示します。
2. キーワード列を先頭にする：query / queryCn（中国語訳）、続いて searchVolume、count30GrowthRate、productCount、sellers、avgPrice を表示します。各語句での SKU の順位が分かるよう、dimension.naturalRank と dimension.type（オーガニック／広告）も表示します。
3. ロシア語のキーワード：元の query はそのまま保持します。中国語訳がある場合は、queryCn フィールドに表示されます。
4. チャネルタグ：type が省略され、オーガニックと広告の両方の行が含まれる場合は、ユーザーが両者を区別できるよう、dimension.type（0 はオーガニック、1 は広告）と dimension.naturalRank を表示します。
5. 大量の結果：total が大きい場合は、上位の行を表示し、以下の大規模レスポンスのパターンを使って全レスポンスを保存するか、page.page でさらにページを取得できることを案内します。
6. エラー処理：code が 200 でない場合（または errcode が 200 でない場合）は、msg / errmsg に記載された理由を説明し、SKU リストまたはフィルターの調整を提案します。

重要な制限事項

• skuIds + hasVariant + page は必須：いずれかを欠くペイロードは拒否されます。
• skuIds は最大 20 件：20 件を超えて渡すと、リクエストは拒否されるか、切り捨てられます。
• キーワードのシードは指定不可：このエンドポイントには keyword パラメーターがありません。キーワードからキーワードへの展開ではなく、SKU からキーワードへの逆引きです。シードから展開するには、キーワードマイニングのスキルを使用してください。
• searchDate / categories の入力は不可：受け付けるのは履歴月を指定する historyDate のみです。カテゴリーフィルターはありません。月またはカテゴリーを指定して検索するには、市場キーワード検索のスキルを使用してください。
• ネストされたフィールド：products[*]（上位商品）と dimension（語句ごとの逆引き指標：type、naturalRank、exposure、conversion、x）は構造化されており、判断に役立つ情報です。サブフィールドについては references/api.md を参照してください。categoryInfos はスキーマ／列定義に含まれていますが、このエンドポイントの data[*] には返されません（キーワードマイニングの関連エンドポイントと同様です。市場キーワード検索の関連エンドポイントでは返されるため、同じ仕様だと想定しないでください）。relevancy も同様にスキーマで定義されていますが、返されません。

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

該当するケース — SKU を基準とした Ozon キーワードの逆引き：

ユーザーの発言	シナリオ
"この Ozon 商品 / SKU のキーワードを逆引きして"	SKU のキーワード逆引き
"この Ozon リンクにどんな検索語が流入をもたらしている？"	商品リストの流入語の特定
"Ozon の競合 SKU の売上につながる語 / 流入語"	競合商品の流入語の抽出
"Ozon の特定商品の自然検索語 / 広告語"	自然検索語と広告語の内訳
"Ozon のキーワード逆引き、SKU でキーワードを逆引き"	一般的なキーワード逆引き

該当しないケース — SKU を基準とした逆引きの範囲外のニーズ：

• 市場全体の人気キーワードを調査 / ランキング表示する（SKU なし）→ Seerfar Ozon の市場キーワード検索スキルを使用します。
• シードキーワードを起点にキーワードを広げる → Seerfar Ozon のキーワードマイニングスキルを使用します。
• 特定の SKU の価格 / 売上 / 在庫 → 商品レベルの Seerfar Ozon データソースを使用します。
• 特定の販売者の商品カタログ → Seerfar Ozon のショップ検索スキルを使用します。
• カテゴリーツリーの閲覧 → Seerfar Ozon のカテゴリ検索スキルを使用します。

判断基準：ユーザーが（自社または競合の）商品 / SKU を提示し、その商品がどの検索語でランキングされているかを知りたい場合は、まずこのスキルを使用します。市場を閲覧したい場合（SKU なし）、またはシードキーワードを起点にキーワードを広げたい場合は、それぞれ市場キーワード検索またはキーワードマイニングスキルに案内します。

算力の消費ルール

算力を 23 消費します。

ユーザーは算力の消費に応じて料金を支払います。十分に評価してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーの算力消費量に対する想定が不十分な場合は、必ずユーザーに通知し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md に記載された手順に従って Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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