ebay-mcp 1.13.3 → 1.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/README.de.md +8 -3
  2. package/README.es.md +8 -3
  3. package/README.fr.md +8 -3
  4. package/README.ja.md +8 -3
  5. package/README.ko.md +8 -3
  6. package/README.md +73 -21
  7. package/README.pt-BR.md +8 -3
  8. package/README.ru.md +8 -3
  9. package/README.zh-CN.md +8 -3
  10. package/build/api/account-management/account.js +633 -297
  11. package/build/api/analytics-and-report/analytics.js +111 -65
  12. package/build/api/client.js +199 -140
  13. package/build/api/clientRequestError.js +23 -0
  14. package/build/api/clientTrading.js +213 -0
  15. package/build/api/clientTradingError.js +4 -0
  16. package/build/api/communication/feedback.js +147 -59
  17. package/build/api/communication/message.js +134 -81
  18. package/build/api/communication/negotiation.js +65 -53
  19. package/build/api/communication/notification.js +458 -164
  20. package/build/api/developer/developer.js +99 -45
  21. package/build/api/index.js +23 -8
  22. package/build/api/listing-management/inventory.js +5 -340
  23. package/build/api/listing-management/items.js +408 -0
  24. package/build/api/listing-management/locations.js +172 -0
  25. package/build/api/listing-management/offers.js +284 -0
  26. package/build/api/listing-management/shared.js +1 -0
  27. package/build/api/listing-metadata/metadata.js +416 -170
  28. package/build/api/listing-metadata/taxonomy.js +187 -42
  29. package/build/api/marketing-and-promotions/ads.js +621 -0
  30. package/build/api/marketing-and-promotions/campaigns.js +362 -0
  31. package/build/api/marketing-and-promotions/marketing.js +6 -734
  32. package/build/api/marketing-and-promotions/promotions.js +422 -0
  33. package/build/api/marketing-and-promotions/recommendation.js +49 -24
  34. package/build/api/marketing-and-promotions/reports.js +137 -0
  35. package/build/api/marketing-and-promotions/shared.js +4 -0
  36. package/build/api/order-management/dispute.js +226 -45
  37. package/build/api/order-management/fulfillment.js +144 -71
  38. package/build/api/order-management/orderIssueHelpers.js +61 -0
  39. package/build/api/other/compliance.js +50 -38
  40. package/build/api/other/edelivery.js +603 -159
  41. package/build/api/other/finding.js +280 -0
  42. package/build/api/other/identity.js +30 -15
  43. package/build/api/other/translation.js +29 -14
  44. package/build/api/other/vero.js +113 -27
  45. package/build/api/rateLimitTracker.js +55 -0
  46. package/build/api/shared/request.js +189 -98
  47. package/build/api/trading/trading.js +154 -87
  48. package/build/auth/credentialSession.js +250 -0
  49. package/build/auth/oauth.js +298 -171
  50. package/build/{utils/oauth-helper.js → auth/oauthHelper.js} +127 -90
  51. package/build/auth/{oauth-metadata.js → oauthMetadata.js} +22 -6
  52. package/build/auth/oauthMiddleware.js +104 -0
  53. package/build/auth/{scope-utils.js → scopeUtils.js} +101 -28
  54. package/build/auth/tokenVerifier.js +243 -0
  55. package/build/auth/tokenVerifierError.js +21 -0
  56. package/build/config/environment.js +148 -113
  57. package/build/config/{tool-families.js → toolFamilies.js} +30 -14
  58. package/build/index.js +25 -19
  59. package/build/mcp/{http-transport.js → httpTransport.js} +102 -52
  60. package/build/mcp/readOnlyFilter.js +67 -0
  61. package/build/mcp/runtime.js +31 -13
  62. package/build/mcp/{tool-gating.js → toolGating.js} +77 -49
  63. package/build/mcp/{ui-bridge.js → uiBridge.js} +77 -24
  64. package/build/schemas/account-management/account.js +144 -6
  65. package/build/schemas/analytics/analytics.js +33 -19
  66. package/build/schemas/communication/messages.js +12 -42
  67. package/build/schemas/developer/developer.js +135 -0
  68. package/build/schemas/fulfillment/orders.js +183 -21
  69. package/build/schemas/index.js +27 -19
  70. package/build/schemas/inventory-management/inventory.js +17 -9
  71. package/build/schemas/marketing/ads.js +769 -0
  72. package/build/schemas/marketing/campaigns.js +361 -0
  73. package/build/schemas/marketing/common.js +152 -0
  74. package/build/schemas/marketing/jsonSchemas.js +118 -0
  75. package/build/schemas/marketing/marketing.js +11 -1562
  76. package/build/schemas/marketing/promotions.js +480 -0
  77. package/build/schemas/marketing/reports.js +162 -0
  78. package/build/schemas/metadata/metadata.js +11 -6
  79. package/build/schemas/other/finding.js +27 -0
  80. package/build/schemas/other/otherApis.js +424 -0
  81. package/build/schemas/taxonomy/taxonomy.js +11 -5
  82. package/build/scripts/{auto-setup.js → autoSetup.js} +87 -74
  83. package/build/scripts/{build-ui.js → buildUi.js} +6 -1
  84. package/build/scripts/{dev-sync.js → devSync.js} +169 -110
  85. package/build/scripts/diagnostics.js +52 -44
  86. package/build/scripts/{download-specs.js → downloadSpecs.js} +29 -21
  87. package/build/scripts/{interactive-setup.js → interactiveSetup.js} +84 -78
  88. package/build/scripts/scopeHelper.js +270 -0
  89. package/build/scripts/securityChecker.js +316 -0
  90. package/build/scripts/setup.js +241 -178
  91. package/build/scripts/{setup-shared.js → setupShared.js} +29 -7
  92. package/build/{utils/setup-validator.js → scripts/setupValidator.js} +113 -94
  93. package/build/{utils/setup-wizard.js → scripts/setupWizard.js} +57 -46
  94. package/build/scripts/skills.js +35 -27
  95. package/build/scripts/updateApiStatusDoc.js +71 -0
  96. package/build/serverHttp.js +90 -0
  97. package/build/skills/content.js +124 -118
  98. package/build/skills/index.js +22 -10
  99. package/build/skills/install.js +21 -10
  100. package/build/skills/markers.js +50 -15
  101. package/build/skills/{registry-snapshot.js → registrySnapshot.js} +8 -2
  102. package/build/skills/render.js +41 -14
  103. package/build/skills/targets.js +49 -17
  104. package/build/tools/categories/account.js +166 -264
  105. package/build/tools/categories/analytics.js +11 -22
  106. package/build/tools/categories/browse.js +17 -0
  107. package/build/tools/categories/communication.js +124 -399
  108. package/build/tools/categories/connector.js +23 -20
  109. package/build/tools/categories/developer.js +43 -159
  110. package/build/tools/categories/fulfillment.js +84 -215
  111. package/build/tools/categories/index.js +6 -14
  112. package/build/tools/categories/inventory.js +238 -293
  113. package/build/tools/categories/marketing.js +677 -39
  114. package/build/tools/categories/metadata.js +190 -117
  115. package/build/tools/categories/other.js +81 -208
  116. package/build/tools/categories/taxonomy.js +29 -20
  117. package/build/tools/categories/{token-management.js → tokenManagement.js} +187 -192
  118. package/build/tools/categories/trading.js +16 -47
  119. package/build/tools/contracts.js +34 -24
  120. package/build/tools/{define-tool.js → defineTool.js} +44 -29
  121. package/build/tools/registry.js +87 -29
  122. package/build/tools/schemas.js +3 -57
  123. package/build/tools/ui/{map-helpers.js → mapHelpers.js} +69 -19
  124. package/build/tools/ui/maps.js +255 -101
  125. package/build/types/index.js +1 -1
  126. package/build/ui/card.html +1 -1
  127. package/build/ui/chart.html +1 -1
  128. package/build/ui/stat.html +1 -1
  129. package/build/ui/table.html +1 -1
  130. package/build/utils/apiStatusFeed.js +95 -0
  131. package/build/utils/cliOutput.js +15 -0
  132. package/build/utils/cliUi.js +108 -0
  133. package/build/utils/communication/feedback.js +57 -77
  134. package/build/utils/communication/message.js +69 -98
  135. package/build/utils/communication/negotiation.js +30 -57
  136. package/build/utils/communication/notification.js +112 -252
  137. package/build/utils/{date-converter.js → dateConverter.js} +62 -30
  138. package/build/utils/effectSchema.js +203 -0
  139. package/build/utils/effectSchemaAdapter.js +121 -0
  140. package/build/utils/effectSchemaChainMethods.js +146 -0
  141. package/build/utils/effectSchemaRefinements.js +104 -0
  142. package/build/utils/effectSchemaStringMethods.js +63 -0
  143. package/build/utils/effectSchemaTypes.js +47 -0
  144. package/build/utils/{env-parser.js → envParser.js} +10 -2
  145. package/build/utils/errors.js +7 -3
  146. package/build/utils/http.js +148 -89
  147. package/build/utils/{llm-client-detector.js → llmClientDetector.js} +295 -274
  148. package/build/utils/logger.js +127 -51
  149. package/build/utils/other/compliance.js +18 -38
  150. package/build/utils/other/identity.js +2 -2
  151. package/build/utils/other/translation.js +4 -4
  152. package/build/utils/other/vero.js +36 -20
  153. package/build/utils/schemaHelpers.js +22 -0
  154. package/build/utils/{token-utils.js → tokenUtils.js} +2 -2
  155. package/build/utils/trading/trading.js +35 -0
  156. package/build/utils/typeGuards.js +12 -0
  157. package/build/utils/version.js +65 -29
  158. package/package.json +9 -7
  159. package/build/api/client-trading.js +0 -124
  160. package/build/api/communication/shared.js +0 -59
  161. package/build/api/shared/query-params.js +0 -16
  162. package/build/auth/credential-session.js +0 -166
  163. package/build/auth/oauth-middleware.js +0 -100
  164. package/build/auth/token-verifier.js +0 -186
  165. package/build/schemas/other/other-apis.js +0 -390
  166. package/build/scripts/update-api-status-doc.js +0 -44
  167. package/build/server-http.js +0 -85
  168. package/build/tools/definitions/marketing.js +0 -1381
  169. package/build/tools/tool-handlers/marketing.js +0 -312
  170. package/build/tools/tool-handlers/types.js +0 -1
  171. package/build/utils/account-management/account.js +0 -818
  172. package/build/utils/api-status-feed.js +0 -84
  173. package/build/utils/cli-ui.js +0 -47
  174. package/build/utils/order-management/dispute.js +0 -369
  175. package/build/utils/order-management/fulfillment.js +0 -205
  176. package/build/utils/other/edelivery.js +0 -235
  177. package/build/utils/schema-helpers.js +0 -13
  178. package/build/utils/scope-helper.js +0 -207
  179. package/build/utils/security-checker.js +0 -248
  180. package/build/utils/type-guards.js +0 -6
  181. /package/build/auth/{oauth-types.js → oauthTypes.js} +0 -0
  182. /package/build/{server-http.d.ts → serverHttp.d.ts} +0 -0
  183. /package/build/tools/{definitions/types.js → types.js} +0 -0
  184. /package/build/tools/ui/{view-models.js → viewModels.js} +0 -0
  185. /package/build/types/{ebay-enums.js → ebayEnums.js} +0 -0
