摘要
Wish 市场 API v3 为商家提供:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评分、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。
引导式设置
2 分钟将 Wish 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Wish,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Wish 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Wish,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Wish
Wish 市场 API v3 为商家提供:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评分、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。
设置
设置大约需要 10 分钟。
- 在 Wish 商家仪表板 (https://merchant.wish.com) 打开账户菜单,选择 API 设置,点击 注册私有应用。输入一个名称和你拥有的 HTTPS 重定向 URI(任何页面都可以,代码只需出现在其地址中)。Wish 每个商家允许一个私有应用。
- 打开
https://merchant.wish.com/v3/oauth/authorize?client_id=后跟应用的客户端 ID,登录并批准。Wish 会重定向到你的重定向 URI,地址中带有?code=;该代码有效期为 5 分钟,仅可使用一次。 - 交换代码:打开
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_categories | Wish 类别树的根节点及其子类别(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 的评分是多少?"
下一步
这份指南对你有帮助吗?