连接器指南阅读约 4 分钟29 个 MCP 工具7 种语言

Rozetka MCP 服务器:订单、商品与库存

Rozetka 市场卖家 API,适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家账户登录。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Rozetka Marketplace

Rozetka Marketplace

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

个工具

29

区域

INTL

类别

电子商务

身份验证

Sign-in token

所需环境变量

ROZETKA_USERNAMEROZETKA_PASSWORD_BASE64
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Rozetka 市场卖家 API,适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家账户登录。

引导式设置

2 分钟将 Rozetka Marketplace 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Rozetka Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Rozetka Marketplace 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Rozetka Marketplace · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 不想安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Rozetka Marketplace,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Rozetka 市场

Rozetka 市场卖家 API,适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家账户登录。

设置

API 使用 Rozetka 卖家账户的登录名和密码进行登录 (seller.rozetka.com.ua);没有单独的 API 密钥。

  1. 将账户登录名放入 ROZETKA_USERNAME。
  2. Rozetka 期望密码为 Base64 编码,因此 ROZETKA_PASSWORD_BASE64 需要编码形式,而不是明文密码。在你自己的计算机上编码,例如在终端中运行 printf '%s' 'your-password' | base64,然后粘贴结果。请勿使用在线编码器处理真实密码。 AnythingMCP 使用 POST /sites 登录,并将会话令牌作为 Bearer 令牌发送。Rozetka 在使用期间保持令牌有效,并在 24 小时未使用后让其过期;连接器每四小时重新登录一次。错误的登录名或密码将报告为 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 读取一个订单。添加 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 通过 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)。再次调用时将 page + 1,直到 currentPage 等于 pageCount。订单、评论和聊天每页返回 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按状态组、状态、创建或更改日期、订单 id、买家电话或运单 (TTN) 搜索卖家的 Rozetka 订单,每页 20 条。…
rozetka_get_order通过 id 获取一个 Rozetka 订单,包括金额、状态和评论。使用 expand 获取商品(购买)、交付、买家(用户)、状态历史…
rozetka_list_order_statuses列出 Rozetka 订单状态,包含 id、乌克兰语、俄语和英语名称及状态组,以读取订单的数字状态
rozetka_list_goods按名称、文本、文章、价格表 id 或 Rozetka id、可用性或类别搜索卖家的商品(所有标签)。返回 id…
rozetka_get_goods通过内部 item_id 或… 获取卖家在 Rozetka 上的商品详细信息(价格、类别、描述、库存状态)
rozetka_update_order更改 Rozetka 订单的状态,添加运单号 (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一次性更新一个或多个卖家商品的价格和库存(批量更新)。每个条目需要 item_rz_id(Rozetka id,id 在…
rozetka_get_goods_counts按账户部分计数卖家的商品:活跃、非活跃、新、待审核、等待确认、等待批准…
rozetka_create_goods在卖家的 Rozetka 账户中创建新产品列表。需要俄语和乌克兰语名称、类别来自…
rozetka_list_goods_categories按标题或 id 搜索卖家可以创建商品的 Rozetka 类别。返回 id、乌克兰语、俄语和英语标题…
rozetka_list_category_attributes列出 Rozetka 类别的特征(属性),在 rozetka_create_goods 中需要的参数。返回 id、标题、单位、类型…
rozetka_list_attribute_values列出类别中一个或多个特征的允许值(id、乌克兰语、俄语和英语标题),用于 rozetka_create_goods 中的列表型参数…
rozetka_list_producers按名称或 id 搜索 Rozetka 生产者(品牌)目录,用于 rozetka_create_goods 的生产者。返回 id、标题和状态,100…
rozetka_list_store_reviews搜索买家的商店评论(不是产品评论):id、order_id、买家姓名、评论、总体投票(喜欢、中立、不喜欢)、投票…
rozetka_reply_store_review发布卖家对商店评论的公开回复。需要评论 id 和来自 rozetka_list_store_reviews 的 order_id。返回回复…
rozetka_list_goods_comments搜索买家对卖家商品的评论和问题:id、类型(评论或问题)、文本、评分(1-5)、优缺点、作者…
rozetka_reply_goods_comment发布卖家对产品评论或问题的公开回答。parent_id 是评论 id,item_id 是来自…
rozetka_get_message_counts计数未读和总买家聊天及请求:totalUnread、ordersChatUnread、itemsChatUnread、sellerChatUnread、customerRequestsUnread…
rozetka_list_chats搜索卖家与买家的聊天:订单聊天、产品问题或已删除聊天。返回聊天 id、主题、买家(user_id、姓名)…
rozetka_get_chat打开与买家的一个聊天,默认显示其消息。返回主题、买家 user_id(rozetka_send_message 的 receiver_id…
rozetka_get_order_chat通过订单 id 获取属于该订单的聊天:聊天 id、主题、买家 user_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获取一个退货或退款请求:状态、原因和子原因及买家的评论、想要的决定(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。”
  • “本周哪些商店评论尚未回复?为每个草拟一个答案。”
  • “将 Nova Poshta 运单 20450000000000 添加到订单 123456789 并标记为已发货。”

下一步

这份指南对你有帮助吗?

2 分钟将 Rozetka Marketplace 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Rozetka Marketplace,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

将 Rozetka MCP 连接到 Microsoft Copilot

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。

连接器

将 Rozetka MCP 连接到 ChatGPT

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。

连接器

将 Rozetka MCP 连接到 Claude

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。

连接器

将 Rozetka MCP 连接到 Cursor

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。

连接器

将 Rozetka MCP 连接到 Gemini CLI

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。

连接器

将 Rozetka MCP 连接到 Meta Muse

Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。