linkfox-youying-shopee-get-product-infos

友鹰-Shopee 商品リサーチ

このスキルでは、11のマーケットプレイスにおけるShopeeの商品データを検索・絞り込む方法を案内し、越境販売者がShopeeで人気商品や市場機会を見つけられるよう支援します。

主な概念

友鹰（YouYing）のShopee商品リサーチツールでは、Shopee全体の商品を構造化して検索できます。販売者はキーワード、価格帯、販売数、出品時期、店舗属性など、複数の条件を柔軟に組み合わせて絞り込み、ヒット商品や市場機会を見つけられます。

主なデータ項目：

• 販売データ：直近30日間の販売数（sold）、直近30日間の推定販売数（estimateSold）、商品累計販売数（historicalSold）、直近30日間の売上額（payment）
• 価格データ：デフォルト価格（price）、最低価格（minPrice）、最高価格（maxPrice）
• 店舗データ：店舗名、公式店舗かどうか、Shopee認証済みかどうか、現地／海外、越境／国内
• 商品属性：評価、評価数、お気に入り数、閲覧数、SKU数、出品時期、カテゴリー階層

データフィールド

商品フィールド（出力）

フィールド	API 名	説明	例
商品ID	pid	商品の一意識別子	12345678
商品タイトル	title	商品名	Storage Box Organizer
商品説明	description	商品の詳細説明	...
商品メイン画像	imageUrl	商品のメイン画像URL	https://...
商品リンク	productUrl	Shopeeの商品ページリンク	https://...
Shopee商品リンク	shopeeUrl	Shopeeドメイン上の商品リンク	https://shopee.sg/...
デフォルト価格	price	商品のデフォルト価格（現地通貨）	29.90
最低価格	minPrice	SKUの最低価格	19.90
最高価格	maxPrice	SKUの最高価格	39.90
直近30日間の販売数	sold	直近30日間の実販売数	1500
直近30日間の推定販売数	estimateSold	直近30日間の推定販売数	1200
累計販売数	historicalSold	商品の累計販売数	50000
直近30日間の売上額	payment	直近30日間の販売金額（現地通貨）	45000
商品評価	rating	0～5点	4.8
評価数	ratings	受け取った評価の合計数	320
お気に入り数	favorite	お気に入りに登録された回数	2800
閲覧数	viewCount	閲覧回数	15000
在庫	stock	現在の在庫数	500
SKU数	skuNumber	SKUバリエーション数	8
出品時期	genTime	商品の初回出品日	2025-06-01
カテゴリー階層	categoryStructure	商品が属するカテゴリーの階層パス	Home & Living > Storage
店舗名	shopName	商品を販売する店舗名	BestHome Official
店舗リンク	shopUrl	店舗ページのリンク	https://...
公式店舗かどうか	isOfficialShop	1=はい、0=いいえ	1
Shopee認証済み	isShopeeVerified	1=認証済み、0=未認証	1
発送タイプ	cbOption	1=越境、0=国内	0
店舗所在地のタイプ	shippingIconType	0=現地、1=海外	0
商品ステータス	status	1=販売中、0=販売終了	1

対応マーケットプレイス

サイト	station 値	コード
マレーシア	malaysia	MY
台湾（中国）	taiwan_china	Taiwan_CHN
インドネシア	indonesia	ID
タイ	thailand	TH
フィリピン	philippines	PH
シンガポール	singapore	SG
ベトナム	vietnam	VN
ブラジル	brazil	BR
メキシコ	mexico	MX
チリ	chile	CL
コロンビア	columbia	CO

station は必須パラメーターです。サイト名（例：malaysia）またはコード（例：MY）を指定できます。ユーザーがサイトを指定していない場合は、どのサイトを検索するかユーザーに確認してください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-youying-shopee-get-product-infos-<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／套餐到期／需充值／请充值」または同様の意味の内容が含まれる場合。

クエリの作成方法

ユーザーの要望をAPIパラメーターの組み合わせに変換します。基本原則は、ユーザーの絞り込み条件を対応するパラメーターに正確にマッピングすることです。

API呼び出しを作成する原則

1. 必須サイト：呼び出しごとに station を指定します。ユーザーが「マレーシア」と言った場合は malaysia、「台湾（中国）」の場合は taiwan_china、「インドネシア」の場合は indonesia などを指定します
2. キーワード検索：keyword はタイトルのキーワードです。keywordType を指定して一致方法を制御します（1=フレーズ全体に一致、2=複数語のAND条件、3=複数語のOR条件）
3. 数値範囲：ほとんどの絞り込み条件では、Start/End または Min/Max のペアのパラメーターを使用します。必要に応じて片側または両側を設定します
4. 並べ替え：orderBy で並べ替えフィールドを指定し、orderByType で昇順／降順を指定します（デフォルトはDESCの降順）
5. ページネーション：page は1から始まり、pageSize の範囲は1～1000です。デフォルトは1000です
6. 除外条件：notExistKeyword で特定の語句を含む商品を除外できます。notExistShopIdList で特定の店舗を除外できます