package/README.zh-CN.md CHANGED
@@ -45,6 +45,8 @@
45
45
 
46
46
  ---
47
47
 
48
+ > **说明：** 英文 [README.md](README.md) 是最新产品说明（工具族、API 下线、版本说明）的权威来源。本翻译可能滞后。
49
+
48
50
  **eBay MCP** 是一个本地的 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，可将 AI 助手 —Claude Desktop、Claude Code、Cursor、Cline、Windsurf、Zed、Continue.dev、Roo Code 和 Amazon Q— 直接连接到 **eBay 的 Sell API**。它提供 **322 个工具**，覆盖 **eBay Sell API 的 100% 范围**（270 个唯一端点），涵盖库存管理、订单履行、推广刊登营销、分析和开发者工具。一切都在你的机器上通过 STDIO 或本地 HTTP 运行 — **没有云端中继**，你的 eBay 凭据永远不会离开你的电脑。
49
51
 
50
52
  > **免责声明：** 非官方第三方项目 — **与 eBay Inc. 无关联，也未获其认可。** 按"原样"提供，不附带任何担保。你需自行负责遵守 [eBay API 许可协议](https://developer.ebay.com/join/api-license-agreement) 和 [数据处理要求](https://developer.ebay.com/api-docs/static/data-handling-update.html)、妥善保管你的凭据并遵守速率限制。在投入生产前请先在沙盒中测试。参见 [LICENSE](LICENSE)、[SECURITY.md](SECURITY.md) 和 [EBAY_COMPLIANCE.md](EBAY_COMPLIANCE.md)。
@@ -218,7 +220,7 @@ EBAY_MCP_UI=on # 交互式 MCP Apps 视图（测试版）
218
220
 
219
221
  ### MCP 客户端兼容性
220
222
 
221
- 由 `npm run setup` 自动配置。需要 Node.js ≥ 18 以及通过 STDIO（默认）或 HTTP 的 MCP 协议 1.0+。
223
+ 由 `npm run setup` 自动配置。需要 Node.js ≥ 20 以及通过 STDIO（默认）或 HTTP 的 MCP 协议 1.0+。
222
224
 
223
225
  | 客户端 | 平台 | 配置路径 |
224
226
  | ---------------------- | --------------------- | --------------------------------------------------------------------------- |
@@ -238,6 +240,7 @@ EBAY_MCP_UI=on # 交互式 MCP Apps 视图（测试版）
238
240
 
239
241
  | 类别 | 你可以做什么 |
240
242
  | --- | --- |
243
+ | [Connector](src/tools/categories/connector.ts) | 面向 eBay MCP 目录的 ChatGPT 连接器 search/fetch 工具 |
241
244
  | [Account](src/tools/categories/account.ts) | 业务、履行、付款和退货政策；计划；订阅；销售税 |
242
245
  | [Inventory](src/tools/categories/inventory.ts) | 库存商品、报价、地点、商品分组、批量操作、SKU/地点映射 |
243
246
  | [Fulfillment](src/tools/categories/fulfillment.ts) | 订单、配送、退款、纠纷、付款纠纷证据 |
@@ -246,9 +249,11 @@ EBAY_MCP_UI=on # 交互式 MCP Apps 视图（测试版）
246
249
  | [Communication](src/tools/categories/communication.ts) | 买卖双方消息、议价、通知、评价 |
247
250
  | [Metadata](src/tools/categories/metadata.ts) | 退货政策、销售税辖区、汽车兼容性 |
248
251
  | [Taxonomy](src/tools/categories/taxonomy.ts) | 类目树、商品属性、商品成色 |
252
+ | [Browse](src/tools/categories/browse.ts) | 已售/已完成 listing 搜索（Finding API）用于比价 |
253
+ | [Other](src/tools/categories/other.ts) | Identity、VeRO、翻译与国际物流支持 API（Compliance 工具会报告 eBay 于 2026-03-30 的下线） |
249
254
  | [Trading（旧版 XML）](src/tools/categories/trading.ts) | 固定价格刊登的创建、修改、重新刊登和结束 |
250
255
  | [Developer](src/tools/categories/developer.ts) | 速率限制、签名密钥、客户端注册 |
251
- | [Token Management](src/tools/categories/token-management.ts) | OAuth URL 生成与令牌管理 |
256
+ | [Token Management](src/tools/categories/tokenManagement.ts) | OAuth URL 生成与令牌管理 |
252
257
 
253
258
  **示例工具：** `ebay_get_inventory_items`、`ebay_get_orders`、`ebay_create_offer`、`ebay_get_campaigns`、`ebay_get_oauth_url`。
254
259
 
@@ -326,7 +331,7 @@ EBAY_MCP_UI=on # 交互式 MCP Apps 视图（测试版）
326
331
 
327
332
  ### 我需要什么才能开始？
328
333
 
329
- Node.js ≥ 18、一个免费的 [eBay 开发者账号](https://developer.ebay.com/)（Client ID + Client Secret），然后运行 `npm run setup`。
334
+ Node.js ≥ 20、一个免费的 [eBay 开发者账号](https://developer.ebay.com/)（Client ID + Client Secret），然后运行 `npm run setup`。
330
335
 
331
336
  ### eBay API 的速率限制是多少？
332
337