Zinc - Retail API for AI agents

Zinc는 Amazon, Walmart, Target, Best Buy, Etsy, Costco, 그리고 여러 Shopify 사이트에 단일 API로 연결한다. 검색과 주문, 추적, 반품을 같은 접점에서 처리하며, 매장마다 약한 스크레이퍼를 유지할 필요가 없다. 새 매장은 꾸준히 들어오고, 정적인 목록을 믿는 대신 GET /retailers에 최신 목록을 물을 수 있다.

검색과 상품 상세 응답은 매장에서 바로 온다. 이미지와 가격, 무게, 평점, 재고는 질문한 그 시점에 읽은 값이다. 상품 뒤에 걸린 여러 판매처 제안도 함께 보여, 가격과 배송 속도, 판매자 평판을 비교해 첫 번째가 아니라 가장 좋은 것을 고를 수 있다. 데이터 호출은 한 번에 $0.01이 지갑에서 빠진다.

에이전트는 가입 없이 시작한다. POST /agent/orders는 결제 챌린지가 담긴 HTTP 402를 돌려주고, 한 번의 정산으로 주문이 성립한다. Solana, Base, Tempo의 USDC나 Stripe를 통한 법정통화로 x402나 MPP를 거쳐 스스로 결제한다. 온체인 정산은 트랜잭션 해시로 기록되고, 해시 하나는 정확히 한 가지 값만 지불한다.

모든 주문에는 에이전트가 아니라 사용자가 정하는 센트 단위의 max_price가 필요하다. Zinc는 지정한 상한에 $1 수수료를 더해 먼저 청구하고, 주문이 끝나면 차액을 돌려준다. 검색과 결제 사이에 가격이 상한을 넘으면 더 쓰는 대신 max_price_exceeded로 주문이 실패한다.

매장 이메일과 운송사 스캔, 배송 사진이 모두 코드로 읽을 수 있는 하나의 정돈된 타임라인에 모인다. 운송장 번호는 운송사에서 직접 받아오므로, 발송에서 배송으로 곧장 뛰는 상태가 아니라 실제 체크포인트를 얻는다. 반품은 코드에서 시작하고, 라벨은 지원 티켓 없이 나온다.

주문이 나가거나 배송일이 움직이거나 환불이 정산되는 순간 Zinc가 이벤트를 보내므로 폴링을 멈출 수 있다. 이벤트에는 order.started, order.cancelled, order.failed, order.delivered가 있다. 배송 상황 업데이트를 자사 브랜드로 고객에게 넘길 수도 있고, 추적 페이지는 호스팅된다.

테스트 모드는 데이터를 분리하고 전용 웹훅 설정과 모든 실패 상황의 연습 상품을 갖춘 완전한 샌드박스이며, zn_test_ 키는 청구되지 않는다. TypeScript와 Python SDK는 명세 자체에서 생성되므로 타입 실수는 프로덕션이 아니라 편집기에서 드러난다.