一般的な検索シナリオ

1. キーワードによる商品選定 — 販売数で売れ筋商品を絞り込む

station: malaysia
keyword: Storage Box
keywordType: 2
soldMin: 100
orderBy: sold
orderByType: DESC
pageSize: 100

2. 新商品発見 — 最近出品され、一定の販売数がある商品

station: thailand
keyword: Phone Case
listingDateFrom: 2025-06-01
soldMin: 50
orderBy: gen_time
orderByType: DESC

3. 高いポテンシャルの商品 — 低価格・高販売数

station: indonesia
keyword: LED Light
priceMax: 50000
soldMin: 500
orderBy: payment
orderByType: DESC

4. 越境セラーの商品を絞り込む

station: malaysia
keyword: Wireless Earbuds
cbOption: 1
soldMin: 200
orderBy: sold
orderByType: DESC

5. カテゴリーによる商品選定 — カテゴリーと売上高で絞り込む

station: vietnam
pL1Id: 11036379
paymentStart: 10000000
orderBy: payment
orderByType: DESC
pageSize: 200

6. 競合店舗の分析 — 特定の店舗の商品を確認する

station: malaysia
shopIdList: 123456789
orderBy: sold
orderByType: DESC

7. 優良商品の絞り込み — Shopee優選と高評価

station: philippines
keyword: Beauty
isShopeeVerified: 1
ratingMin: 4.5
soldMin: 100
orderBy: rating
orderByType: DESC

8. 大手セラーを除外 — 中小セラーのチャンスを発見する

station: taiwan_china
keyword: 收纳盒
notExistShopIdList: 111111,222222,333333
soldMin: 50
soldMax: 500
orderBy: sold
orderByType: DESC

表示ルール

1. データのみを提示：検索結果は、主観的なビジネスアドバイスを含めず、見やすい表で表示します
2. 通貨に関する注意：マーケットプレイスによって使用通貨（MYR、TWD、IDR、THB、PHP、SGD、VND、BRL、MXN、CLP、COP）が異なります。価格や支払い額を表示する際は、必ず通貨の情報をユーザーに伝えてください
3. 件数に関する注意：検索結果が多い場合は、主要データ（タイトル、価格、販売数、売上高、評価）を表示し、ページネーションで続きを確認できることをユーザーに伝えてください
4. 主要指標の強調：意思決定に特に重要な指標である sold（過去30日間の販売数）、payment（過去30日間の売上高）、price、rating を優先して表示します
5. エラー処理：検索に失敗した場合は、エラーレスポンスに基づいて理由を説明し、検索条件の調整を提案します
6. 画像の表示：imageUrl が利用可能な場合は、ユーザーが見た目で判断できるよう、商品画像を含めてください

重要な制限事項

• 結果の上限：pageSize は、1リクエストあたり最大1000件です
• 必須フィールド：station は常に必須です。指定されていない場合は、どのマーケットプレイスを検索するかユーザーに尋ねてください
• 価格の通貨：価格は選択したマーケットプレイスの現地通貨であり、USDではありません
• データの鮮度：データは友鹰のクロールスケジュールに依存します。最終更新時刻は lastModiTime を確認してください

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

適用対象 - Shopeeの商品検索と絞り込み：

ユーザーの発言	シナリオ
「虾皮で何がよく売れているか」「Shopeeのヒット商品」	売れ筋商品の発見
「Shopeeでxx商品を検索して」	キーワードによる商品検索
「マレーシアのサイトで最近出品された新商品」	出品日による新商品の発見
「販売数が1000を超える商品はあるか」	販売数による商品絞り込み
「東南アジアでチャンスのあるカテゴリーは」	カテゴリーレベルの機会調査
「この店舗の商品を見て」	競合店舗の分析
「越境商品と現地商品の比較」	越境商品と現地商品の比較
「Shopee優選商品の絞り込み」	Shopee Verified商品の絞り込み
「低価格・高販売数の商品」	価格と販売数による機会の発掘

適用対象外 - Shopeeの商品検索を超えるニーズ：

• Amazon、TikTok、eBay、1688など、その他のプラットフォームでの商品検索
• Shopeeの広告出稿戦略
• Shopee店舗の運営に関するアドバイス
• Shopeeの物流・倉庫ソリューション
• 既存のローカルShopeeデータファイルの処理

適用範囲の判断：「東南アジアの商品選定」「虾皮市場分析」「越境ECの商品選定」といった依頼でも、Shopeeの商品をさまざまな条件で検索・絞り込む内容であれば、このスキルが適用されます。物流計画、広告戦略、店舗運営に関する依頼には適用されません。

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

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

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

フィードバック：

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

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

references/api.md に記載された手順に従って、フィードバックAPIを呼び出してください。ユーザーの操作を妨げないでください。

---

高品質でプロフェッショナルな越境ECスキルをさらにご覧になるには、LinkFox Skillsにアクセスしてください。