概要
マーケットプレイスパートナー向けのABOUT YOU Seller Center API: 注文、追跡付きの配送、請求書と梱包伝票、承認ステータスのある商品、在庫、価格、カテゴリと属性、ブランドとレポート。APIキー。
ガイド付きセットアップ
ABOUT YOU を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで ABOUT YOU を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
ABOUT YOU のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → ABOUT YOUをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
ABOUT YOU
マーケットプレイスパートナー向けのABOUT YOU Seller Center API: 注文、追跡付きの配送、請求書と梱包伝票、承認ステータスのある商品、在庫、価格、カテゴリと属性、ブランドとレポート。APIキー。
セットアップ
セットアップには約2分かかります。
- AdminユーザーとしてABOUT YOU Seller Centerにサインインします。メンバーユーザーはAPIキーを作成できません。
- 設定を開き、次にAPIキーを選択し、+ 追加をクリックします。
- ラベルを入力し、オプションで有効期限を設定し、キーを追加をクリックします。
ABOUT_YOU_API_KEYにキーを一度にコピーします: Seller Centerはこの一度だけ表示します。
キーはX-API-Keyヘッダーで送信されます。テストデータのために、設定、サンドボックス、サンドボックスを作成の下でサンドボックスを作成します: 同じアドレスで独自のAPIキーがあり、商品は承認なしでライブになり、テスト注文は注文ページの注文を受け取るボタンから来ます。
どこから始めるか: about_you_list_ordersを使用して、order_statusがopenのものを表示し、出荷待ちのものを確認します。about_you_list_productsは在庫と価格を含むカタログを表示します。about_you_list_countriesはキーが機能することを証明する安価な呼び出しです。
注文と配送: about_you_list_ordersは各注文のアイテムをそのidと共に返します; 出荷、キャンセル、返品ツールはこれらのアイテムIDを使用し、SKUは使用しません。about_you_ship_order_itemsを使用して出荷します(about_you_list_carriersからのキャリアキー、出荷追跡キー、返品追跡キーがすべて必要です)。about_you_get_delivery_documentはドロップシッピング注文の梱包伝票を返し、about_you_get_order_invoicesは顧客請求書をファイルとして返します。about_you_cancel_order_itemsとabout_you_return_order_itemsはオフに設定されています: キャンセルされたアイテムは後で出荷できず、アイテムを返品としてマークするとABOUT YOUが自動的に顧客に返金します。受領から24時間以内に返品を確認してください; 拒否したものは登録しないでください。
非同期書き込み: すべての書き込みは一度にbatchRequestIdで応答し、バックグラウンドで処理されます。about_you_get_batch_resultを使用して結果を読み取ります(一致するresult_typeを選択); ステータスがcompletedまたはfailedになるまで、各アイテムは成功とエラーを持ちます。結果は7日間保持されます。同じペイロードを短時間に2回送信すると、同じバッチIDが返され、再処理されません。
商品: 1行は1SKU(スタイルの色のサイズ)。about_you_upsert_productsを使用して、about_you_list_categories、about_you_list_category_attribute_groups、about_you_list_brandsからのIDを使用して作成または変更し、次にabout_you_publish_productでスタイルを承認に送信します。ステータス: draft、pending_approval(ABOUT YOUがレビュー中はロック)、rejected(理由はabout_you_list_rejected_productsに記載)、pending_active、active、inactive、problem(無効になったアクティブ商品; 修正されるとアクティブに戻ります)。about_you_update_product_status(draftおよびinactiveも含む)とabout_you_delete_productはオフに設定されています。
在庫と価格: about_you_update_stockとabout_you_update_pricesは、呼び出しごとに最大1000行を受け入れ、常に適用されます。商品アップサートを通じて送信された在庫や価格とは異なります。商品価格は国の通貨での小数(49.99)であり、注文金額は最小単位の整数(4999 = 49.99 EUR)です。すべての価格にcurrencyを送信してください。
レポートとWebhook: about_you_list_reportsとabout_you_download_report(ABOUT YOU倉庫内の商品の在庫および動きのレポート、DAC7)、about_you_list_webhooks(読み取り専用)。
ページング: リストはitemsとpaginationを返します。注文と商品はcursor = pagination.next_cursorでページングする必要があります; ページパラメータはそこでも機能しますが、非推奨です。小さなリストはページとper_pageを使用します(最大100)。
履行タイプ: dropshippingはあなたが出荷することを意味します; fulfillment_by_marketplaceはABOUT YOUが自社倉庫から出荷することを意味します(FbAY)、したがって出荷するものはなく、これらの注文には配送文書がありません。
レート制限(エンドポイントごとおよびキーごと): 注文100件/分、出荷200件、キャンセルおよび返品50件、在庫1000件、価格200件、商品リスト1000件、商品アップサートおよびステータス100件、バッチ結果200件、請求書およびレポート10件。ヘッダーX-RateLimit-LimitとX-RateLimit-Remainingは予算を示します; 429は次の分まで待機することを意味します。
エラー: 400および401はJSON形式のmessageで応答します。ドキュメントの404は、その注文にそのようなファイルがないことを意味します。このAPIには支払いまたは支払い呼び出しはありません; 返金につながる唯一のアクションは返品を登録することで、これはオフに設定されています。
前提条件: ABOUT_YOU_API_KEY
コネクタをローカルにインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/storeを開き、ABOUT YOUを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
about_you_list_orders | 注文をリスト: 注文ごとにorder_number、ステータス(open、shipped、cancelled、returned、mixed)、fulfillment_type、carrier_key、cost_with_taxなど… |
about_you_list_carriers | 出荷可能なキャリアをリスト: key(例: DHL_STD_NATIONAL、出荷時のcarrier_keyの値)、carrier_name、display_labelなど… |
about_you_ship_order_items | 開いている注文アイテムを出荷済みとしてマーク、1エントリごとにパッケージ: その中の注文アイテムID、キャリアキー、出荷追跡キー、返品… |
about_you_cancel_order_items | 配送できない開いている注文アイテムをキャンセル(例: 在庫切れ)。キャンセルされたアイテムは後で出荷できず、在庫は追加されません… |
about_you_return_order_items | 出荷された注文アイテムを返品として登録、返品追跡キー付き。アイテムが返品としてマークされると、ABOUT YOUが顧客に返金します… |
about_you_get_order_invoices | 1つの注文の顧客請求書をダウンロードします。応答は結果に添付されたファイル: PDF、または注文に複数の… |
about_you_get_delivery_document | ドロップシッピング注文の配送文書(梱包伝票)をPDFとして結果に添付してダウンロードします。ABOUT YOUによって出荷された注文… |
about_you_list_products | 商品バリアントをリスト(1行ごとにSKU): sku、style_key、colorway_key、ean、name、status(draft、pending_approval、rejected… |
about_you_list_rejected_products | ABOUT YOUが承認で拒否した商品をリスト: style_key、rejection_message、rejection_reasons[](key、type Image Requirementsまたは… |
about_you_upsert_products | 最大100の製品バリアントを作成または更新(1エントリごとにSKU)。新しい製品はドラフトとして開始されます; about_you_publish_productで公開します… |
about_you_publish_product | 1つの製品を公開(スタイルキーのすべてのバリアント)。ドラフトはABOUT YOUの承認に送信されます(pending_approval、次にpending_active、次に… |
about_you_update_product_status | スタイルキーによって1つ以上の製品のステータスを設定: published(承認に送信またはオンラインに戻す)、draft(承認から撤回; のみ… |
about_you_update_stock | 最大1000SKUの在庫数量を設定(自社倉庫の在庫; 数量0はサイズを利用不可にします)。古い… |
about_you_update_prices | 最大1000SKUと国のペアの価格を設定: 小売価格とオプションの販売価格、国の通貨での小数として… |
about_you_delete_product | SKUによって1つのバリアントを削除します。それが色の最後のサイズであった場合、その色も削除され、最後の色で全体の製品も… |
about_you_list_categories | ABOUT YOUのカテゴリツリーを検索: id(製品のカテゴリ値)、name、path(表示用)、parent_id、material_composition_type… |
about_you_list_category_attribute_groups | カテゴリが要求する属性グループをリスト(色、サイズ、素材グループおよびその他の属性): グループごとにid、name、frontend_name… |
about_you_list_brands | アカウントが販売できるブランドをリスト: id(製品のブランド値)とname。読み取り専用、1回の呼び出しで全てを返し、1分間に50回の呼び出し |
about_you_list_countries | アカウントが販売する国をリスト(コード、名前)、製品説明のロケール、および各国の通貨(country_code… |
about_you_get_batch_result | 非同期書き込みの結果を読み取ります: ステータス(pending、processing、completed、retry、failed)およびitems[]とリクエストアイテム… |
about_you_list_reports | アカウントのためにABOUT YOUが生成したレポートファイルをリスト: id、type(SELLABLE_STOCK、WAREHOUSE_MOVEMENTS、DAC7)、file_name、date… |
about_you_download_report | idによって1つのレポートファイルをダウンロードします。テキストファイル(CSV)はテキストとして返され、他の形式は結果に添付されたファイルとして返されます。読み取り専用、10… |
about_you_list_webhooks | アカウントのWebhookサブスクリプションをリスト: id、url、events(order.created、order.shipped、stock.updatedなど)、enabled… |
例のプロンプト
- "どのABOUT YOUの注文が開いていて、出荷待ちですか?"
- "私の製品の中で、ABOUT YOUに拒否されたものはどれで、理由は何ですか?"
- "SKU AY-TSHIRT-WHT-Mの在庫を50に設定します。"
- "注文123456789のアイテムをDHLで出荷し、追跡003404341612345678と返品追跡003404341698765432を使用します。"
- "先月の売上レポートをダウンロードします。"
次のステップ
このガイドは役に立ちましたか?