linkfox-youying-shopee-product-search

YouYing-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://...
デフォルト価格	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の使用方法

このツールはLinkFoxツールゲートウェイAPIを呼び出します。呼び出し方法、リクエストパラメーター、レスポンス構造については、references/api.mdを参照してください。また、scripts/youying_shopee_search.pyを直接実行して検索することもできます。

クエリの作成方法

ユーザーの要望に基づき、自然言語を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の人気商品」	売れ筋商品の発見
「Shopeeでxx商品を検索して」	キーワードによる商品検索
「マレーシアのマーケットで最近出品された新商品」	出品日による新商品の発見
「販売数が1000を超える商品は？」	販売数に基づく商品絞り込み
「東南アジアでチャンスのあるカテゴリーは？」	カテゴリーレベルの機会調査
「このショップの商品を見せて」	競合ショップの分析
「越境商品と現地商品を比較して」	越境商品と現地商品の比較
「Shopee Verified商品を絞り込んで」	Shopee Verified商品の絞り込み
「低価格で販売数の多い商品」	価格と販売数に基づく機会の発掘

該当しない - Shopeeの商品検索以外が必要な場合：

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

適用範囲の判断：ユーザーが「東南アジアでの商品選定」「Shopee市場分析」「越境ECの商品選定」と言った場合でも、さまざまな条件でShopeeの商品を検索・絞り込むことが目的であれば、このスキルが該当します。物流計画、広告戦略、またはショップ運営について尋ねている場合は該当しません。

フィードバック：

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

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

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

大きなレスポンスの処理

エージェントのコンテキストがあふれないように、レスポンスをディスクに保存し、必要なフィールドだけを抽出します。

python scripts/response_io.py run --script scripts/youying_shopee_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリーの外側（Unix では /tmp/...、Windows では %TEMP%/... など）に指定してください。保存されたレスポンスには、個人情報、価格、認証に関わる機密データが含まれている可能性があります。コミットしないでください。ファイルは自動削除されないため、タスクの完了後に削除してください。

run は完全なレスポンスをファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出します。スライスには --limit/--offset、出力形式には --format json|jsonl|csv|table を指定できます。

このパターンを優先する場合 — 次のようなレスポンスの特性に基づいて判断してください。

• レコードごとのフィールド数が多い場合、または不要なフィールドがある場合
• バッチ／ページネーションされた結果（1 回の呼び出しで複数の項目が返される場合）
• 長文のフィールド（説明、レビュー、HTML、時系列データ）
• すぐに消費するのではなく、後のステップでも出力を再利用する場合

小規模で一度だけ使用するレスポンスであれば、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューは、切り詰められたスキーマとサンプルであり、データ全体ではありません。フィールド単位の判断をする場合は、保存されたファイルを read で読み込んでください。

---

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