トップ/管理画面/② Shopee 商品選定
02

Shopee 商品選定

not started / 未着手

「レビュー件数 ≧ N / 日本直送 / S$30以上」などの条件で出品候補を絞り込む選定エンジンの管理画面です。選定ロジック自体は容易ですが、他者商品データの取得元が未確定で実装は未着手。取得元が決まれば、候補リスト→③出品(add_item)へ直結できます。

done partial blocked not started / 未着手
Status

いま何ができて、何ができていないか。

動いている(調査)
調査メモのみ(02-shopee-research.md)。データ取得元をA:スクレイピング非推奨/B:Shopee Affiliate API第一候補/C:第三者SaaSで整理。選定ロジック(レビュー≧N/日本直送/S$30以上)自体は容易で、確定後は候補CSV→③add_itemへ直結する方針を記述。
足りない
コードは一切ない。Open Platform Product APIは横断検索に非対応という課題が未解決。Affiliate API(SG)の登録可否、検索系のレスポンス項目(review_count/ship_from/price)の有無が未確認。実装・実データ取得ゼロ。
ブロッカー
他者商品データの取得元が未確定。Shopee Affiliateの登録可否と提供項目の精査が前提条件として未着手。
Data Source

データ取得元の比較

選定の前提は「どこから他者商品データを取るか」。3案を比較し、Affiliate API を第一候補としています。

内容規約安定性コスト判定
A. スクレイピング検索結果ページを解析グレー低(IPブロック/構造変化)非推奨
B. Affiliate API商品検索系エンドポイント正規無〜低第一候補
C. 第三者SaaS解析サービスのAPI提供元規約に依存中〜高中〜高予算次第
Selection Engine

選定条件(設計)

取得元が決まれば、この条件で候補を絞り込み→③のadd_itemに流します。現状はUI設計のみで未実装(🔒)。

🎯絞り込みフィルタ
未実装
レビュー件数
≧ 100 件
配送元
日本直送
価格
≧ S$ 30
取得元(Affiliate API)確定後に実装
🔗③出品への連携
設計のみ

絞り込み結果を候補CSVに出力 → ③Shopee出品の add_item 組立ヘルパへ流し込む構想。選定と出品を一本のパイプラインに繋げます。

候補抽出(②) → candidates.csv → buildAddItemBody() → add_item(③)
Next Move

次の一手

実装の前にデータ取得元の確保が先決です。Shopee Affiliate(SG)の登録可否と、検索APIで review数・配送元・価格が取れるかを確認します。取れることが分かれば、選定ロジックは短期間で組めます。Claude には「Shopee AffiliateのSG登録可否と、検索APIの返却項目(review_count/ship_from/price)を調べて」と投げてください。