Shopee Open Platform API v2 で「店舗認可 → カテゴリ取得 → 画像アップロード(image_id取得) → add_item で商品登録」までを自動化する管理画面です。コードは実装完了。認証情報と店舗 access_token を .env に入れれば操作が有効化されます。
認可 → カテゴリ → 画像 → 登録 の順に進みます。認証情報が未投入のため各操作は無効(🔒)です。
partner_id / partner_key を設定 → 認可URLを生成 → 販売者がブラウザで authorize → 返ってきた code を access_token に交換します。access_token は約4時間で失効するため、運用では自動更新処理を追加します。
出品時の category_id を特定。疎通確認にも使えます。
画像を media_space へアップロードし image_id を取得(multipart 個別署名)。
image_id・カテゴリ・必須属性を組み立てて商品を登録。CSV行→add_item本文の組立ヘルパも実装済み。getAttributes は定義のみで CLI/フロー未配線。
# 鍵設定→認可フロー(auth-url→authorize→token交換)後 npm run shopee:category # カテゴリ取得の疎通確認 npm run shopee:upload ./img.jpg npm run shopee:additem ./item.json
本番稼働には partner_id / partner_key / shop_id の取得と、店舗認可フローを実際に通して access_token を得ることが必要です。いまは実APIへの疎通が一度も無く、各操作は無効。鍵を .env に入れ npm run shopee:auth-url から認可を進め、最後に「カテゴリ取得を実行して」と Claude に伝えれば疎通します。残タスクは getAttributes の CLI 配線と access_token 自動更新。