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

将 Rozetka MCP 连接到 Gemini CLI

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 连接到 Gemini

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

无需信用卡 · 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 Marketplace + Gemini

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

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64

第一步 — 获取凭据

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(计划交接);运单状态为 2 时,订单转为 61。添加运单后,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 和自托管安装均可访问。

第二步 — 安装适配器

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

第三步 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 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 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,并标记为已发货。"

常见问题

使用哪个登录? 你的 Rozetka 卖家柜台登录(seller.rozetka.com.ua),密码为 Base64 编码。连接器每四小时重新登录一次。

它可以更改订单和价格吗? 可以:订单状态和运单 (TTN)、批量价格和库存更新、新商品、对评论、问题和买家聊天的回复。更改退货请求的状态默认关闭,因为接受退货可能会退款给买家。

它会处理余额或支付吗? 不。余额、发票、支付、财政收据(PRRO)和与承运人创建的已付运单不包括在内。

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

2 分钟将 Rozetka Marketplace 连接到 Gemini

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

相关指南

连接器

将 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 连接到 Meta Muse

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

连接器

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

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