概要
ウクライナ最大のマーケットプレイスであるRozetkaマーケットプレイスの売り手API:ステータスと運送状(TTN)の更新、支払いステータス、大量の価格と在庫の更新、新しいリスト、ショップレビュー、製品に関する質問と回答、バイヤーチャット、返品リクエスト。売り手キャビネットのログインでサインインします。
ガイド付きセットアップ
Rozetka Marketplace を Claude に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Rozetka Marketplace を接続して、MCP URL を Claude に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
こう聞いてみよう
Rozetka Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Rozetka Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Rozetka Marketplace + Claude
ウクライナ最大のマーケットプレイスであるRozetkaマーケットプレイスの売り手API:ステータスと運送状(TTN)の更新、支払いステータス、大量の価格と在庫の更新、新しいリスト、ショップレビュー、製品に関する質問と回答、バイヤーチャット、返品リクエスト。売り手キャビネットのログインでサインインします。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
ステップ1 — 認証情報を取得する
APIはRozetka売り手キャビネット(seller.rozetka.com.ua)のログインとパスワードでサインインします。別途APIキーはありません。
- キャビネットのログインを
ROZETKA_USERNAMEに入力します。 - RozetkaはパスワードをBase64エンコードされた形式で期待するため、
ROZETKA_PASSWORD_BASE64にはエンコードされた形式を入力します。自分のコンピュータでエンコードしてください。例えば、ターミナルでprintf '%s' 'your-password' | base64を実行し、結果を貼り付けます。実際のパスワードにオンラインエンコーダーを使用しないでください。 AnythingMCPはPOST /sitesでサインインし、セッショントークンをBearerトークンとして送信します。Rozetkaはトークンが使用されている間は有効に保ち、24時間使用されないと期限切れにします。コネクタは4時間ごとに再度サインインします。ログインまたはパスワードが間違っている場合はincorrect_username_passwordとして報告されます。
どこから始めるか:rozetka_get_order_countsとrozetka_get_message_countsは待機中のもの(新しい注文、未読チャット、オープンな返品リクエスト)を表示します。その後、rozetka_list_ordersをtypes=4(新しい)またはtypes=2(処理中)で使用します。
注文
rozetka_list_order_statusesは、注文の数値statusをその名前にマッピングします。rozetka_list_ordersはtypes(1すべて、2処理中、3完了、4新しい、5配達中、6失敗)やステータスまたは日付でフィルタリングします。rozetka_get_orderは1つの注文を読み取ります。アイテム、配達、バイヤーのためにexpand=purchases,delivery,userを追加し、注文が次に移動する可能性のあるステータスのためにstatus_availableを追加します。rozetka_update_orderはステータスを変更し、運送状(TTN)と売り手のコメントを追加します。通常のフロー:新しい注文(1)-> 2(梱包中)で確認 -> ステータス3(運送業者に引き渡し)または61(引き渡し予定)でTTNを追加;ステータス2で送信されたTTNは注文を61に移動します。TTNが追加されると、Rozetkaは小包を追跡し、ステータスを自動的に変更します。ステータス7以上は主にキャンセルまたは配達状態です(例:16/42在庫切れ、18バイヤーに連絡不可、40バイヤーが気が変わった、45バイヤーによってキャンセル):売り手が要求した場合のみキャンセルを設定してください。元に戻すことはできません。最初にstatus_availableを確認してください。rozetka_get_order_payment_statusは、オンライン支払いが支払われたか、未払いか、確認中か、キャンセルされたかを示します(キャッシュは5分間有効)。
商品と価格
rozetka_list_goodsとrozetka_get_goodsは売り手の商品の情報を読み取ります。rozetka_get_goods_countsはキャビネットタブごとにそれらをカウントします(エラー、モデレーション、確認待ち)。rozetka_update_goods_price_stockは、1つまたは複数の商品に対してitem_rz_id(RozetkaのID、商品リストのid/rz_item_id、内部のitem_idではありません)で価格と在庫を変更します。価格はUAHで表示されます。Rozetkaは、価格が1.5倍以上上昇したり、半分以上削減された場合、マネージャーの確認を求めます。- 商品ステータスID:0ロック、1アクティブ、2新規、3モデレーション待ち、4モデレーション中、5モデレーションにより拒否、6モデレーターの確認が必要、7アーカイブ、8モデレーション待ち。販売ステータス:0利用不可、1供給予定、2電話、3在庫切れ、4利用可能、5アーカイブ、6厳密に利用不可、7在庫切れ、8非表示。
- 新しいリスト:
rozetka_list_goods_categories(カテゴリを見つける;is_vendor_requiredが1の場合、製造者が必須)->rozetka_list_category_attributes(その特性;pageSizeを増やすと、APIはデフォルトで5を返します)->rozetka_list_attribute_values(リストタイプの特性の許可された値)->rozetka_list_producers->rozetka_create_goodsにロシア語とウクライナ語の名前、価格、在庫、画像URLを指定します。新しい商品はRozetkaのモデレーションを経て表示されます。
レビュー、質問、チャット
- ショップレビュー:
rozetka_list_store_reviews(例:reply_search=0は回答のないレビュー、vote=dislikeは否定的なもの)、その後rozetka_reply_store_reviewでレビューのidとそのorder_idを指定します。 - 製品レビューと質問:
rozetka_list_goods_commentsでisAnswered=0を指定すると、売り手を待っているスレッドがリストされます。rozetka_reply_goods_commentで回答します(parent_id= コメントID、item_id=item.id)。 - チャット:
rozetka_list_chats(msgType=ordersは注文チャット、itemsは製品質問、has_response_to_user=0は未回答のもの)、rozetka_get_chatでメッセージを読み取ります(これにより既読になります)、rozetka_get_order_chatで注文のチャットを見つけ、rozetka_send_messageでchat_idとバイヤーのuser_idをreceiver_idとして指定します。 - 返信、回答、メッセージは公開されているか、バイヤーに届きます:テキストをドラフトし、売り手に見せて、同意した後にのみ送信します。バイヤーの言語、通常はウクライナ語で書いてください。返信と製品の回答は、表示される前にRozetkaによってモデレーションされます。
返品:rozetka_list_refund_requests(rozetka_list_refund_statusesからのステータスコード)、rozetka_get_refund_requestで理由、バイヤーが望む決定、チャットを取得し、rozetka_save_refund_ttnで返品運送状を保存します。rozetka_update_refund_status(リクエストを受け入れるか拒否する)は、受け入れることでバイヤーに返金される可能性があるため、オフに設定されています。管理者が意図的にオンにします。返品リクエストIDには文字が含まれています(例:AM1234567)。
含まれていないもの:残高、請求書、支払い、財務領収書(PRRO)、運送業者との有料運送状の作成、マネージャーアカウントと削除。コネクタはお金を移動させることはありません。
フォーマットと注意点
- Rozetkaは、呼び出しが失敗してもHTTP 200で応答し、
success: falseを返します。コネクタはこれをエラーに変換し、errors.messageとerrors.codeを持ちます。例えば、incorrect_access_token(1020)やaccess_denied(1010、アカウントの役割に権限が不足しています)。 - 価格はUAHで表示されます。フィルターの日付はYYYY-MM-DD形式です;タイムスタンプは
YYYY-MM-DD HH:MM:SS形式で、タイムゾーンは含まれません。 - テキストはキャビネットの言語(ウクライナ語またはロシア語)で提供されます;返品リクエストの回答はウクライナ語で行われます。
ページネーションと制限:リストはcontentの下にあり、_meta(totalCount、pageCount、currentPage、perPage)があります。currentPageがpageCountと等しくなるまで、page + 1で再度呼び出します。注文、レビュー、チャットはページごとに20件、商品、カテゴリ、ディレクトリはpageSizeを受け入れます。公開されているレート制限はありません;タイトなループを避け、複数の単一更新よりも1回の大量更新を好んでください。
クラウドの到達可能性:api-seller.rozetka.com.uaはHTTPS経由で公開されており、AnythingMCP Cloudおよび自己ホストされたインストールからアクセス可能です。
ステップ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 — Claudeにコネクタを追加する
あなたのサーバーURL:AnythingMCPで、MCP Serversを開き、このコネクタがあるサーバーのURLをコピーします(
https://cloud.anythingmcp.com/mcp/…)。このガイドがYOUR_SERVER_IDを示す場所で使用します。
推奨パス:claude.ai webで動作し、設定ファイルを編集する必要はありません。
- Claudeで、Plugins(一部のプランではまだ Customize)→ Connectorsを開きます。
- + Addをクリックし、次にAdd custom connectorを選択します。
- 名前を入力します(例:
Rozetka Marketplace)と、リモートMCPサーバーのURLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、次にContinue をクリックし、検出された設定のまま、もう一度 Continue をクリックします。 - Sign in now を選んで Add をクリックし、AnythingMCPにサインインしてアクセスを許可します。
以下のすべてのツールがチャットに表示されます:プロンプトの入力を開始してください。
利用可能なツール
| ツール | 機能 |
|---|---|
rozetka_list_orders | 売り手のRozetka注文を検索します。ページごとに20件、ステータスグループ、ステータス、作成または変更日、注文ID、バイヤーの電話番号または運送状(TTN)で検索します。… |
rozetka_get_order | IDで1つのRozetka注文を取得し、金額、ステータス、コメントを表示します。アイテム(購入)、配達、バイヤー(ユーザー)、ステータス履歴のためにexpandを使用します… |
rozetka_list_order_statuses | Rozetkaの注文ステータスをID、ウクライナ語、ロシア語、英語の名前とステータスグループでリストし、注文の数値ステータスを読み取ります |
rozetka_list_goods | 売り手のRozetkaの商品を名前、テキスト、記事、価格リストIDまたはRozetka ID、可用性またはカテゴリで検索します。IDを返します… |
rozetka_get_goods | 売り手のRozetkaの商品詳細を取得します(価格、カテゴリ、説明、在庫状態)内部のitem_idまたは… |
rozetka_update_order | Rozetkaの注文のステータスを変更し、運送状番号(TTN)および/または売り手のコメントを追加します。更新された注文を返します。TTNが必要です… |
rozetka_get_order_counts | 売り手のRozetka注文をグループごとにカウントします:inProgress(処理中)、新しい、配達中、inDone(完了)、inNotDone(失敗)、未監視… |
rozetka_get_order_payment_status | オンラインで支払われた注文の現在の支払いステータスを取得します:status_payment_id、名前(支払い済み、未払い、キャンセル、未承認、一部支払い…)… |
rozetka_update_goods_price_stock | 売り手の1つまたは複数の商品に対して、1回の呼び出しで価格と在庫を更新します(大量更新)。各エントリにはitem_rz_idが必要です(RozetkaのID、id… |
rozetka_get_goods_counts | 売り手の商品のキャビネットセクションごとのカウント:アクティブ、非アクティブ、新規、モデレーション中、確認待ち、承認待ち… |
rozetka_create_goods | 売り手のRozetkaキャビネットに新しい商品リストを作成します。ロシア語とウクライナ語の名前、カテゴリが必要です… |
rozetka_list_goods_categories | 売り手が商品を作成できるRozetkaカテゴリをタイトルまたはIDで検索します。ID、ウクライナ語、ロシア語、英語のタイトルを返します… |
rozetka_list_category_attributes | Rozetkaカテゴリの特性(属性)をリストし、rozetka_create_goodsのパラメータに必要です。ID、タイトル、単位、タイプを返します… |
rozetka_list_attribute_values | カテゴリ内の1つまたは複数の特性の許可された値をリストします(ID、ウクライナ語、ロシア語、英語のタイトル)、リストタイプのパラメータ用に… |
rozetka_list_producers | 名前またはIDでRozetkaの製造者(ブランド)ディレクトリを検索します。rozetka_create_goodsの製造者用。ID、タイトル、ステータスを返します。100… |
rozetka_list_store_reviews | ショップのバイヤーレビューを検索します(製品のレビューではありません):ID、order_id、バイヤー名、コメント、全体の投票(いいね、中間、嫌い)、投票数… |
rozetka_reply_store_review | ショップレビューに対する売り手の公開返信を公開します。rozetka_list_store_reviewsからレビューIDとそのorder_idが必要です。返信を返します… |
rozetka_list_goods_comments | 売り手の商品に関するバイヤーのレビューと質問を検索します:ID、タイプ(コメントまたは質問)、テキスト、マーク(評価1-5)、長所と短所、著者… |
rozetka_reply_goods_comment | 製品レビューまたは質問に対する売り手の公開回答を投稿します。parent_idはコメントID、item_idは…からのitem.idです。 |
rozetka_get_message_counts | 未読および総バイヤーチャットとリクエストをカウントします:totalUnread、ordersChatUnread、itemsChatUnread、sellerChatUnread、customerRequestsUnread… |
rozetka_list_chats | 売り手のバイヤーとのチャットを検索します:注文チャット、製品質問、または削除されたチャット。チャットID、件名、バイヤー(user_id、名前)を返します… |
rozetka_get_chat | バイヤーとの1つのチャットを開き、デフォルトでそのメッセージを表示します。件名、バイヤーユーザーID(rozetka_send_messageのreceiver_id)を返します… |
rozetka_get_order_chat | 注文に属するチャットを取得します。注文IDによるチャットID、件名、バイヤーユーザーID、expandを使用するとメッセージが取得できます。… |
rozetka_send_message | 既存のチャットでバイヤーにメッセージを送信します。chat_idとreceiver_id(rozetka_get_chatまたは…からのバイヤーのuser_id)が必要です。 |
rozetka_list_refund_requests | バイヤーの返品および返金リクエストを検索します:リクエストID(文字と数字、例:AM1234567)、status_title、reason_title、order_id、商品名… |
rozetka_get_refund_request | 1つの返品または返金リクエストを取得します:ステータス、理由とサブ理由、バイヤーのコメント、望ましい決定(decision_title)、注文と商品… |
rozetka_list_refund_statuses | 返品および返金リクエストのステータスコードをリストします(status_codeとそのウクライナ語タイトル)、rozetka_list_refund_requestsのフィルタリング用… |
rozetka_save_refund_ttn | 返品リクエストの返品小包の運送状(TTN)を保存します。例えば、売り手が交換品を送信する場合やバイヤーの返品発送時に… |
rozetka_update_refund_status | 返品または返金リクエストを別のステータスに移動します(受け入れ、理由付きで拒否、商品受領…)。リクエストを受け入れると、バイヤーに返金される可能性があります。 |
例のプロンプト
- "新しいRozetkaの注文と未読のバイヤーメッセージはいくつありますか?"
- "注文123456789をバイヤー、配達、アイテムと共に表示してください。"
- "商品987654の価格を1,499 UAHに設定し、在庫を20にしてください。"
- "今週のショップレビューでまだ返信がないものはどれですか?各レビューに対する回答をドラフトしてください。"
- "注文123456789にNova Poshtaの運送状20450000000000を追加し、出荷済みとしてマークしてください。"
FAQ
Claude CodeとClaude Desktopの両方で動作しますか? はい、両方ともhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを指します。
どのログインを使用しますか? あなたのRozetka売り手キャビネットのログイン(seller.rozetka.com.ua)で、パスワードはBase64エンコードされています。コネクタは4時間ごとに再度サインインします。
注文や価格を変更できますか? はい:注文ステータスと運送状(TTN)、大量の価格と在庫の更新、新しい商品、レビューへの返信、質問、バイヤーチャット。返品リクエストのステータスを変更することはオフに設定されています。返品を受け入れることはバイヤーに返金される可能性があります。
残高や支払いに関与しますか? いいえ。残高、請求書、支払い、財務領収書(PRRO)、運送業者との有料運送状の作成は含まれていません。
次のステップ
このガイドは役に立ちましたか?