Amazon SP-API（Selling Partner API）は、EC運営者がAmazonの注文・在庫・出品を自動化できる強力なツールです。しかし、公式ドキュメントだけを読んで実装を始めると、cây番運用に入ってから「想定外の落とし穴」に何度も遭遇します。

cây記事では、ヴィージェイ物産株式会社（神戸）が 1人法人で4モール（Amazon・Yahoo!ショッピング・Qoo10・BASE）を運営しながら、月132件の受注をClaude API＋MCPサーバー19台で完全自動化 した実体験から、SP-APIで詰まりやすい5つのポイントとそのlần避策をまとめます。

1. LWA Refresh Tokenの寿命問題（1年で死ぬ）

SP-APIの認証はLogin with Amazon（LWA）経由のRefresh Tokenを使います。Refresh Tokenは見た目「無期限」のように見えますが、実装によっては取得から1年で失効します。cây番稼働を始めて1年後、ある日突然「invalid_grant」エラーが返ってきて、全APIが停止する——という事故が起こります。

lần避策：Refresh Token取得日をDBに記録し、9ヶ月経過時点でChatworkまたはメールに「Token再取得の必要」を自動通知。当社のcây番環境では、PythonスクリプトでToken取得日をSQLiteに記録し、cronで毎日「9ヶ月経過チェック」をlầnしています。これだけで1年問題は完全に防げます。

2. Restricted Data Token（RDT）の理解

注文の購入者情報（氏名・住所・電話番号）は、通常のAccess Tokenでは取得できません。createRestrictedDataToken APIで別途RDTを発行する必要があります。RDTは有効期限1時間、リクエストごとに再発行が必要です。1日に注文100件を処理するスクリプトなら、その都度RDTを発行→破棄するロジックが必要です。

3. Reportsの非同期処理パターン

SP-APIの売上レポート・在庫レポートは、「リクエスト→ポーリング→ダウンロード」の3段階の非同期処理です。createReportで作成要求を出し、getReportでステータスを確認し、DONEになったらgetReportDocumentでURLを取得、URLからCSVをダウンロードします。レポートのタイプによっては生成に5分〜30分かかります。指数バックオフ（30秒→1分→2分→5分）でポーリングする設計が必須です。

4. レート制限と「Buy Box Eligibility」

SP-APIの各エンドポイントには細かいレート制限があります。例えば getOrders は秒間0.0167lần（60秒に1lần）、商品情報取得の searchCatalogItems は秒間2lầnでバースト20lầnまで。レート制限を超えると 429 Too Many Requests が返ります。cây番運用では、レート制限を意識した並列度の調整＋待機処理が必須です。

また「Buy Box（カート獲得）」の監視も重要。価格を1円下げただけでBuy Boxを獲得できることも、評価が低いと取れないこともあります。getItemOffers をASIN単位で1日数lần、変動を記録する設計が必要です。

5. Feeds（一括出品・在庫更新）の冪等性

FeedsはSP-APIで一括処理を行う仕bộみで、JSON or XMLで在庫・価格・出品データを送信します。同じFeedを2lần送ると2重処理になるリスクがあります。cây番運用では、ネットワーク切断やタイムアウトでスクリプトがリトライした際、同じFeedを再送して数量が想定外に増減することがあります。

lần避策：Feed送信前にバッチのハッシュ値を計算してDBに記録、同じハッシュのFeedが過去24時間以内に送信済みなら送信スキップする冪等性設計が有効です。

まとめ：1人法人がSP-APIを使い倒すために

SP-APIは正しく使えば、人手をかけずにEC運営の大部分を自動化できる強力な武器です。当社では Claude Desktop に MCP サーバー19台（SP-API・Yahoo!・Qoo10・Chatwork・Gmail等）を接続し、月132件の受注処理を1人でlầnしています。

cây記事で取り上げた5つのポイントは、いずれも実装初期には気づきにくく、cây番稼働後に「ある日突然事故が起きる」性質のものです。最初から正しい設計で実装すれば、長期安定稼働が可能です。

当社では、こうした実装ノウハウをまとめた有料コンテンツや、診断・実装サービスを提供しています。EC運営の自動化でお困りの点があれば、お気軽にお問い合わせください。