概要
再生品電子機器の販売者向けのrefurbed Seller API:注文と注文アイテム(受け入れ、追跡とIMEIで出荷)、返金のドライラン、配送ラベル、請求書、返品、サポートチケット、在庫と価格のあるオファー、市場価格、製品検索、配送プロファイルとキャリア。refurbedからのAPIトークン。
ガイド付きセットアップ
refurbed を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで refurbed を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
refurbed のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comを直接使用してください。 サインインし、Connectors → refurbedをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
refurbed + Meta Muse
再生品電子機器の販売者向けのrefurbed Seller API:注文と注文アイテム(受け入れ、追跡とIMEIで出荷)、返金のドライラン、配送ラベル、請求書、返品、サポートチケット、在庫と価格のあるオファー、市場価格、製品検索、配送プロファイルとキャリア。refurbedからのAPIトークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は以下の通りです:
REFURBED_API_TOKEN
ステップ 1 — 資格情報を取得する
セットアップには約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データは再販またはベンチマーキングや市場インテリジェンスに使用されることはありません。
書き込み:最初に確認してください。 受け入れ、出荷、追跡、在庫および価格の変更はライブアカウントに影響します。各呼び出しの前に、ユーザーに何が変更されるかを示し、はいの返事を待ってください。
ステップ 2 — アダプタをインストールする
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
ステップ 3 — Museにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
refurbedのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます(Web、iOS・Android アプリ、WhatsApp)。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 何をするか |
|---|---|
refurbed_list_orders | 注文をリストします。デフォルトでは最新のものから表示:id、released_at、state(NEW、ACCEPTED、SHIPPED、FULFILLED、CANCELLEDなど)、ラベル(例… |
refurbed_get_order | すべてのアイテムを含む1つの注文を読み取ります:state、ラベル、顧客のメール、配送および請求先住所(VAT番号を含む)、合計および決済… |
refurbed_list_order_items | 1つの注文のアイテムをリストします:id、name、state、sku、合計、手数料、課税、オファーデータ(オファーid、グレーディング、保証、配送… |
refurbed_get_order_item | 自身のid(注文idではなく)で1つの注文アイテムを読み取ります:state、sku、価格と手数料、オファーデータ、追跡リンクとキャリア… |
refurbed_accept_order_item | NEWの注文アイテム(state 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 | 1回の呼び出しで最大50件の注文アイテムの状態を変更します(複数を受け入れまたは出荷します)。各更新には単一の呼び出しのフィールドが含まれ、応答… |
refurbed_reject_order_item | 注文アイテムを拒否(NEWアイテム)またはキャンセル(NEWまたはACCEPTEDアイテム)します。最終的であり、元に戻すことはできません;顧客への返金は行いません… |
refurbed_calculate_item_refund | ドライラン:注文アイテムを返金することが意味することを示します(total_paid、total_refunded、refunded、refurbedおよびmerchantのシェア)… |
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、識別子、state(INITIATED、IN_TRANSIT… |
refurbed_list_tickets | 顧客サポートチケットをリストします:id、status(OPEN、PENDING、SOLVED、CLOSED)、トピック、緊急度、顧客、注文および注文アイテム… |
refurbed_get_ticket | メッセージ、トピック、ステータス、注文参照およびノートを含む1つのサポートチケットを読み取ります |
refurbed_list_offers | 自分のオファーをリストします:id、sku、instance_idおよびinstance_name、state(OK、UNVERIFIED、PENDING_REVIEW、REJECTED(拒否理由付き))、グレーディング… |
refurbed_get_offer | SKUまたはidで1つのオファーを読み取ります:state、グレーディング、保証、在庫、配送プロファイル、課税、参考価格および市場価格… |
refurbed_create_offer | 製品のオファーを作成します:instance_id(refurbed_get_instance)、またはgtinまたはmpn(その後、refurbedが確認するまでオファーはUNVERIFIEDです… |
refurbed_update_offer | SKUまたはidでオファーを変更します:在庫、参考価格および最小価格、グレーディング、保証、配送プロファイルまたは課税;指定されたフィールドのみが… |
refurbed_batch_update_offers | 1回の呼び出しで最大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つのサイト市場のオファーに固定価格を設定します。参考価格から計算された価格ではなく。市場がすでに存在する場合はALREADY_EXISTS |
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の返金額はいくらですか?"
FAQ
APIトークンはどこから来ますか? refurbedのAPIトークンフォーム、アカウントマネージャーまたは[email protected]からリクエストしてください。未使用のトークンは2ヶ月後に期限切れになります。
何をカバーしていますか? 注文と注文アイテム(受け入れ、追跡とIMEIで出荷)、返金のドライラン、配送ラベル、請求書、返品、サポートチケット、在庫と価格のあるオファー、市場ごとの価格、製品検索、配送プロファイルとキャリア。
どのツールがオフに設定されていますか? refurbed_reject_order_item、refurbed_create_shipping_label、refurbed_delete_offerおよびrefurbed_delete_market_offer。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?