概要
リファービッシャー向けのBack MarketセラーAPI:トラッキング付きの受け入れと出荷を伴う注文、価格と在庫を含むリスティング、Backboxと競合他社の価格、カテゴリ、カスタマーケアフォルダとメッセージ、BackShipの配送とBuyBackの注文。プラットフォームごとのAPIトークン(ヨーロッパ、アメリカ、アジア太平洋)。
ガイド付きセットアップ
Back Market を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Back Market を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Back Market のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストールなし?cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Back Marketをクリック、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Back Market
リファービッシャー向けのBack MarketセラーAPI:トラッキング付きの受け入れと出荷を伴う注文、価格と在庫を含むリスティング、Backboxと競合他社の価格、カテゴリ、カスタマーケアフォルダとメッセージ、BackShipの配送とBuyBackの注文。プラットフォームごとのAPIトークン(ヨーロッパ、アメリカ、アジア太平洋)。
セットアップ
セットアップには約3分かかります。
- プラットフォームのBack Marketバックオフィスにサインインします:
https://www.backmarket.fr/bo-seller(ヨーロッパ)、https://www.backmarket.com/bo-seller(アメリカ)、またはhttps://www.backmarket.co.jp/bo-seller(日本とオーストラリア)。APIアクセスは、Back Marketによって検証されたセラーアカウントに付随します。 - オプションの下にあるIntegrationsページを開き、APIトークンを作成します。
- トークンを
BACK_MARKET_TOKENに示された通りに貼り付けます。前に「Basic」という言葉を付けないでください:コネクタはそれをAuthorization: Basicの後にトークンとして送信します。 BACK_MARKET_HOSTでプラットフォームを選択し、BACK_MARKET_MARKETで主要な市場を選択します(例えば、ヨーロッパはfr-fr、アメリカはen-us、アジア太平洋はja-jp)。市場はプラットフォームに属している必要があります。
すべての呼び出しはAccept-Languageに市場を含め、User-AgentはBM-AnythingMCP-Connectorです。これはBack Marketが要求します。market引数を持つツールは、同じプラットフォームの別の市場を1回の呼び出しで参照できます。
どこから始めるか:back_market_list_ordersの状態1は、受け入れる必要がある支払い済みの注文を表示し、状態3は出荷する注文を表示します。back_market_list_listingsはあなたのオファーを表示し、back_market_list_backboxはどのオファーがBackboxを保持しているかを教えます。
注文ワークフロー:注文は支払いが確認されると状態1で到着します(状態0、8、または10では出荷しないでください)。各行をback_market_accept_order_lineで受け入れます(行の状態1から2へ);その後、注文は状態3に移動します。back_market_ship_orderとトラッキング番号で出荷します(すべての行は1つの小包に入れられ、注文の状態は9になります)。back_market_get_orderは行の状態を表示します。back_market_set_order_line_identifiersはデバイスのIMEIまたはシリアル番号を保存します;後で修正することはできません。back_market_cancel_order_lineとback_market_refund_order_lineはオフに設定されています:両方とも顧客に返金し、元に戻すことはできず、キャンセルはBackboxに影響を与えます。
リスティング:1つのリスティングはプラットフォームのすべての市場をカバーします。数量は共有され、価格、コメント、保証は市場ごとです。back_market_get_listingはSKUでリスティングを見つけ、back_market_update_listingはリアルタイムで価格や在庫を変更します(数量0はオフラインにします)。back_market_import_listings(オフに設定)は、複数のリスティングのCSVを一度に送信し、back_market_get_taskのタスクIDに応答します。back_market_get_competitorsは市場ごとにBackboxを獲得するために必要な価格を表示します。back_market_get_category_treeとback_market_get_category_branchは、新しい製品に必要なカテゴリと属性を提供します。
カスタマーケア:back_market_list_care_foldersとback_market_get_care_folderは、メッセージを含むアフターセールスケースを読み取ります;back_market_send_care_messageは顧客に応答します。back_market_create_care_refundはオフに設定されています。
BackShipとBuyBack:back_market_list_deliveriesとback_market_list_returnsは、Back MarketのBackShipラベルを使用しているセラーのデータのみを返します。back_market_list_buyback_ordersとback_market_get_buyback_orderはトレードイン注文を読み取ります;1つを検証または反論することで、顧客に支払われる金額が決まりますが、これには含まれません。
フォーマット:価格は税金を含む小数点文字列で、市場の通貨で表されます(160.99)。注文IDと注文行IDは整数で、リスティングIDはUUIDです(数値のlisting_idは非推奨です)。日付はRFC 3339形式で、ケアフォルダのフィルタはYYYY-MM-DD-hh-mmを使用します。リストはcount、next、previous、resultsを返し、nextは最後のページではnullです。
制限:10秒間に200回を超える呼び出しは10秒間ブロックされます(カタログ呼び出し:10秒間に20回)、429が返されます。リスティングの更新は、1時間あたり約2,000SKU行に制限されています。ケア呼び出しには日次制限があります(フォルダリストは1日4,000、返金は1日500)。
403の応答:Back MarketはCloudflareの背後にあります。HTMLページまたはコードbot-need-challengeを伴う403は、ファイアウォールが呼び出し元をブロックしたことを意味し、トークンが間違っているわけではありません:応答のcf-ray値をBack Marketの連絡先に送信してください。間違ったトークンや欠落したトークンも403または401で応答し、JSONエラーが返されます。
前提条件:BACK_MARKET_HOST、BACK_MARKET_TOKEN、BACK_MARKET_MARKET
コネクタをローカルにインストールする
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を開き、Back Marketを選択し、前提条件の下にリストされた環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
back_market_list_orders | 注文をリスト表示します。未払いのもの(注文状態0と8はデフォルトで除外されます)は含まれません。応答にはcount、next、previous、results[]が含まれます… |
back_market_get_order | 1つの注文を読み取ります:order_id、state、date_creation、date_modification、date_payment、date_shipping、expected_dispatch_date、priceなど… |
back_market_accept_order_line | 1つの支払い済み注文行を受け入れます(状態1から状態2へ)、これはアイテムを持っていて出荷することを確認します。注文のすべての行を受け入れます… |
back_market_ship_order | 受け入れた注文をトラッキング番号で出荷済みとしてマークします(状態3)。注文のすべての行は1つの小包に入れられ、出荷済みに設定されます… |
back_market_cancel_order_line | 配送できない1つの支払い済み注文行をキャンセルします(状態1から状態4へ)。Back Marketはその行について顧客に返金し、キャンセルは元に戻せません… |
back_market_refund_order_line | 注文ワークフローを通じて1つの注文行を返金します:出荷されていない受け入れられた行の状態5、出荷された行の状態6。顧客は… |
back_market_set_order_line_identifiers | 1つの注文行で販売されたデバイスのIMEIおよび/またはシリアル番号を登録します。2つのうち少なくとも1つを提供してください。注意:登録後は修正できません… |
back_market_list_listings | あなたのリスティング(オファー)をリスト表示します:id(UUID)、listing_id(古い数値ID)、sku、title、product_id、grade(PREMIUM、EXCELLENT、VERY_GOOD、GOOD… |
back_market_get_listing | あなたのSKUまたはBack Market IDで1つのリスティングを読み取ります:id、listing_id、sku、title、product_id、grade、quantity、price、min_price… |
back_market_update_listing | リアルタイムで1つのリスティングを変更します:価格、在庫数量、コメント、保証、またはBackPricerの最小価格。指定されたフィールドのみが… |
back_market_import_listings | CSVテキストから多くのリスティングを作成または更新します(新しい製品を提案することも可能):最大15,000行。各行にはあなたのskuが必要です;新しいリスティングも… |
back_market_get_task | back_market_import_listingsによって開始されたバッチタスクの結果を読み取ります:task_id、action_status(0または2 = 待機中または実行中、8 = 失敗、9… |
back_market_list_backbox | リスティングごとのBackboxデータをリスト表示します:sku、product、price、quantity、buybox(あなたのリスティングがBackboxを保持している場合はtrue)、price_for_buybox(… |
back_market_get_competitors | 1つのリスティングのBackbox競争を読み取ります。市場ごとに1行:is_winning、price、min_price、price_to_win、winner_price(それぞれに… |
back_market_get_category_tree | カテゴリツリー全体を読み取ります:category_id、category_name、marketplace_category_id(製品のカテゴリが一致する必要がある値)、is_leafおよび… |
back_market_get_category_branch | ツリーと同じフィールドを持つ1つのカテゴリを読み取ります:category_id、category_name、marketplace_category_id、is_leafおよびattributes[]… |
back_market_list_care_folders | カスタマーケアフォルダ(アフターセールスケース、SAV)をリスト表示します。ページごとに10件:id、orderline、state(0はオープン、9はクローズ)、date_creation… |
back_market_get_care_folder | 1つのカスタマーケアフォルダを読み取ります:state、dates、顧客(名、姓、メール)、注文行とその注文および住所、… |
back_market_send_care_message | ケアフォルダ内の顧客にメッセージを投稿します(テキストのみ、添付ファイルなし)。顧客はBack Marketのアフターセールスプラットフォームでそれを確認します… |
back_market_create_care_refund | カスタマーケアからの注文行を返金します:支払い済み行の全額返金(タイプ4)、受け入れられた行の全額返金(タイプ5)、または部分的または… |
back_market_list_deliveries | BackShipの配送をリスト表示します(Back MarketのBackShip配送サービスに登録しているセラーのみ):order、shipmentId、orderlines… |
back_market_list_returns | BackShipの製品返品をリスト表示します(BackShipに登録しているセラーのみ):orderId、orderlineId、shipmentId、carrierName、trackingNumber… |
back_market_list_buyback_orders | BuyBack(トレードイン)注文をリスト表示します。顧客があなたに販売するデバイス:orderPublicId、status、market、creationDate、shippingDate、receivalDate… |
back_market_get_buyback_order | 1つのBuyBack(トレードイン)注文を読み取ります:status、market、dates(creation、shipping、receival、payment、counter proposal)、リスティング、… |
例のプロンプト
- 「どのBack Marketの注文が私の受け入れを待っていますか?」
- 「私のリスティングのどれがBackboxを失い、どの価格で取り戻せますか?」
- 「私のリファービッシュされたiPhone 13 128 GBリスティングの在庫を12に設定してください。」
- 「注文41234567をColissimoトラッキング6A12345678901と各行のIMEIで出荷してください。」
- 「どのカスタマーケアフォルダがオープンで、顧客は何を尋ねていますか?」
次のステップ
このガイドは役に立ちましたか?