概要
ウクライナ最大のマーケットプレイスであるRozetka MarketplaceのセラーAPI:ステータスと運送状(TTN)の更新を伴う注文、支払いステータス、大量の価格と在庫の更新および新しいリスト、ショップレビューと商品に関する質問と回答、バイヤーチャット、返品リクエスト。セラーキャビネットのログインでサインインします。
ガイド付きセットアップ
Rozetka Marketplace を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Rozetka Marketplace を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Rozetka Marketplace のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Rozetka Marketplaceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Rozetka Marketplace
ウクライナ最大のマーケットプレイスであるRozetka MarketplaceのセラーAPI:ステータスと運送状(TTN)の更新を伴う注文、支払いステータス、大量の価格と在庫の更新および新しいリスト、ショップレビューと商品に関する質問と回答、バイヤーチャット、返品リクエスト。セラーキャビネットのログインでサインインします。
セットアップ
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を受け入れます。公開されているレート制限はありません。タイトなループを避け、単一の更新よりも一括更新を好んでください。
クラウドの到達可能性:api-seller.rozetka.com.uaはHTTPS経由で公開されており、AnythingMCP Cloudおよび自己ホストされたインストールからアクセス可能です。
前提条件:ROZETKA_USERNAME、ROZETKA_PASSWORD_BASE64
コネクタをローカルにインストールする
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を開き、Rozetka Marketplaceを選択し、前提条件に記載されている環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
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(処理中)、new(新規)、delivering(配達中)、inDone(完了)、inNotDone(失敗)、unwatched… |
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 | Rozetkaの製造者(ブランド)ディレクトリを名前またはIDで検索します。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を追加し、出荷済みとしてマークします。」
次のステップ
このガイドは役に立ちましたか?