概要
refurbed Seller APIは、再生品電子機器の販売者向けです:注文および注文アイテム(受け入れ、追跡およびIMEIでの配送)、返金のドライラン、配送ラベル、請求書、返品、サポートチケット、在庫と価格のあるオファー、市場価格、製品検索、配送プロファイルおよびキャリア。refurbedからのAPIトークン。
ガイド付きセットアップ
refurbed を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで refurbed を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
refurbed のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストールなし?cloud.anythingmcp.comを直接使用してください。 サインインし、Connectors → refurbedをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
refurbed
refurbed Seller APIは、再生品電子機器の販売者向けです:注文および注文アイテム(受け入れ、追跡およびIMEIでの配送)、返金のドライラン、配送ラベル、請求書、返品、サポートチケット、在庫と価格のあるオファー、市場価格、製品検索、配送プロファイルおよびキャリア。refurbedからのAPIトークン。
セットアップ
セットアップには約5分かかります。plus refurbedの回答が必要です。
- supplier.refurbed.com/api-token-request のフォームでAPIトークンをリクエストします(またはアカウントマネージャーまたは[email protected]に問い合わせてください)。refurbedはUUIDのようなトークンを送信します。
- それを
REFURBED_API_TOKENに貼り付け、refurbed_list_ordersをインストールして実行します。コネクタはそれをAuthorization: Plainとしてトークンの後に送信します。 - 2ヶ月間使用されないトークンは期限切れになります。その場合は新しいものをリクエストしてください。いくつかの呼び出しは、あなたのアカウントのためにrefurbedによって有効にされる必要があります(配送ラベル、新しいバッテリーオファー)。
APIはhttps://api.refurbed.comで実行されます。refurbedは、リクエストに応じて各販売者にサンドボックスを提供します(supplier.refurbed.com/sandbox-request)、アドレスはhttps://grpc-<name>.qa.refurbed.ioのようになり、テスト注文が含まれます。自己ホスト型のインストールは、このコネクタのコピーをそこにポイントできます。
開始する場所:refurbed_list_ordersで状態がNEWの注文を処理します。refurbed_get_orderおよびrefurbed_list_order_itemsはアイテムを表示します。refurbed_accept_order_itemで受け入れ、次にrefurbed_ship_order_itemで配送します(追跡リンク、またはrefurbed_list_available_carriersからのキャリアスラッグと追跡番号、アイテム識別子にIMEIまたはシリアルを含めます)。refurbed_batch_update_order_item_statesは一度に最大50件処理します。refurbed_update_order_itemは後で追跡、識別子、ノートまたはスイスの税関データを変更します。refurbed_get_order_itemは1つのアイテムを読み取ります。
注文アイテムの状態:NEWはACCEPTED、REJECTEDまたはCANCELLEDに移行します。ACCEPTEDはSHIPPEDまたはCANCELLEDに移行します。SHIPPEDはRETURNEDになることがあります。ステップをスキップすると、コード9で失敗します(新しい状態から出荷状態に変更できません)。REJECTEDおよびCANCELLEDは最終的であり、返金されません:refurbed_reject_order_itemはオフに切り替えられてインストールされており、refurbedは最初にチケットを通じて顧客に通知することを期待しています。注文の状態はそのアイテムから計算されます。廃止されたフィールドparcel_tracking_number、parcel_tracking_carrierおよび単一のitem_identifierは使用しないでください。
返金:このコネクタは決して返金しません。refurbed_calculate_item_refundおよびrefurbed_calculate_order_refundは、金額を示すドライランです。返金自体は販売者インターフェースで行われます(オープンチケットが必要です)。
ラベル、請求書、返品、チケット:refurbed_list_shipping_labelsは新しいラベルリンクを提供します。refurbed_create_shipping_label(オフに切り替え)で、各呼び出しごとにrefurbedの配送契約に基づく実際のラベルを作成します。refurbed_get_order_invoiceは、アップロードした請求書へのリンクを提供します。refurbed_list_returnsは、refurbedの返品ラベルを持つ返品をリストします。荷物が到着したら、アイテムをRETURNEDに設定します。refurbed_list_ticketsおよびrefurbed_get_ticketは顧客チケットを読み取ります。
オファー:refurbed_list_offers、refurbed_get_offer、refurbed_create_offer(refurbed_get_instanceで製品を見つけ、refurbed_list_shipping_profilesでプロファイルを見つけます)、refurbed_update_offerおよびrefurbed_batch_update_offersは在庫と価格のためのものです。SKUでオファーを識別します:オファーIDはオファーが再作成されると変更されます。在庫が0のときは一時停止します。refurbed_delete_offerはオフに切り替えられています。市場ごとの固定価格:refurbed_list_market_offers、refurbed_create_market_offer、refurbed_update_market_offer、refurbed_delete_market_offer(オフに切り替え); refurbed_list_marketsのサイト市場のみがそれを受け入れます。新しいオファーには保証M12のみが受け入れられます。グレーディングはAA、A、BまたはCです。
その他の検索:refurbed_list_merchant_addresses(ラベル用の送信者アドレスID)およびrefurbed_get_currency(為替レート; セットアップチェックで使用されます)。
APIの動作:すべての呼び出しは、/refb.merchant.v1.<Service>/<Method>へのJSONボディのPOSTです。フィールド名はsnake_caseです。IDは文字列として送信および返される整数です("3496079")。金額は小数点を含む文字列です("199.99"、カンマは拒否されます)。時間はUTCのRFC 3339です。列挙型は名前で送信されます。SKUまたはIDでオファーを指定し、両方を指定しないでください。カーソルを使用してリストページを作成します:has_moreがtrueの間、最後のIDをstarting_afterとして渡し、最大100行まで取得します。バッチは1から50アイテムを処理し、アイテムごとに1つのステータスを返します。
制限とエラー:デフォルトで1秒あたり10リクエスト(ヘッダーX-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset)。これを超えると429 RESOURCE_EXHAUSTEDが返されます。エラーはcodeとmessageをgRPCコードで返します:3無効な引数、5見つかりません、6既に存在します、7権限が拒否されました、9事前条件が失敗しました、16認証されていません。
条件:refurbedのAPI条件は、販売者のために行動する統合者を許可しますが、各アクションは販売者に追跡可能でなければならず、APIデータは再販またはベンチマーキングや市場インテリジェンスに使用されることはできません。
書き込み:最初に確認してください。 受け入れ、出荷、追跡、在庫および価格の変更は、ライブアカウントに影響します。各呼び出しの前に、ユーザーに変更内容を表示し、はいを待ちます。
前提条件:REFURBED_API_TOKEN
コネクタをローカルにインストールする
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を開き、refurbedを選択し、前提条件の下にリストされたenv変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
refurbed_list_orders | 注文をリストします。デフォルトでは最新のものから表示:id、released_at、state(NEW、ACCEPTED、SHIPPED、FULFILLED、CANCELLEDなど)、ラベル(例… |
refurbed_get_order | すべてのアイテムを含む1つの注文を読み取ります:状態、ラベル、顧客のメール、配送および請求先住所(VAT番号を含む)、合計および決済… |
refurbed_list_order_items | 1つの注文のアイテムをリストします:id、名前、状態、sku、合計、手数料、課税、オファーデータ(オファーid、グレーディング、保証、配送… |
refurbed_get_order_item | 自身のid(注文idではなく)で1つの注文アイテムを読み取ります:状態、sku、価格と手数料、オファーデータ、追跡リンクおよびキャリア… |
refurbed_accept_order_item | NEW注文アイテム(状態ACCEPTED)を受け入れます:出荷することを確認します。更新されたアイテムを返します |
refurbed_ship_order_item | ACCEPTED注文アイテムをSHIPPEDとしてマークします:完全なparcel_tracking_url、またはparcel_carrier_tracking_number(キャリアスラッグと… |
refurbed_update_order_item | 状態を変更せずに注文アイテムを変更します:追跡リンクまたはキャリア追跡番号を置き換え、識別子(IMEI、シリアル)を追加します… |
refurbed_batch_update_order_item_states | 一度の呼び出しで最大50件の注文アイテムの状態を変更します(複数を受け入れまたは出荷します)。各更新には単一の呼び出しのフィールドがあります。応答… |
refurbed_reject_order_item | 注文アイテムを拒否(NEWアイテム)またはキャンセル(NEWまたはACCEPTEDアイテム)します。最終的であり、元に戻すことはできません。顧客に自動的に返金されません… |
refurbed_calculate_item_refund | ドライラン:注文アイテムの返金が何を意味するかを示します(total_paid、total_refunded、refunded、refurbedおよび販売者のシェア)… |
refurbed_calculate_order_refund | ドライラン:注文のすべての返金可能なアイテムの返金がどのくらいになるかを示しますが、何も返金しません |
refurbed_list_shipping_labels | 注文のために作成された配送ラベルをリストします:id、プリンタPDFリンク(約1時間後に期限切れになります。新しいもののために再度呼び出します)、追跡… |
refurbed_create_shipping_label | refurbedの配送契約に基づいて注文のための配送ラベルを作成します(現在はDHL Express)。各呼び出しは新しい実際のラベルとその… |
refurbed_get_order_invoice | 注文のためにアップロードした請求書のダウンロードリンク(24時間有効)を取得します。存在しない場合はNOT_FOUND |
refurbed_list_returns | refurbedの返品ラベルを持つ返品をリストします:id、order_id、order_item_id、instance_name、識別子、状態(INITIATED、IN_TRANSIT… |
refurbed_list_tickets | 顧客サポートチケットをリストします:id、状態(OPEN、PENDING、SOLVED、CLOSED)、トピック、緊急度、顧客、注文および注文アイテム… |
refurbed_get_ticket | メッセージ、トピック、状態、注文参照およびノートを含む1つのサポートチケットを読み取ります |
refurbed_list_offers | あなたのオファーをリストします:id、sku、instance_idおよびinstance_name、状態(OK、UNVERIFIED、PENDING_REVIEW、REJECTED(拒否理由付き))、グレーディング… |
refurbed_get_offer | SKUまたはidで1つのオファーを読み取ります:状態、グレーディング、保証、在庫、配送プロファイル、課税、参考価格および市場価格… |
refurbed_create_offer | 製品のオファーを作成します:instance_id(refurbed_get_instance)、またはgtinまたはmpn(その後、refurbedが確認するまでオファーはUNVERIFIEDになります… |
refurbed_update_offer | SKUまたはidでオファーを変更します:在庫、参考価格および最小価格、グレーディング、保証、配送プロファイルまたは課税;指定されたフィールドのみが… |
refurbed_batch_update_offers | 一度の呼び出しで最大50件のオファーを変更します(在庫および価格の更新)。各エントリには識別子とrefurbed_update_offerのフィールドが含まれます。応答… |
refurbed_delete_offer | SKUまたはidでオファーを削除します。元に戻すことはできません。オファーを一時停止するには、代わりにrefurbed_update_offerで在庫を0に設定します。オフに切り替えられてインストールされています |
refurbed_list_market_offers | 1つのオファーの市場ごとの価格をリストします:market_code、それがサイト市場であるかどうか、設定または計算された価格および最小価格、通貨… |
refurbed_create_market_offer | 1つのサイト市場のオファーに対して固定価格を設定します。参考価格から計算された価格の代わりに。市場が… |
refurbed_update_market_offer | 1つの市場のオファーの固定価格を変更します。SKUまたはoffer_idとmarket_codeでオファーを指定します |
refurbed_delete_market_offer | 1つの市場のオファーの固定価格を削除します。価格は参考価格からの計算に戻ります。オフに切り替えられてインストールされています |
refurbed_get_instance | GTIN、MPNまたはidでrefurbed製品(インスタンス)を検索します:idと名前。オファーを作成する際にはidをinstance_idとして使用します。製品はありません… |
refurbed_list_shipping_profiles | あなたの配送プロファイルをリストします:id、名前、出発国、コストと配達時間を持つ目的地市場、各プロファイルを使用するオファーの数… |
refurbed_list_available_carriers | refurbedが追跡できるキャリアをリストします:名前とスラッグ。追跡番号で配送する際には、リンクの代わりにスラッグをキャリアとして使用します。キャッシュ… |
refurbed_list_markets | refurbed市場をリストします:コード(例:de、at、fr)、名前、タイプ、currency_codeおよびis_site(独自のrefurbedサイトを持つ市場、固定… |
refurbed_list_merchant_addresses | あなたのアドレスをリストします:id、タイプ(DELIVERYまたはRETURN)、会社、通り、町、郵便番号および国。idは… |
refurbed_get_currency | 通貨とその為替レートを読み取ります。販売者データは不要です。トークンが機能するかを確認するために使用されます |
例のプロンプト
- "どのrefurbed注文アイテムが受け入れを待っていますか?"
- "注文アイテム9123456をDHL追跡00340434161234567890およびIMEI356789012345678で出荷します。"
- "iPhone 14 128 GBの市場ごとのオファー価格は何ですか?"
- "今週入ってきた返品はどれですか?"
- "注文アイテム9123456の返金はどのくらいになりますか?"
次のステップ
このガイドは役に立ちましたか?