Zinc - Retail API for AI agents

ZincはAmazon、Walmart、Target、Best Buy、Etsy、Costco、そして各種Shopifyサイトに単一のAPIでつながる。検索・注文・追跡・返品を同じ接点でこなし、小売店ごとに脆いスクレイパーを抱えなくて済む。新しい店舗は定期的に加わる。静的な一覧を信じるのではなく、GET /retailersに最新リストを問い合わせればいい。

検索と商品詳細のレスポンスは小売店から直接届く。画像、価格、重量、評価、在庫は、問い合わせたその時点で読んだものだ。各商品の裏にある複数の出品も見えるので、価格・配送速度・出品者の評判を比べ、最初の1件ではなく最良の1件を選べる。データ呼び出しは1回$0.01をウォレットから引く。

エージェントは登録なしで始められる。POST /agent/ordersは支払いチャレンジ付きのHTTP 402を返し、1回の決済で注文が成立する。Solana、Base、Tempo上のUSDC、またはStripe経由の法定通貨で、x402かMPPを通じて自力で支払う。オンチェーンの決済はトランザクションハッシュで記録され、1つのハッシュは1つのものだけを支払う。

すべての注文には、エージェントではなく利用者が設定するセント単位のmax_priceが必要だ。Zincは指定した上限に$1の手数料を足して先に請求し、注文が完了すると差額を返す。検索と購入手続きの間に価格が上限を超えれば、多く使うのではなくmax_price_exceededで注文は失敗する。

小売店のメール、配送業者のスキャン、配達写真は、すべてコードから読める1本の整ったタイムラインに集まる。追跡番号は配送業者から直接取得するので、発送から配達へ一気に飛ぶ状態ではなく、実際のチェックポイントが手に入る。返品はコードから開始でき、ラベルはサポートチケットなしで出てくる。

注文が出荷され、配達日が動き、返金が確定した瞬間にZincがイベントを送るので、ポーリングはやめられる。イベントにはorder.started、order.cancelled、order.failed、order.deliveredがある。配送状況の更新を自社ブランドで顧客に渡すこともでき、追跡ページはホスト済みだ。

テストモードは、データを分離し、専用のWebhook設定とあらゆる失敗の練習商品をそろえた完全なサンドボックスで、zn_test_キーは課金されない。TypeScriptとPythonのSDKは仕様そのものから生成されるため、型の間違いは本番ではなくエディタで露見する。