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

将 Wish MCP 连接到 Cursor

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

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

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

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

前提条件

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

WISH_ACCESS_TOKEN

第一步 — 获取凭据

设置大约需要 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 头部。

第二步 — 安装适配器

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" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 Cursor。
  3. 打开 Cursor → Settings → MCP,确认 anythingmcp 已列出并处于已连接状态。
  4. 开始对话 — 智能体现在可以调用 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、名称、is_leaf)。使用 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 的评级是多少?"

常见问题

令牌会自动续订吗? 不会。Wish 访问令牌在 30 天后过期,Wish 仅通过连接器的自动续订未发送的请求续订。请在令牌过期前使用你的刷新令牌续订,并粘贴新的令牌。

令牌来自哪里? 来自你在 Wish 商家仪表板下 API 设置中注册的私有应用:授权它,交换代码以获取访问令牌并粘贴该令牌。

哪些工具安装时默认关闭? wish_refund_order 和 wish_delete_product。仅在 AI 应该使用它们时在连接器页面上启用它们。

Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

这份指南对你有帮助吗?

2 分钟将 Wish 连接到 Cursor

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

相关指南

连接器

将 Wish MCP 连接到 ChatGPT

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

连接器

将 Wish MCP 连接到 Claude

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

连接器

将 Wish MCP 连接到 Microsoft Copilot

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

连接器

将 Wish MCP 连接到 Gemini CLI

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

连接器

将 Wish MCP 连接到 Meta Muse

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

连接器

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

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