摘要
Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。
引导式设置
2 分钟将 Rozetka Marketplace 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Rozetka Marketplace,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Rozetka Marketplace 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Rozetka Marketplace,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Rozetka Marketplace + Cursor
Rozetka 市场卖家 API 适用于乌克兰最大的市场:订单状态和运单 (TTN) 更新、支付状态、商品的批量价格和库存更新及新列表、商店评论和产品问题及回复、买家聊天和退货请求。使用卖家柜台登录进行登录。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
第一步 — 获取凭据
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 小时未使用后让其过期;连接器每四小时重新登录一次。错误的登录名或密码将报告为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
第三步 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
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)和与承运人创建的已付运单不包括在内。
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?