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

Wish MCP 服务器:订单、商品与工单

Wish 市场 API v3 为商家提供:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评分、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

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

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

Wish

Wish

Wish Marketplace API v3 for merchants: orders and fulfillment with tracking, products and variations with prices and inventory per warehouse, categories and attributes, customer support tickets, ratings, penalties, warehouses and shipping settings. OAuth access token from a private app.

个工具

25

区域

INTL

类别

电子商务

身份验证

Bearer Token

所需环境变量

WISH_ACCESS_TOKEN
在 Cloud 上一键安装

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

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

摘要

Wish 市场 API v3 为商家提供:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评分、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

引导式设置

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

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

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

试试这样问

Wish 的示例提示

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

Wish · 通过 MCP 实时
分享
Opus 4.7

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

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

Wish

Wish 市场 API v3 为商家提供:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评分、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

设置

设置大约需要 10 分钟。

  1. 在 Wish 商家仪表板 (https://merchant.wish.com) 打开账户菜单,选择 API 设置,点击 注册私有应用。输入一个名称和你拥有的 HTTPS 重定向 URI(任何页面都可以,代码只需出现在其地址中)。Wish 每个商家允许一个私有应用。
  2. 打开 https://merchant.wish.com/v3/oauth/authorize?client_id= 后跟应用的客户端 ID,登录并批准。Wish 会重定向到你的重定向 URI,地址中带有 ?code=;该代码有效期为 5 分钟,仅可使用一次。
  3. 交换代码:打开 https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=... 并填入你的值。将 data.access_token 复制到 WISH_ACCESS_TOKEN 中,并妥善保管 data.refresh_token。

令牌有效期:Wish 访问令牌在 30 天 后过期。在此之前,打开 https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... 并将新的访问令牌粘贴到连接器中(旧的令牌将被撤销)。Wish 仅通过 GET 请求续订令牌,而连接器的自动 OAuth 续订不会发送此请求,因此目前续订是手动的。

从哪里开始:wish_test_token 检查令牌并显示其作用域。wish_list_orders 状态为 APPROVED 的订单列出待发货的订单;wish_list_products 列出目录;wish_list_warehouses 提供库存所需的仓库 ID。

订单:wish_list_orders,wish_get_order。使用 wish_fulfill_order 发货(承运人来自 wish_list_shipping_carriers,跟踪号码,发货国家);同一调用可以稍后更正跟踪。发货和退款是异步的:再次读取订单以查看结果。wish_list_refund_reasons 显示有效的退款原因;wish_refund_order 退款给客户,默认关闭。

产品:wish_list_products,wish_get_product,wish_create_product,wish_update_product(价格、每个仓库的库存、按变体 ID 的变体状态),wish_create_variation。类别:wish_get_categories,wish_get_category,wish_get_category_attributes。wish_delete_product 默认关闭;请改为禁用变体。wish_get_product_rating 读取评分。

客户票:wish_list_tickets(状态 AWAITING_MERCHANT 需要回复),wish_get_ticket,wish_reply_to_ticket,wish_update_ticket(关闭、重新打开、上诉)。

账户:wish_get_account_details,wish_list_penalties,wish_get_shipping_settings,wish_list_warehouses。

分页:列表返回最多 limit 项,按时间排序;下一页再次调用时将 updated_at_max(或 created_at_max)设置为最后一项的时间。每个响应的格式为 code,message,data;code 为 0 表示成功。

ID 和格式:订单、产品、变体、票和仓库 ID 是 24 字符的十六进制字符串。时间为 ISO 8601 格式(2026-11-01T00:00:00Z)。价格是包含 amount 和 currency_code 的对象。令牌的作用域决定了哪些功能可用:缺少作用域会返回 403。

速率限制:按商家和应用;头部 Wish-Rate-Limit-Remaining 显示剩余数量,429 状态携带 Wish-Rate-Limit-Reset。联系 Wish 询问调用时请引用 Wish-Request-Id 头部。

前提条件:WISH_ACCESS_TOKEN

本地安装连接器

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,选择 Wish 并粘贴前提条件下列出的环境变量。

可用工具

工具功能
wish_test_token检查访问令牌是否有效:返回商家 ID 和令牌的作用域
wish_get_account_details商家账户:ID、显示名称、联系方式、国家、状态及其他账户详情
wish_list_orders列出订单,默认按最近更新的顺序:ID、状态(APPROVED 待发货、SHIPPED、REFUNDED、REQUIRE_REVIEW)、订单类型、产品…
wish_get_order按 ID 获取一个订单:状态、产品和变体、数量、价格和付款、运输地址、履行要求和截止日期…
wish_list_shipping_carriers接受的运输承运人:所有承运人(GENERAL)或接受的目的国确认交付政策的承运人…
wish_fulfill_order标记订单已发货,或更新其跟踪信息:承运人、跟踪号码和发货国家。异步;再次读取订单以查看…
wish_list_refund_reasons当前有效的退款原因(在订单生命周期中会变化)。在退款前读取它们
wish_refund_order退款或取消订单,理由来自 wish_list_refund_reasons。客户会收到退款,无法撤销;退款…
wish_list_products列出产品,默认按最近更新的顺序:ID、parent_sku、名称、状态、类别、图片、变体(ID、SKU、价格、库存…
wish_get_product按 ID 获取一个产品及其变体、每个仓库的价格、库存、图片、属性、运输和评价状态
wish_create_product创建一个至少有一个变体的产品。需要名称、描述(纯文本,最多 4,000 个字符)、parent SKU、类别、主要…
wish_update_product更新产品:名称、描述、标签、类别、图片、默认运输价格、状态或其现有变体(按变体 ID…
wish_delete_product删除产品列表。无法撤销。默认关闭;请改为使用 wish_update_product 禁用变体
wish_create_variation向现有产品添加变体:SKU、价格、每个仓库的库存、选项值和图片
wish_get_categoriesWish 类别树的根节点及其子类别(ID、名称、是否为叶子节点)。使用 wish_get_category 向下遍历到叶子节点以获取 category_id
wish_get_category按 ID 获取一个类别及其子类别;叶子类别可用作 category_id
wish_get_category_attributes类别的属性(名称、是否必需、允许的值)以在创建产品时填写属性和选项
wish_get_product_rating产品的总体评分:平均评分和评分数量
wish_list_tickets客户支持票,默认按最近更新的顺序:ID、类型(ORDER、PRE_PURCHASE、POST_CUSTOMER_SUPPORT)、状态(AWAITING_MERCHANT…
wish_get_ticket一个支持票及其消息、相关订单和状态
wish_reply_to_ticket回复状态为 AWAITING_MERCHANT 的票(最多 2,000 个字符,允许 Markdown)。Wish 在回复后更新状态
wish_update_ticket关闭票(CLOSED)、重新打开已关闭的票(AWAITING_MERCHANT,允许时)或向 Wish 支持上诉(AWAITING_WISH)
wish_list_penalties账户上的罚款,最新的在前:ID、类型、金额和货币、原因、订单或产品、创建和撤销时间。最多 500 条…
wish_get_shipping_settings每个 Wish 发货目的国的商家运输设置:启用的国家、运输价格和地区
wish_list_warehouses商家的仓库:ID、名称、类型(标准仓库优先)、地址。仓库 ID 在库存和运输价格中是必需的

示例提示

  • "今天哪些 Wish 订单需要履行?"
  • "使用 USPS 跟踪 9400111899223197428490 履行订单 64a1b2c3d4e5。"
  • "哪些支持票在等待我的回复?"
  • "这个月我的账户上有没有新的罚款?"
  • "产品 5f9e8d7c6b5a 的评分是多少?"

下一步

这份指南对你有帮助吗?

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

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

相关指南

连接器

将 Wish MCP 连接到 ChatGPT

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

连接器

将 Wish MCP 连接到 Claude

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

连接器

将 Wish MCP 连接到 Microsoft Copilot

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

连接器

将 Wish MCP 连接到 Cursor

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

连接器

将 Wish MCP 连接到 Gemini CLI

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。

连接器

将 Wish MCP 连接到 Meta Muse

Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。