摘要
Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。
引导式设置
2 分钟将 Wish 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Wish,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Wish 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Wish,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Wish + Gemini
Wish 市场 API v3 供商家使用:带有跟踪的订单和履行、每个仓库的产品和变体的价格和库存、类别和属性、客户支持票、评级、罚款、仓库和运输设置。来自私有应用的 OAuth 访问令牌。
前提条件
查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
WISH_ACCESS_TOKEN
第一步 — 获取凭据
设置大约需要 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 头部。
第二步 — 安装适配器
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" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
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、名称、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 应该使用它们时在连接器页面上启用它们。
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?