ebay-mcp 1.14.3 → 1.16.0

package/README.ru.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <strong>MCP-сервер eBay — дайте Claude, Cursor и любому ИИ-ассистенту полный доступ к Sell API eBay. 298 инструмента для инвентаря, заказов, маркетинга и аналитики, работающих локально с вашими собственными ключами.</strong>
+  <strong>MCP-сервер eBay — дайте Claude, Cursor и любому ИИ-ассистенту полный доступ к Sell API eBay. 305 инструмента для инвентаря, заказов, маркетинга и аналитики, работающих локально с вашими собственными ключами.</strong>
 </p>
 
 <p align="center"><sub>Неофициальный проект с открытым исходным кодом — не связан с eBay Inc., не авторизован и не одобрен ею.</sub></p>
@@ -20,7 +20,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 инструмента API eBay" />
+  <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 инструмента API eBay" />
   <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% покрытие Sell API eBay" />
   <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="совместим с Model Context Protocol" />
   <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="более 1000 пройденных тестов" />
@@ -47,7 +47,7 @@
 
 > **Примечание:** английский [README.md](README.md) — источник истины для актуальных продуктовых формулировок (семейства инструментов, вывод API из эксплуатации, заметки о версиях). Этот перевод может отставать.
 
-**eBay MCP** — это локальный сервер [Model Context Protocol](https://modelcontextprotocol.io), который подключает ИИ-ассистентов —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code и Amazon Q— напрямую к **Sell API eBay**. Он предоставляет **298 инструмента**, охватывающих **100% поверхности Sell API eBay** (270 уникальных эндпоинтов): управление инвентарём, обработка заказов, маркетинг продвигаемых объявлений, аналитика и инструменты разработчика. Всё работает на вашей машине через STDIO или локальный HTTP — **без облачного ретранслятора**, и ваши учётные данные eBay никогда не покидают компьютер.
+**eBay MCP** — это локальный сервер [Model Context Protocol](https://modelcontextprotocol.io), который подключает ИИ-ассистентов —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code и Amazon Q— напрямую к **Sell API eBay**. Он предоставляет **305 инструмента**, охватывающих **100% поверхности Sell API eBay** (274 уникальных эндпоинта): управление инвентарём, обработка заказов, маркетинг продвигаемых объявлений, аналитика и инструменты разработчика. Всё работает на вашей машине через STDIO или локальный HTTP — **без облачного ретранслятора**, и ваши учётные данные eBay никогда не покидают компьютер.
 
 > **Отказ от ответственности:** Неофициальный сторонний проект — **не связан с eBay Inc. и не одобрен ею.** Предоставляется «как есть», без гарантий. Вы сами отвечаете за соблюдение [Лицензионного соглашения API eBay](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).
 
@@ -71,11 +71,11 @@
 
 ## Возможности
 
-- **298 инструмента API eBay** — 100% покрытие Sell API eBay: инвентарь, заказы, маркетинг, аналитика, метаданные, таксономия и инструменты разработчика.
+- **305 инструмента API eBay** — 100% покрытие Sell API eBay: инвентарь, заказы, маркетинг, аналитика, метаданные, таксономия и инструменты разработчика.
 - **9 ИИ-клиентов с автонастройкой** — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI и Amazon Q Developer.
 - **Встроенный OAuth 2.0** — полное управление пользовательскими токенами с автоматическим обновлением и умным переходом от пользовательских токенов (10–50 тыс. запросов/день) к клиентским учётным данным (1 тыс. запросов/день).
 - **Надёжность по умолчанию** — автоматический повтор с экспоненциальной задержкой при лимитах `429` и понятный, последовательный вывод ошибок.
-- **Типобезопасность** — TypeScript от начала до конца, входные данные инструментов проверяются Zod, типы генерируются из OpenAPI.
+- **Типобезопасность** — TypeScript от начала до конца, входные данные инструментов проверяются Effect, типы генерируются из OpenAPI.
 - **Локально и приватно** — работает через STDIO или локальный HTTP; ваши учётные данные и данные никогда не покидают машину.
 - **Песочница и продакшен** — переключайте окружение одной переменной.
 - **Настройка одной командой** — `npm run setup` настраивает учётные данные, OAuth и ваш MCP-клиент, автоматически открывая браузер для потока OAuth.
@@ -90,10 +90,10 @@
 | Интерфейс | Естественный язык через ИИ-ассистента | HTTP-запросы вручную и разбор JSON |
 | OAuth и обновление токенов | Встроены, с автоматическим обновлением | Вы реализуете и поддерживаете сами |
 | Обработка лимитов | Автоматический повтор с экспоненциальной задержкой | Ручная обработка `429` и задержки |
-| Валидация входных данных | Схемы Zod + типы TypeScript на каждом инструменте | Нет — вы проверяете свои полезные данные сами |
+| Валидация входных данных | Схемы на основе Effect + типы TypeScript на каждом инструменте | Нет — вы проверяете свои полезные данные сами |
 | Настройка | Один мастер (`npm run setup`) | Авторизация, заголовки и маркетплейс на каждый вызов |
 | Поддержка ИИ-клиентов | 9 клиентов с автонастройкой | Неприменимо |
-| Покрытие API | 298 инструмента на 100% Sell API, готовы к вызову | Вы строите каждый запрос по документации |
+| Покрытие API | 305 инструмента на 100% Sell API, готовы к вызову | Вы строите каждый запрос по документации |
 | Размещение | Работает локально, без облачного ретранслятора | Ваша собственная инфраструктура |
 
 ## Настройка с помощью ИИ в один клик
@@ -236,13 +236,13 @@ EBAY_MCP_UI=on                      # интерактивные предста
 
 ## Доступные инструменты
 
-**298 инструмента**, 100% покрытие Sell API, сгруппированы по категориям. Каждая ссылка ведёт к определениям инструментов и их обработчикам в [`src/tools/categories/`](src/tools/categories/):
+**305 инструмента**, 100% покрытие Sell API, сгруппированы по категориям. Каждая ссылка ведёт к определениям инструментов и их обработчикам в [`src/tools/categories/`](src/tools/categories/):
 
 | Категория | Что вы можете делать |
 | --- | --- |
 | [Connector](src/tools/categories/connector.ts) | Инструменты search/fetch коннектора ChatGPT по каталогу eBay MCP |
 | [Account](src/tools/categories/account.ts) | Бизнес-, отгрузочные, платёжные и возвратные политики; программы; подписки; налог с продаж |
-| [Inventory](src/tools/categories/inventory.ts) | Товары инвентаря, предложения, локации, группы товаров, массовые операции, сопоставление SKU/локации |
+| [Inventory](src/tools/categories/inventory.ts) | Товары инвентаря, предложения, локации, группы товаров, массовые операции, сопоставление SKU/локации, загрузка локальных фото и видео ([`media.ts`](src/tools/categories/media.ts), Media API) |
 | [Fulfillment](src/tools/categories/fulfillment.ts) | Заказы, доставка, возвраты средств, споры, доказательства по платёжным спорам |
 | [Marketing](src/tools/categories/marketing.ts) | Кампании продвигаемых объявлений, реклама, акции, ставки, массовые операции |
 | [Analytics](src/tools/categories/analytics.ts) | Отчёты о трафике, стандарты продавца, метрики поддержки клиентов |
@@ -251,7 +251,7 @@ EBAY_MCP_UI=on                      # интерактивные предста
 | [Taxonomy](src/tools/categories/taxonomy.ts) | Деревья категорий, характеристики товаров, состояния товаров |
 | [Browse](src/tools/categories/browse.ts) | Поиск проданных/завершённых лотов (Finding API) для сравнения цен |
 | [Other](src/tools/categories/other.ts) | Identity, VeRO, перевод и API международной доставки (инструменты Compliance сообщают о выводе eBay из эксплуатации 2026-03-30) |
-| [Trading (устаревший XML)](src/tools/categories/trading.ts) | Создание, изменение, повторное размещение и завершение объявлений с фиксированной ценой |
+| [Trading (устаревший XML)](src/tools/categories/trading.ts) | Создание, изменение, повторное размещение и завершение объявлений с фиксированной ценой и аукционов |
 | [Developer](src/tools/categories/developer.ts) | Лимиты запросов, ключи подписи, регистрация клиентов |
 | [Token Management](src/tools/categories/tokenManagement.ts) | Генерация URL OAuth и управление токенами |
 
@@ -299,7 +299,7 @@ EBAY_MCP_UI=on                      # интерактивные предста
 
 ### Что такое MCP-сервер eBay?
 
-Локальный сервер [Model Context Protocol](https://modelcontextprotocol.io), предоставляющий **298 инструмента**, охватывающих **100% Sell API eBay** (270 эндпоинтов), ИИ-ассистентам — инвентарь, обработка заказов, маркетинг, аналитика и инструменты разработчика.
+Локальный сервер [Model Context Protocol](https://modelcontextprotocol.io), предоставляющий **305 инструмента**, охватывающих **100% Sell API eBay** (274 эндпоинта), ИИ-ассистентам — инвентарь, обработка заказов, маркетинг, аналитика и инструменты разработчика.
 
 ### Это официальный продукт eBay?
 
@@ -319,7 +319,7 @@ EBAY_MCP_UI=on                      # интерактивные предста
 
 ### Сколько API и инструментов eBay он охватывает?
 
-298 инструмента на 270 уникальных эндпоинтах — 100% Sell API eBay.
+305 инструмента на 274 уникальных эндпоинтах — 100% Sell API eBay.
 
 ### Это бесплатно и с открытым исходным кодом?
 
@@ -347,11 +347,19 @@ Node.js ≥ 20, бесплатный [аккаунт разработчика eB
 
 ### Чем это отличается от прямого вызова API eBay?
 
-Вы взаимодействуете на естественном языке через ИИ-ассистента. Управление токенами OAuth, автоматические повторы с задержкой и типобезопасная валидация через Zod встроены. См. [таблицу сравнения](#ebay-mcp-против-обычного-api-ebay) выше.
+Вы взаимодействуете на естественном языке через ИИ-ассистента. Управление токенами OAuth, автоматические повторы с задержкой и типобезопасная валидация на основе Effect встроены. См. [таблицу сравнения](#ebay-mcp-против-обычного-api-ebay) выше.
+
+### Может ли он загружать мои фото и видео?
+
+Да. `ebay_upload_images`, `ebay_upload_video` и `ebay_attach_media_to_inventory_item` читают локальные файлы (абсолютные пути или ссылки `media://`) и загружают их через Media API eBay, возвращая URL изображений EPS и идентификаторы видео для `product.imageUrls` / `product.videoIds`. Доступ к файловой системе включается явно: пока `EBAY_MCP_MEDIA_DIRS` или `EBAY_MCP_MEDIA_ROOT` не укажут каталоги, прочитать ничего нельзя. См. [Photos and videos from local files](README.md#photos-and-videos-from-local-files) (на английском).
+
+### Поддерживает ли он аукционы?
+
+Да, через инструменты предложений Inventory API (REST): создайте предложение с `format: "AUCTION"`, `auctionStartPrice`, необязательным `auctionReservePrice` и `listingDuration` в днях, затем опубликуйте его. См. [Auction offers](README.md#auction-offers) (на английском). Инструменты Trading API используют тот же переключатель: `ebay_create_listing` с `format: "AUCTION"` отправляет `AddItem` с `ListingType` Chinese, стартовой ставкой `StartPrice` и `ListingDuration` в днях.
 
 ### Поддерживает ли он устаревший Trading API eBay (XML)?
 
-Да. Операции создания, изменения, повторного размещения и завершения объявлений с фиксированной ценой поддерживаются через инструменты Trading API.
+Да. Операции создания, изменения, повторного размещения и завершения объявлений поддерживаются через инструменты Trading API — как для объявлений с фиксированной ценой (семейство `AddFixedPriceItem`, по умолчанию), так и для аукционов (`format: "AUCTION"` → `AddItem`, `ReviseItem`, `EndItem`, `RelistItem`).
 
 ### Как получить более высокие лимиты запросов?
 
@@ -359,7 +367,7 @@ Node.js ≥ 20, бесплатный [аккаунт разработчика eB
 
 ### На чём он построен?
 
-TypeScript и Node.js (ESM), с официальным MCP SDK, Zod для валидации и типами, сгенерированными из OpenAPI.
+TypeScript и Node.js (ESM), с официальным MCP SDK, валидацией на основе Effect с Zod-совместимым MCP-адаптером и типами, сгенерированными из OpenAPI.
 
 ### Как обновиться до последней версии?
 

package/README.zh-CN.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <strong>eBay MCP 服务器 — 让 Claude、Cursor 以及任意 AI 助手完全访问 eBay 的 Sell API。298 个工具覆盖库存、订单、营销与分析，使用你自己的密钥在本地运行。</strong>
+  <strong>eBay MCP 服务器 — 让 Claude、Cursor 以及任意 AI 助手完全访问 eBay 的 Sell API。305 个工具覆盖库存、订单、营销与分析，使用你自己的密钥在本地运行。</strong>
 </p>
 
 <p align="center"><sub>非官方开源项目 — 与 eBay Inc. 无任何关联，未获其授权或认可。</sub></p>
@@ -20,7 +20,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 个 eBay API 工具" />
+  <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 个 eBay API 工具" />
   <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% 覆盖 eBay Sell API" />
   <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="兼容 Model Context Protocol" />
   <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="超过 1000 个通过的测试" />
@@ -47,7 +47,7 @@
 
 > **说明：** 英文 [README.md](README.md) 是最新产品说明（工具族、API 下线、版本说明）的权威来源。本翻译可能滞后。
 
-**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**。它提供 **298 个工具**，覆盖 **eBay Sell API 的 100% 范围**（270 个唯一端点），涵盖库存管理、订单履行、推广刊登营销、分析和开发者工具。一切都在你的机器上通过 STDIO 或本地 HTTP 运行 — **没有云端中继**，你的 eBay 凭据永远不会离开你的电脑。
+**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**。它提供 **305 个工具**，覆盖 **eBay Sell API 的 100% 范围**（274 个唯一端点），涵盖库存管理、订单履行、推广刊登营销、分析和开发者工具。一切都在你的机器上通过 STDIO 或本地 HTTP 运行 — **没有云端中继**，你的 eBay 凭据永远不会离开你的电脑。
 
 > **免责声明：** 非官方第三方项目 — **与 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)。
 
@@ -71,11 +71,11 @@
 
 ## 功能特性
 
-- **298 个 eBay API 工具** — 100% 覆盖 eBay Sell API，涵盖库存、订单、营销、分析、元数据、分类法和开发者工具。
+- **305 个 eBay API 工具** — 100% 覆盖 eBay Sell API，涵盖库存、订单、营销、分析、元数据、分类法和开发者工具。
 - **自动配置 9 个 AI 客户端** — Claude Desktop、Cursor、Zed、Cline、Continue.dev、Windsurf、Roo Code、Claude Code CLI 和 Amazon Q Developer。
 - **内置 OAuth 2.0** — 完整的用户令牌管理与自动刷新，并能从用户令牌（每天 1 万–5 万次请求）智能回退到客户端凭据（每天 1 千次请求）。
 - **默认具备韧性** — 遇到 `429` 速率限制时自动重试并采用指数退避，错误提示清晰一致。
-- **类型安全** — 端到端 TypeScript，使用 Zod 校验工具输入，类型由 OpenAPI 生成。
+- **类型安全** — 端到端 TypeScript，使用 Effect 校验工具输入，类型由 OpenAPI 生成。
 - **本地且私密** — 通过 STDIO 或本地 HTTP 运行；你的凭据和数据永远不会离开你的机器。
 - **沙盒与生产** — 用一个变量即可切换环境。
 - **一条命令完成配置** — `npm run setup` 会配置凭据、OAuth 和你的 MCP 客户端，并自动打开浏览器完成 OAuth 流程。
@@ -90,10 +90,10 @@
 | 接口 | 通过 AI 助手使用自然语言 | 手写 HTTP 请求并解析 JSON |
 | OAuth 与令牌刷新 | 内置，并自动刷新 | 由你自行实现和维护 |
 | 速率限制处理 | 自动重试并指数退避 | 手动处理 `429` 与退避 |
-| 输入校验 | 每个工具都有 Zod 模式 + TypeScript 类型 | 无 — 由你校验自己的载荷 |
+| 输入校验 | 每个工具都有基于 Effect 的模式 + TypeScript 类型 | 无 — 由你校验自己的载荷 |
 | 配置 | 一个向导（`npm run setup`） | 每次调用都要处理认证、请求头和站点 |
 | AI 客户端支持 | 自动配置 9 个客户端 | 不适用 |
-| API 覆盖 | 298 个工具覆盖 100% Sell API，开箱即用 | 你需根据文档构建每个请求 |
+| API 覆盖 | 305 个工具覆盖 100% Sell API，开箱即用 | 你需根据文档构建每个请求 |
 | 托管 | 本地运行，无云端中继 | 你自己的基础设施 |
 
 ## AI 一键配置
@@ -236,13 +236,13 @@ EBAY_MCP_UI=on                      # 交互式 MCP Apps 视图（测试版）
 
 ## 可用工具
 
-**298 个工具**，100% Sell API 覆盖，按类别组织。每个链接都指向 [`src/tools/categories/`](src/tools/categories/) 中的工具定义及其处理程序：
+**305 个工具**，100% Sell API 覆盖，按类别组织。每个链接都指向 [`src/tools/categories/`](src/tools/categories/) 中的工具定义及其处理程序：
 
 | 类别 | 你可以做什么 |
 | --- | --- |
 | [Connector](src/tools/categories/connector.ts) | 面向 eBay MCP 目录的 ChatGPT 连接器 search/fetch 工具 |
 | [Account](src/tools/categories/account.ts) | 业务、履行、付款和退货政策；计划；订阅；销售税 |
-| [Inventory](src/tools/categories/inventory.ts) | 库存商品、报价、地点、商品分组、批量操作、SKU/地点映射 |
+| [Inventory](src/tools/categories/inventory.ts) | 库存商品、报价、地点、商品分组、批量操作、SKU/地点映射，以及本地照片/视频上传（[`media.ts`](src/tools/categories/media.ts)，Media API） |
 | [Fulfillment](src/tools/categories/fulfillment.ts) | 订单、配送、退款、纠纷、付款纠纷证据 |
 | [Marketing](src/tools/categories/marketing.ts) | 推广刊登广告活动、广告、促销、出价、批量操作 |
 | [Analytics](src/tools/categories/analytics.ts) | 流量报告、卖家标准、客户服务指标 |
@@ -251,7 +251,7 @@ EBAY_MCP_UI=on                      # 交互式 MCP Apps 视图（测试版）
 | [Taxonomy](src/tools/categories/taxonomy.ts) | 类目树、商品属性、商品成色 |
 | [Browse](src/tools/categories/browse.ts) | 已售/已完成 listing 搜索（Finding API）用于比价 |
 | [Other](src/tools/categories/other.ts) | Identity、VeRO、翻译与国际物流支持 API（Compliance 工具会报告 eBay 于 2026-03-30 的下线） |
-| [Trading（旧版 XML）](src/tools/categories/trading.ts) | 固定价格刊登的创建、修改、重新刊登和结束 |
+| [Trading（旧版 XML）](src/tools/categories/trading.ts) | 固定价格刊登和拍卖的创建、修改、重新刊登和结束 |
 | [Developer](src/tools/categories/developer.ts) | 速率限制、签名密钥、客户端注册 |
 | [Token Management](src/tools/categories/tokenManagement.ts) | OAuth URL 生成与令牌管理 |
 
@@ -299,7 +299,7 @@ EBAY_MCP_UI=on                      # 交互式 MCP Apps 视图（测试版）
 
 ### 什么是 eBay MCP 服务器？
 
-一个本地的 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，向 AI 助手提供 **298 个工具**，覆盖 **eBay Sell API 的 100%**（270 个端点）—— 库存、订单履行、营销、分析和开发者工具。
+一个本地的 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，向 AI 助手提供 **305 个工具**，覆盖 **eBay Sell API 的 100%**（274 个端点）—— 库存、订单履行、营销、分析和开发者工具。
 
 ### 这是 eBay 的官方产品吗？
 
@@ -319,7 +319,7 @@ EBAY_MCP_UI=on                      # 交互式 MCP Apps 视图（测试版）
 
 ### 它覆盖多少 eBay API 和工具？
 
-298 个工具，覆盖 270 个唯一端点 —— eBay Sell API 的 100%。
+305 个工具，覆盖 274 个唯一端点 —— eBay Sell API 的 100%。
 
 ### 它是免费且开源的吗？
 
@@ -347,11 +347,19 @@ Node.js ≥ 20、一个免费的 [eBay 开发者账号](https://developer.ebay.c
 
 ### 这与直接调用 eBay API 有何不同？
 
-你通过 AI 助手以自然语言交互。OAuth 令牌管理、带退避的自动重试以及基于 Zod 的类型安全校验都是内置的。参见上面的 [对比表](#ebay-mcp-对比原生-ebay-api)。
+你通过 AI 助手以自然语言交互。OAuth 令牌管理、带退避的自动重试以及基于 Effect 的类型安全校验都是内置的。参见上面的 [对比表](#ebay-mcp-对比原生-ebay-api)。
+
+### 它能上传我的照片和视频吗？
+
+可以。`ebay_upload_images`、`ebay_upload_video` 和 `ebay_attach_media_to_inventory_item` 会读取本地文件（绝对路径或 `media://` 引用），通过 eBay 的 Media API 上传，并返回用于 `product.imageUrls` / `product.videoIds` 的 EPS 图片 URL 和视频 ID。文件系统访问需要显式开启：在 `EBAY_MCP_MEDIA_DIRS` 或 `EBAY_MCP_MEDIA_ROOT` 指定目录之前，什么都无法读取。详见 [Photos and videos from local files](README.md#photos-and-videos-from-local-files)（英文）。
+
+### 它支持拍卖刊登吗？
+
+支持。通过 REST Inventory 报价工具：使用 `format: "AUCTION"`、`auctionStartPrice`、可选的 `auctionReservePrice` 和按天计的 `listingDuration` 创建报价，然后发布。详见 [Auction offers](README.md#auction-offers)（英文）。旧版 Trading API 工具使用同样的开关：带 `format: "AUCTION"` 的 `ebay_create_listing` 会发送包含 `ListingType` Chinese、起拍价 `StartPrice` 和按天计的 `ListingDuration` 的 `AddItem`。
 
 ### 它是否支持 eBay 的旧版 Trading API（XML）？
 
-支持。固定价格刊登的创建、修改、重新刊登和结束操作通过 Trading API 工具提供。
+支持。刊登的创建、修改、重新刊登和结束操作通过 Trading API 工具提供，既支持固定价格刊登（`AddFixedPriceItem` 系列，默认），也支持拍卖（`format: "AUCTION"` → `AddItem`、`ReviseItem`、`EndItem`、`RelistItem`）。
 
 ### 如何获得更高的速率限制？
 
@@ -359,7 +367,7 @@ Node.js ≥ 20、一个免费的 [eBay 开发者账号](https://developer.ebay.c
 
 ### 它用什么构建？
 
-TypeScript 和 Node.js（ESM），使用官方 MCP SDK、用于校验的 Zod 以及由 OpenAPI 生成的类型。
+TypeScript 和 Node.js（ESM），使用官方 MCP SDK、基于 Effect 的校验（带 Zod 兼容的 MCP 适配器）以及由 OpenAPI 生成的类型。
 
 ### 如何更新到最新版本？
 

package/build/api/client.js

@@ -3,10 +3,34 @@ import { clientRequestError } from '../api/clientRequestError.js';
 import { RateLimitTracker } from '../api/rateLimitTracker.js';
 import { getBaseUrl } from '../config/environment.js';
 import { getErrorMessage } from '../utils/errors.js';
-import { httpRequestEffect, isHttpError } from '../utils/http.js';
+import { httpRequestEffect, isHttpError, } from '../utils/http.js';
 import { isRecord } from '../utils/typeGuards.js';
 import { apiLogger, logRequest, logResponse, logErrorResponse } from '../utils/logger.js';
-import { Effect } from 'effect';
+import { Cause, Effect, Exit } from 'effect';
+/** Bodies that must never be echoed into debug logs. */
+const isBinaryBody = (data) => data instanceof FormData ||
+    data instanceof Blob ||
+    data instanceof Uint8Array ||
+    data instanceof ArrayBuffer;
+const CONTENT_TYPE_HEADER = 'content-type';
+const hasHeader = (headers, name) => headers !== undefined && Object.keys(headers).some((key) => key.toLowerCase() === name);
+/** Removes every spelling of a header so fetch can derive it from the body. */
+const deleteHeader = (headers, name) => {
+    for (const key of Object.keys(headers)) {
+        if (key.toLowerCase() === name) {
+            delete headers[key];
+        }
+    }
+};
+/**
+ * Remediation hint for a token failure, matched to the token the request needs.
+ *
+ * Setting user tokens cannot repair rejected client credentials, so an
+ * application request has to point at the credentials instead.
+ */
+const tokenFailureRemediation = (tokenType) => tokenType === 'application'
+    ? 'This endpoint requires an application access token minted from client credentials, which a user token cannot supply. Check EBAY_CLIENT_ID and EBAY_CLIENT_SECRET.'
+    : 'Please use the ebay_set_user_tokens_with_expiry tool to provide valid tokens.';
 /** Sleep for a retry backoff delay without exposing timers to callers. */
 const sleep = (delayMs) => Effect.promise(() => new Promise((resolve) => {
     setTimeout(resolve, delayMs);
@@ -50,6 +74,18 @@ export class EbayApiClient {
         this.baseUrl = getBaseUrl(config.environment, config.apiBaseUrl);
         this.rateLimitTracker = new RateLimitTracker();
     }
+    /**
+     * Acquire the access token a request should authenticate with.
+     *
+     * Both token-acquisition sites (the initial attempt and the 401 retry) route
+     * through here, so an `'application'` request cannot silently downgrade to
+     * the user token on a retry.
+     */
+    acquireAccessToken(tokenType) {
+        return tokenType === 'application'
+            ? this.authClient.getOrRefreshAppAccessToken()
+            : this.authClient.getAccessToken();
+    }
     /**
      * Return the credential validation error that would block an authenticated request.
      */
@@ -96,7 +132,20 @@ export class EbayApiClient {
      * Core request boundary shared by every verb.
      */
     async request(method, endpoint, options) {
-        return await Effect.runPromise(this.requestEffect(method, endpoint, options));
+        return (await this.requestResponse(method, endpoint, options)).data;
+    }
+    /**
+     * Core request boundary that also returns status and headers.
+     */
+    async requestResponse(method, endpoint, options) {
+        // Preserve the typed request error for endpoint adapters. Plain runPromise
+        // rejects with a FiberFailure whose generic message hides eBay response data.
+        const exit = await Effect.runPromiseExit(this.requestEffect(method, endpoint, options));
+        if (Exit.isSuccess(exit)) {
+            const { data, status, headers } = exit.value;
+            return { data, status, headers };
+        }
+        throw Cause.squash(exit.cause);
     }
     /**
      * Build the request Effect that owns auth, logging, retry, and transport errors.
@@ -134,10 +183,18 @@ export class EbayApiClient {
                 ...this.getDefaultHeaders(),
                 ...options.headers,
             };
+            if (options.data instanceof FormData) {
+                // fetch must set the multipart content-type itself so the boundary matches.
+                deleteHeader(headers, CONTENT_TYPE_HEADER);
+            }
+            else if (options.data instanceof Blob && !hasHeader(options.headers, CONTENT_TYPE_HEADER)) {
+                // A Blob carries its own MIME type; only an explicit caller header overrides it.
+                deleteHeader(headers, CONTENT_TYPE_HEADER);
+            }
             // Proxy auth mode: attach no Authorization header and acquire no token —
             // the upstream proxy injects whatever credentials eBay requires.
             if (!this.config.disableAuthHeader) {
-                const token = yield* this.authClient.getAccessToken().pipe(Effect.mapError((cause) => clientRequestError({
+                const token = yield* this.acquireAccessToken(options.tokenType).pipe(Effect.mapError((cause) => clientRequestError({
                     kind: 'tokenAcquisition',
                     method,
                     url,
@@ -155,18 +212,18 @@ export class EbayApiClient {
                 headers.Authorization = `Bearer ${token}`;
             }
             this.rateLimitTracker.recordRequest();
-            logRequest(method, url, options.params, options.data);
+            logRequest(method, url, options.params, isBinaryBody(options.data) ? '[binary body]' : options.data);
             return yield* httpRequestEffect({
                 method,
                 url,
                 params: options.params,
                 headers,
                 body: options.data,
-                timeoutMs: this.timeoutMs,
+                timeoutMs: options.timeoutMs ?? this.timeoutMs,
                 responseType: options.responseType,
             }).pipe(Effect.map((response) => {
                 logResponse(response.status, response.statusText, response.data, response.headers['x-ebay-c-ratelimit-remaining'], response.headers['x-ebay-c-ratelimit-limit']);
-                return response.data;
+                return response;
             }), Effect.catchAll((error) => this.handleRequestFailure(error, { method, url, options, state })));
         });
     }
@@ -195,8 +252,8 @@ export class EbayApiClient {
         // own auth failing) is surfaced directly rather than retried.
         if (error.status === 401 && !this.config.disableAuthHeader) {
             if (!state.authRetried) {
-                apiLogger.warn('Authentication error (401). Attempting to refresh user token...');
-                return this.authClient.getAccessToken().pipe(Effect.catchAll((refreshError) => {
+                apiLogger.warn('Authentication error (401). Attempting to refresh the access token...');
+                return this.acquireAccessToken(options.tokenType).pipe(Effect.catchAll((refreshError) => {
                     const reason = getErrorMessage(refreshError);
                     apiLogger.error('Failed to refresh token', { error: reason });
                     const detail = this.ebayErrorDetail(error.data) ?? 'Invalid access token';
@@ -206,7 +263,7 @@ export class EbayApiClient {
                         url,
                         status: error.status,
                         message: `${detail}. Token refresh failed: ${reason}. ` +
-                            'Please use the ebay_set_user_tokens_with_expiry tool to provide valid tokens.',
+                            tokenFailureRemediation(options.tokenType),
                         cause: refreshError,
                     }));
                 }), Effect.flatMap(() => {
@@ -224,7 +281,7 @@ export class EbayApiClient {
                 url,
                 status: error.status,
                 message: `${detail}. Automatic token refresh failed. ` +
-                    'Please use the ebay_set_user_tokens_with_expiry tool to provide valid tokens.',
+                    tokenFailureRemediation(options.tokenType),
                 cause: error,
             }));
         }
@@ -282,17 +339,30 @@ export class EbayApiClient {
             params: { ...params, ...config?.params },
             headers: config?.headers,
             responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            tokenType: config?.tokenType,
         });
     }
     /**
      * Make a POST request to eBay API
      */
     async post(endpoint, data, config) {
-        return await this.request('POST', endpoint, {
+        return (await this.postForResponse(endpoint, data, config)).data;
+    }
+    /**
+     * Make a POST request and keep the status and headers of the successful
+     * response — for endpoints that return their result in a `Location` header.
+     */
+    async postForResponse(endpoint, data, config) {
+        return await this.requestResponse('POST', endpoint, {
             data,
             params: config?.params,
             headers: config?.headers,
             responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            tokenType: config?.tokenType,
         });
     }
     /**
@@ -304,6 +374,9 @@ export class EbayApiClient {
             params: config?.params,
             headers: config?.headers,
             responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            tokenType: config?.tokenType,
         });
     }
     /**
@@ -314,6 +387,9 @@ export class EbayApiClient {
             params: config?.params,
             headers: config?.headers,
             responseType: config?.responseType,
+            absolute: config?.absolute,
+            timeoutMs: config?.timeoutMs,
+            tokenType: config?.tokenType,
         });
     }
     /**

package/build/api/index.js

@@ -7,6 +7,7 @@ import { NegotiationApi } from '../api/communication/negotiation.js';
 import { NotificationApi } from '../api/communication/notification.js';
 import { DeveloperApi } from '../api/developer/developer.js';
 import { InventoryApi } from '../api/listing-management/inventory.js';
+import { MediaApi } from '../api/listing-management/media.js';
 import { MetadataApi } from '../api/listing-metadata/metadata.js';
 import { TaxonomyApi } from '../api/listing-metadata/taxonomy.js';
 import { MarketingApi } from '../api/marketing-and-promotions/marketing.js';
@@ -15,6 +16,7 @@ import { DisputeApi } from '../api/order-management/dispute.js';
 import { FulfillmentApi } from '../api/order-management/fulfillment.js';
 import { ComplianceApi } from '../api/other/compliance.js';
 import { EDeliveryApi } from '../api/other/edelivery.js';
+import { BrowseApi } from '../api/other/browse.js';
 import { FindingApi } from '../api/other/finding.js';
 import { IdentityApi } from '../api/other/identity.js';
 import { TranslationApi } from '../api/other/translation.js';
@@ -30,6 +32,7 @@ export class EbaySellerApi {
     // API categories
     account;
     inventory;
+    media;
     fulfillment;
     dispute;
     marketing;
@@ -46,6 +49,7 @@ export class EbaySellerApi {
     vero;
     translation;
     edelivery;
+    browse;
     finding;
     developer;
     trading;
@@ -55,6 +59,7 @@ export class EbaySellerApi {
         // Initialize API category handlers
         this.account = new AccountApi(this.client);
         this.inventory = new InventoryApi(this.client);
+        this.media = new MediaApi(this.client, this.inventory);
         this.fulfillment = new FulfillmentApi(this.client);
         this.dispute = new DisputeApi(this.client);
         this.marketing = new MarketingApi(this.client);
@@ -71,6 +76,7 @@ export class EbaySellerApi {
         this.vero = new VeroApi(this.client);
         this.translation = new TranslationApi(this.client);
         this.edelivery = new EDeliveryApi(this.client);
+        this.browse = new BrowseApi(this.client);
         this.finding = new FindingApi(this.client);
         this.developer = new DeveloperApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
@@ -130,6 +136,8 @@ export * from '../api/communication/message.js';
 export * from '../api/communication/negotiation.js';
 export * from '../api/communication/notification.js';
 export * from '../api/listing-management/inventory.js';
+export * from '../api/listing-management/media.js';
+export * from '../api/listing-management/mediaAttach.js';
 export * from '../api/listing-metadata/metadata.js';
 export * from '../api/listing-metadata/taxonomy.js';
 export * from '../api/marketing-and-promotions/marketing.js';
@@ -138,6 +146,10 @@ export * from '../api/order-management/dispute.js';
 export * from '../api/order-management/fulfillment.js';
 export * from '../api/other/compliance.js';
 export * from '../api/other/edelivery.js';
+export { BrowseApi } from '../api/other/browse.js';
+export { buildBrowseFilter, requireNoPriceFilterConflict } from '../api/other/browseFilter.js';
+export { mapItemDetailsResponse, mapItemSummary, mapSearchActiveItemsResponse, } from '../api/other/browseMappers.js';
+export { BROWSE_SORT_VALUES, } from '../api/other/browseTypes.js';
 export * from '../api/other/finding.js';
 export * from '../api/other/identity.js';
 export * from '../api/other/translation.js';

package/build/api/listing-management/items.js

@@ -71,7 +71,10 @@ export const createInventoryItemsMethods = (client) => ({
             const validatedInput = yield* requireObjectEffect(input, 'input');
             const sku = yield* requireStringEffect(validatedInput.sku, 'sku');
             const body = yield* requireObjectEffect(validatedInput.body, 'body');
-            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}`, body);
+            const config = validatedInput.contentLanguage === undefined
+                ? undefined
+                : { headers: { 'Content-Language': validatedInput.contentLanguage } };
+            return yield* requestPutEffect(client, `${basePath}/inventory_item/${sku}`, body, config);
         });
     },
     /**