ebay-mcp 1.14.3 → 1.16.0

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 (52) hide show
  1. package/README.de.md +23 -15
  2. package/README.es.md +23 -15
  3. package/README.fr.md +23 -15
  4. package/README.ja.md +23 -15
  5. package/README.ko.md +23 -15
  6. package/README.md +108 -14
  7. package/README.pt-BR.md +23 -15
  8. package/README.ru.md +23 -15
  9. package/README.zh-CN.md +23 -15
  10. package/build/api/client.js +88 -12
  11. package/build/api/index.js +12 -0
  12. package/build/api/listing-management/items.js +4 -1
  13. package/build/api/listing-management/media.js +335 -0
  14. package/build/api/listing-management/mediaAttach.js +145 -0
  15. package/build/api/listing-management/offerFormat.js +111 -0
  16. package/build/api/listing-management/offers.js +82 -23
  17. package/build/api/other/browse.js +120 -0
  18. package/build/api/other/browseFilter.js +74 -0
  19. package/build/api/other/browseMappers.js +205 -0
  20. package/build/api/other/browseTypes.js +8 -0
  21. package/build/api/other/browseValidators.js +180 -0
  22. package/build/api/shared/auctionPricing.js +44 -0
  23. package/build/api/shared/request.js +2 -2
  24. package/build/api/trading/listingFormat.js +179 -0
  25. package/build/api/trading/trading.js +68 -18
  26. package/build/auth/credentialSession.js +2 -3
  27. package/build/auth/oauth.js +26 -8
  28. package/build/auth/scopeUtils.js +5 -0
  29. package/build/config/credentialFile.js +16 -0
  30. package/build/config/environment.js +72 -4
  31. package/build/config/mediaAccess.js +51 -0
  32. package/build/mcp/runtime.js +13 -5
  33. package/build/schemas/inventory-management/inventory.js +102 -26
  34. package/build/schemas/inventory-management/media.js +106 -0
  35. package/build/schemas/other/browse.js +65 -0
  36. package/build/skills/content.js +13 -6
  37. package/build/tools/categories/account.js +1 -1
  38. package/build/tools/categories/browse.js +15 -0
  39. package/build/tools/categories/index.js +2 -1
  40. package/build/tools/categories/inventory.js +31 -14
  41. package/build/tools/categories/media.js +76 -0
  42. package/build/tools/categories/taxonomy.js +2 -2
  43. package/build/tools/categories/trading.js +8 -7
  44. package/build/tools/schemas.js +5 -2
  45. package/build/tools/ui/maps.js +21 -2
  46. package/build/types/ebayEnums.js +29 -0
  47. package/build/utils/errors.js +84 -0
  48. package/build/utils/http.js +61 -46
  49. package/build/utils/localMedia.js +180 -0
  50. package/build/utils/objects.js +26 -0
  51. package/build/utils/trading/trading.js +14 -2
  52. package/package.json +2 -2
package/README.de.md CHANGED
@@ -5,7 +5,7 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <strong>Der eBay MCP-Server — gib Claude, Cursor und jedem KI-Assistenten vollen Zugriff auf die Sell-APIs von eBay. 298 Tools für Bestand, Bestellungen, Marketing und Analytik, lokal ausgeführt mit deinen eigenen Schlüsseln.</strong>
8
+ <strong>Der eBay MCP-Server — gib Claude, Cursor und jedem KI-Assistenten vollen Zugriff auf die Sell-APIs von eBay. 305 Tools für Bestand, Bestellungen, Marketing und Analytik, lokal ausgeführt mit deinen eigenen Schlüsseln.</strong>
9
9
  </p>
10
10
 
11
11
  <p align="center"><sub>Inoffizielles Open-Source-Projekt — ohne Zugehörigkeit, Genehmigung oder Billigung durch eBay Inc.</sub></p>
@@ -20,7 +20,7 @@
20
20
  </p>
21
21
 
22
22
  <p align="center">
23
- <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 eBay-API-Tools" />
23
+ <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 eBay-API-Tools" />
24
24
  <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% Abdeckung der eBay Sell API" />
25
25
  <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="Model Context Protocol kompatibel" />
26
26
  <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="über 1000 bestandene Tests" />
@@ -47,7 +47,7 @@
47
47
 
48
48
  > **Hinweis:** Die englische [README.md](README.md) ist die Quelle der Wahrheit für aktuelle Produktangaben (Tool-Familien, API-Stilllegungen, Versionshinweise). Diese Übersetzung kann hinterherhinken.
49
49
 
50
- **eBay MCP** ist ein lokaler [Model-Context-Protocol](https://modelcontextprotocol.io)-Server, der KI-Assistenten —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code und Amazon Q— direkt mit den **Sell-APIs von eBay** verbindet. Er stellt **298 Tools** bereit, die **100% der eBay-Sell-API-Oberfläche** (270 eindeutige Endpunkte) abdecken — für Bestandsverwaltung, Auftragsabwicklung, Marketing mit beworbenen Angeboten, Analytik und Entwicklerwerkzeuge. Alles läuft auf deinem Rechner über STDIO oder lokales HTTP — **kein Cloud-Relay**, und deine eBay-Zugangsdaten verlassen niemals deinen Computer.
50
+ **eBay MCP** ist ein lokaler [Model-Context-Protocol](https://modelcontextprotocol.io)-Server, der KI-Assistenten —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code und Amazon Q— direkt mit den **Sell-APIs von eBay** verbindet. Er stellt **305 Tools** bereit, die **100% der eBay-Sell-API-Oberfläche** (274 eindeutige Endpunkte) abdecken — für Bestandsverwaltung, Auftragsabwicklung, Marketing mit beworbenen Angeboten, Analytik und Entwicklerwerkzeuge. Alles läuft auf deinem Rechner über STDIO oder lokales HTTP — **kein Cloud-Relay**, und deine eBay-Zugangsdaten verlassen niemals deinen Computer.
51
51
 
52
52
  > **Haftungsausschluss:** Inoffizielles Drittanbieterprojekt — **ohne Zugehörigkeit zu oder Billigung durch eBay Inc.** Bereitgestellt „wie besehen“, ohne Gewährleistung. Du bist selbst dafür verantwortlich, die [eBay-API-Lizenzvereinbarung](https://developer.ebay.com/join/api-license-agreement) und die [Anforderungen an die Datenverarbeitung](https://developer.ebay.com/api-docs/static/data-handling-update.html) einzuhalten, deine Zugangsdaten zu schützen und die Ratenlimits einzuhalten. Teste im Sandbox-Modus vor dem Produktivbetrieb. Siehe [LICENSE](LICENSE), [SECURITY.md](SECURITY.md) und [EBAY_COMPLIANCE.md](EBAY_COMPLIANCE.md).
53
53
 
@@ -71,11 +71,11 @@
71
71
 
72
72
  ## Funktionen
73
73
 
74
- - **298 eBay-API-Tools** — 100% Abdeckung der eBay-Sell-APIs für Bestand, Bestellungen, Marketing, Analytik, Metadaten, Taxonomie und Entwicklerwerkzeuge.
74
+ - **305 eBay-API-Tools** — 100% Abdeckung der eBay-Sell-APIs für Bestand, Bestellungen, Marketing, Analytik, Metadaten, Taxonomie und Entwicklerwerkzeuge.
75
75
  - **9 KI-Clients, automatisch konfiguriert** — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI und Amazon Q Developer.
76
76
  - **OAuth 2.0 integriert** — vollständige Verwaltung von Benutzer-Tokens mit automatischer Erneuerung und intelligentem Rückfall von Benutzer-Tokens (10k–50k Anfragen/Tag) auf Client-Zugangsdaten (1k Anfragen/Tag).
77
77
  - **Standardmäßig robust** — automatischer Wiederholungsversuch mit exponentiellem Backoff bei `429`-Ratenlimits und konsistente, deutliche Fehlermeldungen.
78
- - **Typsicher** — durchgängig TypeScript, mit Zod validierte Tool-Eingaben und aus OpenAPI generierte Typen.
78
+ - **Typsicher** — durchgängig TypeScript, mit Effect validierte Tool-Eingaben und aus OpenAPI generierte Typen.
79
79
  - **Lokal und privat** — läuft über STDIO oder lokales HTTP; deine Zugangsdaten und Daten verlassen niemals deinen Rechner.
80
80
  - **Sandbox und Produktion** — wechsle die Umgebung mit einer einzigen Variablen.
81
81
  - **Einrichtung mit einem Befehl** — `npm run setup` konfiguriert Zugangsdaten, OAuth und deinen MCP-Client und öffnet automatisch den Browser für den OAuth-Ablauf.
@@ -90,10 +90,10 @@ Beide sprechen mit denselben eBay-Endpunkten — der Unterschied ist alles, was
90
90
  | Schnittstelle | Natürliche Sprache über deinen KI-Assistenten | Handgeschriebene HTTP-Anfragen und JSON-Parsing |
91
91
  | OAuth & Token-Erneuerung | Integriert, mit automatischer Erneuerung | Du implementierst und pflegst sie |
92
92
  | Umgang mit Ratenlimits | Automatischer Wiederholungsversuch mit exponentiellem Backoff | Manuelle `429`-Behandlung und Backoff |
93
- | Eingabevalidierung | Zod-Schemata + TypeScript-Typen für jedes Tool | Keine — du validierst deine eigenen Payloads |
93
+ | Eingabevalidierung | Effect-gestützte Schemata + TypeScript-Typen für jedes Tool | Keine — du validierst deine eigenen Payloads |
94
94
  | Einrichtung | Ein Assistent (`npm run setup`) | Auth, Header und Marketplace pro Aufruf |
95
95
  | Unterstützung von KI-Clients | 9 Clients automatisch konfiguriert | Nicht zutreffend |
96
- | API-Abdeckung | 298 Tools über 100% der Sell-APIs, einsatzbereit | Du baust jede Anfrage anhand der Doku selbst |
96
+ | API-Abdeckung | 305 Tools mit 100% Abdeckung der Sell-APIs, einsatzbereit | Du baust jede Anfrage anhand der Doku selbst |
97
97
  | Hosting | Läuft lokal, kein Cloud-Relay | Deine eigene Infrastruktur |
98
98
 
99
99
  ## KI-gestützte Einrichtung mit einem Klick
@@ -236,13 +236,13 @@ Automatisch konfiguriert durch `npm run setup`. Erfordert Node.js ≥ 20 und das
236
236
 
237
237
  ## Verfügbare Tools
238
238
 
239
- **298 Tools**, 100% Sell-API-Abdeckung, nach Kategorie geordnet. Jeder Link verweist auf die Tool-Definitionen und ihre Handler in [`src/tools/categories/`](src/tools/categories/):
239
+ **305 Tools**, 100% Sell-API-Abdeckung, nach Kategorie geordnet. Jeder Link verweist auf die Tool-Definitionen und ihre Handler in [`src/tools/categories/`](src/tools/categories/):
240
240
 
241
241
  | Kategorie | Was du tun kannst |
242
242
  | --- | --- |
243
243
  | [Connector](src/tools/categories/connector.ts) | ChatGPT-Connector-Search/Fetch über den eBay-MCP-Katalog |
244
244
  | [Account](src/tools/categories/account.ts) | Geschäfts-, Versand-, Zahlungs- und Rückgaberichtlinien; Programme; Abonnements; Verkaufssteuer |
245
- | [Inventory](src/tools/categories/inventory.ts) | Bestandsartikel, Angebote, Standorte, Artikelgruppen, Massenvorgänge, SKU/Standort-Zuordnung |
245
+ | [Inventory](src/tools/categories/inventory.ts) | Bestandsartikel, Angebote, Standorte, Artikelgruppen, Massenvorgänge, SKU/Standort-Zuordnung sowie Upload lokaler Fotos/Videos ([`media.ts`](src/tools/categories/media.ts), Media API) |
246
246
  | [Fulfillment](src/tools/categories/fulfillment.ts) | Bestellungen, Versand, Rückerstattungen, Streitfälle, Nachweise zu Zahlungsstreitfällen |
247
247
  | [Marketing](src/tools/categories/marketing.ts) | Kampagnen für beworbene Angebote, Anzeigen, Aktionen, Gebote, Massenvorgänge |
248
248
  | [Analytics](src/tools/categories/analytics.ts) | Traffic-Berichte, Verkäuferstandards, Kundenservice-Kennzahlen |
@@ -251,7 +251,7 @@ Automatisch konfiguriert durch `npm run setup`. Erfordert Node.js ≥ 20 und das
251
251
  | [Taxonomy](src/tools/categories/taxonomy.ts) | Kategoriebäume, Artikelmerkmale, Artikelzustände |
252
252
  | [Browse](src/tools/categories/browse.ts) | Suche nach verkauften/abgeschlossenen Angeboten (Finding API) für Preisvergleiche |
253
253
  | [Other](src/tools/categories/other.ts) | Identity, VeRO, Übersetzung und internationale Versand-Support-APIs (Compliance-Tools melden eBays Stilllegung vom 2026-03-30) |
254
- | [Trading (Legacy-XML)](src/tools/categories/trading.ts) | Festpreisangebote erstellen, überarbeiten, neu einstellen und beenden |
254
+ | [Trading (Legacy-XML)](src/tools/categories/trading.ts) | Festpreisangebote und Auktionen erstellen, überarbeiten, neu einstellen und beenden |
255
255
  | [Developer](src/tools/categories/developer.ts) | Ratenlimits, Signaturschlüssel, Client-Registrierung |
256
256
  | [Token Management](src/tools/categories/tokenManagement.ts) | OAuth-URL-Generierung und Token-Verwaltung |
257
257
 
@@ -299,7 +299,7 @@ Häufige Aufgaben, formuliert wie du sie deinem KI-Assistenten stellen würdest:
299
299
 
300
300
  ### Was ist der eBay MCP-Server?
301
301
 
302
- Ein lokaler [Model-Context-Protocol](https://modelcontextprotocol.io)-Server, der **298 Tools** bereitstellt, die **100% der Sell-APIs von eBay** (270 Endpunkte) für KI-Assistenten abdecken — Bestand, Auftragsabwicklung, Marketing, Analytik und Entwicklertools.
302
+ Ein lokaler [Model-Context-Protocol](https://modelcontextprotocol.io)-Server, der **305 Tools** bereitstellt, die **100% der Sell-APIs von eBay** (274 Endpunkte) für KI-Assistenten abdecken — Bestand, Auftragsabwicklung, Marketing, Analytik und Entwicklertools.
303
303
 
304
304
  ### Ist das ein offizielles eBay-Produkt?
305
305
 
@@ -319,7 +319,7 @@ Interaktive Ansichten via [MCP Apps](#interaktive-oberfläche-mcp-apps) erschein
319
319
 
320
320
  ### Wie viele eBay-APIs und Tools deckt es ab?
321
321
 
322
- 298 Tools über 270 eindeutige Endpunkte — 100% der Sell-APIs von eBay.
322
+ 305 Tools über 274 eindeutige Endpunkte — 100% der Sell-APIs von eBay.
323
323
 
324
324
  ### Ist es kostenlos und Open Source?
325
325
 
@@ -347,11 +347,19 @@ Zugangsdaten werden lokal in deiner `.env`-Datei gespeichert und nur verwendet,
347
347
 
348
348
  ### Worin unterscheidet es sich vom direkten Aufruf der eBay-API?
349
349
 
350
- Du interagierst in natürlicher Sprache über deinen KI-Assistenten. OAuth-Token-Verwaltung, automatische Wiederholungen mit Backoff und typsichere Zod-Validierung sind integriert. Siehe die [Vergleichstabelle](#ebay-mcp-im-vergleich-zur-reinen-ebay-api) oben.
350
+ Du interagierst in natürlicher Sprache über deinen KI-Assistenten. OAuth-Token-Verwaltung, automatische Wiederholungen mit Backoff und typsichere Effect-gestützte Validierung sind integriert. Siehe die [Vergleichstabelle](#ebay-mcp-im-vergleich-zur-reinen-ebay-api) oben.
351
+
352
+ ### Kann es meine Fotos und Videos hochladen?
353
+
354
+ Ja. `ebay_upload_images`, `ebay_upload_video` und `ebay_attach_media_to_inventory_item` lesen lokale Dateien (absolute Pfade oder `media://`-Referenzen) und laden sie über die Media API von eBay hoch. Zurück kommen EPS-Bild-URLs und Video-IDs für `product.imageUrls` / `product.videoIds`. Der Dateizugriff ist opt-in: Nichts ist lesbar, bis `EBAY_MCP_MEDIA_DIRS` oder `EBAY_MCP_MEDIA_ROOT` die Verzeichnisse benennt. Details: [Photos and videos from local files](README.md#photos-and-videos-from-local-files) (Englisch).
355
+
356
+ ### Unterstützt es Auktionen?
357
+
358
+ Ja, über die REST-Inventory-Angebotstools: Erstelle das Angebot mit `format: "AUCTION"`, einem `auctionStartPrice`, einem optionalen `auctionReservePrice` und einer `listingDuration` in Tagen, und veröffentliche es dann. Details: [Auction offers](README.md#auction-offers) (Englisch). Die Trading-API-Tools nutzen denselben Schalter: `ebay_create_listing` mit `format: "AUCTION"` sendet `AddItem` mit `ListingType` Chinese, einem Startgebot `StartPrice` und einer `ListingDuration` in Tagen.
351
359
 
352
360
  ### Unterstützt es die alte Trading-API von eBay (XML)?
353
361
 
354
- Ja. Das Erstellen, Überarbeiten, Neueinstellen und Beenden von Festpreisangeboten wird über die Trading-API-Tools unterstützt.
362
+ Ja. Das Erstellen, Überarbeiten, Neueinstellen und Beenden von Angeboten wird über die Trading-API-Tools unterstützt — für Festpreisangebote (`AddFixedPriceItem`-Familie, Standard) und für Auktionen (`format: "AUCTION"` → `AddItem`, `ReviseItem`, `EndItem`, `RelistItem`).
355
363
 
356
364
  ### Wie bekomme ich höhere Ratenlimits?
357
365
 
@@ -359,7 +367,7 @@ Schließe den OAuth-Ablauf mit `npm run setup` ab, um dich mit einem Benutzer-To
359
367
 
360
368
  ### Womit ist es gebaut?
361
369
 
362
- TypeScript und Node.js (ESM), mit dem offiziellen MCP-SDK, Zod zur Validierung und aus OpenAPI generierten Typen.
370
+ TypeScript und Node.js (ESM), mit dem offiziellen MCP-SDK, Effect-gestützter Validierung mit einem Zod-kompatiblen MCP-Adapter und aus OpenAPI generierten Typen.
363
371
 
364
372
  ### Wie aktualisiere ich auf die neueste Version?
365
373
 
package/README.es.md CHANGED
@@ -5,7 +5,7 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <strong>El servidor MCP de eBay — da a Claude, Cursor y cualquier asistente de IA acceso completo a las Sell APIs de eBay. 298 herramientas para inventario, pedidos, marketing y analítica, ejecutándose localmente con tus propias claves.</strong>
8
+ <strong>El servidor MCP de eBay — da a Claude, Cursor y cualquier asistente de IA acceso completo a las Sell APIs de eBay. 305 herramientas para inventario, pedidos, marketing y analítica, ejecutándose localmente con tus propias claves.</strong>
9
9
  </p>
10
10
 
11
11
  <p align="center"><sub>Proyecto de código abierto no oficial — sin afiliación, autorización ni respaldo de eBay Inc.</sub></p>
@@ -20,7 +20,7 @@
20
20
  </p>
21
21
 
22
22
  <p align="center">
23
- <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 herramientas de la API de eBay" />
23
+ <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 herramientas de la API de eBay" />
24
24
  <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% de cobertura de la Sell API de eBay" />
25
25
  <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="compatible con el Model Context Protocol" />
26
26
  <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="más de 1000 pruebas que pasan" />
@@ -47,7 +47,7 @@
47
47
 
48
48
  > **Nota:** El [README.md](README.md) en inglés es la fuente de verdad para claims de producto actuales (familias de herramientas, APIs decommissioned, notas de versión). Esta traducción puede ir retrasada.
49
49
 
50
- **eBay MCP** es un servidor local del [Model Context Protocol](https://modelcontextprotocol.io) que conecta asistentes de IA —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code y Amazon Q— directamente con las **Sell APIs de eBay**. Expone **298 herramientas** que abarcan el **100% de la superficie de la Sell API de eBay** (270 endpoints únicos) para gestión de inventario, procesamiento de pedidos, marketing de anuncios promocionados, analítica y herramientas para desarrolladores. Todo se ejecuta en tu máquina mediante STDIO o HTTP local: **sin relé en la nube**, y tus credenciales de eBay nunca salen de tu equipo.
50
+ **eBay MCP** es un servidor local del [Model Context Protocol](https://modelcontextprotocol.io) que conecta asistentes de IA —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code y Amazon Q— directamente con las **Sell APIs de eBay**. Expone **305 herramientas** que abarcan el **100% de la superficie de la Sell API de eBay** (274 endpoints únicos) para gestión de inventario, procesamiento de pedidos, marketing de anuncios promocionados, analítica y herramientas para desarrolladores. Todo se ejecuta en tu máquina mediante STDIO o HTTP local: **sin relé en la nube**, y tus credenciales de eBay nunca salen de tu equipo.
51
51
 
52
52
  > **Aviso legal:** Proyecto no oficial de terceros — **sin afiliación ni respaldo de eBay Inc.** Se ofrece "tal cual", sin garantía. Eres responsable de cumplir con el [Acuerdo de licencia de la API de eBay](https://developer.ebay.com/join/api-license-agreement) y los [requisitos de manejo de datos](https://developer.ebay.com/api-docs/static/data-handling-update.html), de mantener tus credenciales seguras y de respetar los límites de tasa. Prueba en sandbox antes de pasar a producción. Consulta [LICENSE](LICENSE), [SECURITY.md](SECURITY.md) y [EBAY_COMPLIANCE.md](EBAY_COMPLIANCE.md).
53
53
 
@@ -71,11 +71,11 @@
71
71
 
72
72
  ## Características
73
73
 
74
- - **298 herramientas de la API de eBay** — 100% de cobertura de las Sell APIs de eBay en inventario, pedidos, marketing, analítica, metadatos, taxonomía y herramientas para desarrolladores.
74
+ - **305 herramientas de la API de eBay** — 100% de cobertura de las Sell APIs de eBay en inventario, pedidos, marketing, analítica, metadatos, taxonomía y herramientas para desarrolladores.
75
75
  - **9 clientes de IA, autoconfigurados** — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI y Amazon Q Developer.
76
76
  - **OAuth 2.0 integrado** — gestión completa de tokens de usuario con renovación automática y respaldo inteligente desde tokens de usuario (10k–50k solicitudes/día) a credenciales de cliente (1k solicitudes/día).
77
77
  - **Resistente por defecto** — reintento automático con retroceso exponencial ante límites de tasa `429` y notificación de errores clara y coherente.
78
- - **Con seguridad de tipos** — TypeScript de principio a fin, entradas de herramientas validadas con Zod y tipos generados a partir de OpenAPI.
78
+ - **Con seguridad de tipos** — TypeScript de principio a fin, entradas de herramientas validadas con Effect y tipos generados a partir de OpenAPI.
79
79
  - **Local y privado** — se ejecuta mediante STDIO o HTTP local; tus credenciales y datos nunca salen de tu máquina.
80
80
  - **Sandbox y producción** — cambia de entorno con una sola variable.
81
81
  - **Configuración con un solo comando** — `npm run setup` configura las credenciales, OAuth y tu cliente MCP, abriendo el navegador automáticamente para el flujo de OAuth.
@@ -90,10 +90,10 @@ Ambos hablan con los mismos endpoints de eBay; la diferencia es todo lo que de o
90
90
  | Interfaz | Lenguaje natural a través de tu asistente de IA | Solicitudes HTTP escritas a mano y análisis de JSON |
91
91
  | OAuth y renovación de tokens | Integrados, con renovación automática | Lo implementas y mantienes tú |
92
92
  | Gestión de límites de tasa | Reintento automático con retroceso exponencial | Manejo manual de `429` y retroceso |
93
- | Validación de entradas | Esquemas Zod + tipos de TypeScript en cada herramienta | Ninguna: validas tus propias cargas útiles |
93
+ | Validación de entradas | Esquemas basados en Effect + tipos de TypeScript en cada herramienta | Ninguna: validas tus propias cargas útiles |
94
94
  | Configuración | Un asistente (`npm run setup`) | Auth, cabeceras y mercado por cada llamada |
95
95
  | Compatibilidad con clientes de IA | 9 clientes autoconfigurados | No aplica |
96
- | Cobertura de la API | 298 herramientas en el 100% de las Sell APIs, listas para usar | Construyes cada solicitud desde la documentación |
96
+ | Cobertura de la API | 305 herramientas en el 100% de las Sell APIs, listas para usar | Construyes cada solicitud desde la documentación |
97
97
  | Alojamiento | Se ejecuta localmente, sin relé en la nube | Tu propia infraestructura |
98
98
 
99
99
  ## Configuración con IA en un clic
@@ -236,13 +236,13 @@ Autoconfigurados por `npm run setup`. Requiere Node.js ≥ 20 y el protocolo MCP
236
236
 
237
237
  ## Herramientas disponibles
238
238
 
239
- **298 herramientas**, 100% de cobertura de la Sell API, organizadas por categoría. Cada enlace apunta a las definiciones de herramientas y a sus handlers en [`src/tools/categories/`](src/tools/categories/):
239
+ **305 herramientas**, 100% de cobertura de la Sell API, organizadas por categoría. Cada enlace apunta a las definiciones de herramientas y a sus handlers en [`src/tools/categories/`](src/tools/categories/):
240
240
 
241
241
  | Categoría | Lo que puedes hacer |
242
242
  | --- | --- |
243
243
  | [Connector](src/tools/categories/connector.ts) | Herramientas search/fetch del conector de ChatGPT sobre el catálogo eBay MCP |
244
244
  | [Account](src/tools/categories/account.ts) | Políticas de negocio, envío, pago y devolución; programas; suscripciones; impuesto sobre ventas |
245
- | [Inventory](src/tools/categories/inventory.ts) | Artículos de inventario, ofertas, ubicaciones, grupos de artículos, operaciones masivas, mapeo SKU/ubicación |
245
+ | [Inventory](src/tools/categories/inventory.ts) | Artículos de inventario, ofertas, ubicaciones, grupos de artículos, operaciones masivas, mapeo SKU/ubicación y subida de fotos/vídeos locales ([`media.ts`](src/tools/categories/media.ts), Media API) |
246
246
  | [Fulfillment](src/tools/categories/fulfillment.ts) | Pedidos, envíos, reembolsos, disputas, evidencias de disputas de pago |
247
247
  | [Marketing](src/tools/categories/marketing.ts) | Campañas de anuncios promocionados, anuncios, promociones, pujas, operaciones masivas |
248
248
  | [Analytics](src/tools/categories/analytics.ts) | Informes de tráfico, estándares de vendedor, métricas de atención al cliente |
@@ -251,7 +251,7 @@ Autoconfigurados por `npm run setup`. Requiere Node.js ≥ 20 y el protocolo MCP
251
251
  | [Taxonomy](src/tools/categories/taxonomy.ts) | Árboles de categorías, aspectos de artículos, condiciones de artículos |
252
252
  | [Browse](src/tools/categories/browse.ts) | Búsqueda de listings vendidos/completados (Finding API) para comparables de precio |
253
253
  | [Other](src/tools/categories/other.ts) | Identity, VeRO, traducción y APIs de envío internacional (las herramientas de Compliance informan la desactivación de eBay del 2026-03-30) |
254
- | [Trading (XML heredado)](src/tools/categories/trading.ts) | Crear, revisar, volver a publicar y finalizar anuncios de precio fijo |
254
+ | [Trading (XML heredado)](src/tools/categories/trading.ts) | Crear, revisar, volver a publicar y finalizar anuncios de precio fijo y subastas |
255
255
  | [Developer](src/tools/categories/developer.ts) | Límites de tasa, claves de firma, registro de clientes |
256
256
  | [Token Management](src/tools/categories/tokenManagement.ts) | Generación de URL de OAuth y gestión de tokens |
257
257
 
@@ -299,7 +299,7 @@ Tareas comunes, formuladas como se las pedirías a tu asistente de IA:
299
299
 
300
300
  ### ¿Qué es el servidor MCP de eBay?
301
301
 
302
- Un servidor local del [Model Context Protocol](https://modelcontextprotocol.io) que expone **298 herramientas** que cubren el **100% de las Sell APIs de eBay** (270 endpoints) a los asistentes de IA: inventario, procesamiento de pedidos, marketing, analítica y herramientas para desarrolladores.
302
+ Un servidor local del [Model Context Protocol](https://modelcontextprotocol.io) que expone **305 herramientas** que cubren el **100% de las Sell APIs de eBay** (274 endpoints) a los asistentes de IA: inventario, procesamiento de pedidos, marketing, analítica y herramientas para desarrolladores.
303
303
 
304
304
  ### ¿Es un producto oficial de eBay?
305
305
 
@@ -319,7 +319,7 @@ Las vistas interactivas de [MCP Apps](#interfaz-interactiva-mcp-apps) solo apare
319
319
 
320
320
  ### ¿Cuántas APIs y herramientas de eBay cubre?
321
321
 
322
- 298 herramientas en 270 endpoints únicos: el 100% de las Sell APIs de eBay.
322
+ 305 herramientas en 274 endpoints únicos: el 100% de las Sell APIs de eBay.
323
323
 
324
324
  ### ¿Es gratuito y de código abierto?
325
325
 
@@ -347,11 +347,19 @@ Las credenciales se almacenan localmente en tu archivo `.env` y se usan solo par
347
347
 
348
348
  ### ¿En qué se diferencia de llamar directamente a la API de eBay?
349
349
 
350
- Interactúas en lenguaje natural a través de tu asistente de IA. La gestión de tokens OAuth, los reintentos automáticos con retroceso y la validación con seguridad de tipos mediante Zod están integrados. Consulta la [tabla comparativa](#ebay-mcp-frente-a-la-api-de-ebay-sin-procesar) de arriba.
350
+ Interactúas en lenguaje natural a través de tu asistente de IA. La gestión de tokens OAuth, los reintentos automáticos con retroceso y la validación con seguridad de tipos basada en Effect están integrados. Consulta la [tabla comparativa](#ebay-mcp-frente-a-la-api-de-ebay-sin-procesar) de arriba.
351
+
352
+ ### ¿Puede subir mis fotos y vídeos?
353
+
354
+ Sí. `ebay_upload_images`, `ebay_upload_video` y `ebay_attach_media_to_inventory_item` leen archivos locales (rutas absolutas o referencias `media://`) y los suben mediante la Media API de eBay, devolviendo URL de imagen EPS e ID de vídeo para `product.imageUrls` / `product.videoIds`. El acceso al sistema de archivos es opcional: no se puede leer nada hasta que `EBAY_MCP_MEDIA_DIRS` o `EBAY_MCP_MEDIA_ROOT` indiquen los directorios. Consulta [Photos and videos from local files](README.md#photos-and-videos-from-local-files) (en inglés).
355
+
356
+ ### ¿Admite anuncios de subasta?
357
+
358
+ Sí, mediante las herramientas de ofertas de la Inventory API (REST): crea la oferta con `format: "AUCTION"`, un `auctionStartPrice`, un `auctionReservePrice` opcional y una `listingDuration` en días, y luego publícala. Consulta [Auction offers](README.md#auction-offers) (en inglés). Las herramientas de la Trading API usan el mismo selector: `ebay_create_listing` con `format: "AUCTION"` envía `AddItem` con `ListingType` Chinese, un `StartPrice` como puja inicial y una `ListingDuration` en días.
351
359
 
352
360
  ### ¿Es compatible con la antigua Trading API de eBay (XML)?
353
361
 
354
- Sí. Se admiten las operaciones de crear, revisar, volver a publicar y finalizar anuncios de precio fijo mediante las herramientas de la Trading API.
362
+ Sí. Las operaciones de crear, revisar, volver a publicar y finalizar anuncios se admiten mediante las herramientas de la Trading API, tanto para anuncios de precio fijo (familia `AddFixedPriceItem`, la opción predeterminada) como para subastas (`format: "AUCTION"` → `AddItem`, `ReviseItem`, `EndItem`, `RelistItem`).
355
363
 
356
364
  ### ¿Cómo obtengo límites de tasa más altos?
357
365
 
@@ -359,7 +367,7 @@ Completa el flujo de OAuth con `npm run setup` para autenticarte con un token de
359
367
 
360
368
  ### ¿Con qué está construido?
361
369
 
362
- TypeScript y Node.js (ESM), usando el SDK oficial de MCP, Zod para la validación y tipos generados a partir de OpenAPI.
370
+ TypeScript y Node.js (ESM), usando el SDK oficial de MCP, validación basada en Effect con un adaptador MCP compatible con Zod y tipos generados a partir de OpenAPI.
363
371
 
364
372
  ### ¿Cómo actualizo a la última versión?
365
373
 
package/README.fr.md CHANGED
@@ -5,7 +5,7 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <strong>Le serveur MCP eBay — donnez à Claude, Cursor et tout assistant IA un accès complet aux Sell APIs d'eBay. 298 outils pour l'inventaire, les commandes, le marketing et l'analytique, le tout en local avec vos propres clés.</strong>
8
+ <strong>Le serveur MCP eBay — donnez à Claude, Cursor et tout assistant IA un accès complet aux Sell APIs d'eBay. 305 outils pour l'inventaire, les commandes, le marketing et l'analytique, le tout en local avec vos propres clés.</strong>
9
9
  </p>
10
10
 
11
11
  <p align="center"><sub>Projet open source non officiel — sans affiliation, autorisation ni approbation d'eBay Inc.</sub></p>
@@ -20,7 +20,7 @@
20
20
  </p>
21
21
 
22
22
  <p align="center">
23
- <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 outils de l'API eBay" />
23
+ <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 outils de l'API eBay" />
24
24
  <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% de couverture de la Sell API d'eBay" />
25
25
  <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="compatible Model Context Protocol" />
26
26
  <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="plus de 1000 tests réussis" />
@@ -47,7 +47,7 @@
47
47
 
48
48
  > **Note :** le [README.md](README.md) anglais est la source de vérité pour les informations produit à jour (familles d’outils, API décommissionnées, notes de version). Cette traduction peut être en retard.
49
49
 
50
- **eBay MCP** est un serveur local du [Model Context Protocol](https://modelcontextprotocol.io) qui connecte les assistants IA —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code et Amazon Q— directement aux **Sell APIs d'eBay**. Il expose **298 outils** couvrant **100% de la surface de la Sell API d'eBay** (270 endpoints uniques) pour la gestion de l'inventaire, le traitement des commandes, le marketing d'annonces sponsorisées, l'analytique et l'outillage développeur. Tout s'exécute sur votre machine via STDIO ou HTTP local — **sans relais cloud**, et vos identifiants eBay ne quittent jamais votre ordinateur.
50
+ **eBay MCP** est un serveur local du [Model Context Protocol](https://modelcontextprotocol.io) qui connecte les assistants IA —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code et Amazon Q— directement aux **Sell APIs d'eBay**. Il expose **305 outils** couvrant **100% de la surface de la Sell API d'eBay** (274 endpoints uniques) pour la gestion de l'inventaire, le traitement des commandes, le marketing d'annonces sponsorisées, l'analytique et l'outillage développeur. Tout s'exécute sur votre machine via STDIO ou HTTP local — **sans relais cloud**, et vos identifiants eBay ne quittent jamais votre ordinateur.
51
51
 
52
52
  > **Avertissement :** Projet tiers non officiel — **sans affiliation ni approbation d'eBay Inc.** Fourni « tel quel », sans garantie. Il vous incombe de respecter l'[Accord de licence de l'API eBay](https://developer.ebay.com/join/api-license-agreement) et les [exigences de traitement des données](https://developer.ebay.com/api-docs/static/data-handling-update.html), de protéger vos identifiants et de respecter les limites de débit. Testez en sandbox avant la production. Voir [LICENSE](LICENSE), [SECURITY.md](SECURITY.md) et [EBAY_COMPLIANCE.md](EBAY_COMPLIANCE.md).
53
53
 
@@ -71,11 +71,11 @@
71
71
 
72
72
  ## Fonctionnalités
73
73
 
74
- - **298 outils de l'API eBay** — 100% de couverture des Sell APIs d'eBay pour l'inventaire, les commandes, le marketing, l'analytique, les métadonnées, la taxonomie et l'outillage développeur.
74
+ - **305 outils de l'API eBay** — 100% de couverture des Sell APIs d'eBay pour l'inventaire, les commandes, le marketing, l'analytique, les métadonnées, la taxonomie et l'outillage développeur.
75
75
  - **9 clients IA, configurés automatiquement** — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI et Amazon Q Developer.
76
76
  - **OAuth 2.0 intégré** — gestion complète des jetons utilisateur avec renouvellement automatique et bascule intelligente des jetons utilisateur (10k–50k req/jour) vers les identifiants client (1k req/jour).
77
77
  - **Résilient par défaut** — nouvelle tentative automatique avec recul exponentiel sur les limites de débit `429` et remontée d'erreurs claire et cohérente.
78
- - **Typage sûr** — TypeScript de bout en bout, entrées d'outils validées par Zod et types générés à partir d'OpenAPI.
78
+ - **Typage sûr** — TypeScript de bout en bout, entrées d'outils validées par Effect et types générés à partir d'OpenAPI.
79
79
  - **Local et privé** — s'exécute via STDIO ou HTTP local ; vos identifiants et données ne quittent jamais votre machine.
80
80
  - **Sandbox et production** — changez d'environnement avec une seule variable.
81
81
  - **Configuration en une commande** — `npm run setup` configure les identifiants, OAuth et votre client MCP, en ouvrant automatiquement le navigateur pour le flux OAuth.
@@ -90,10 +90,10 @@ Les deux dialoguent avec les mêmes endpoints eBay — la différence, c'est tou
90
90
  | Interface | Langage naturel via votre assistant IA | Requêtes HTTP écrites à la main et analyse JSON |
91
91
  | OAuth et renouvellement des jetons | Intégrés, avec renouvellement automatique | Vous les implémentez et les maintenez |
92
92
  | Gestion des limites de débit | Nouvelle tentative automatique avec recul exponentiel | Gestion manuelle des `429` et du recul |
93
- | Validation des entrées | Schémas Zod + types TypeScript sur chaque outil | Aucune — vous validez vos propres charges utiles |
93
+ | Validation des entrées | Schémas basés sur Effect + types TypeScript sur chaque outil | Aucune — vous validez vos propres charges utiles |
94
94
  | Configuration | Un assistant (`npm run setup`) | Auth, en-têtes et marketplace par appel |
95
95
  | Prise en charge des clients IA | 9 clients configurés automatiquement | Sans objet |
96
- | Couverture de l'API | 298 outils sur 100% des Sell APIs, prêts à l'emploi | Vous construisez chaque requête depuis la documentation |
96
+ | Couverture de l'API | 305 outils sur 100% des Sell APIs, prêts à l'emploi | Vous construisez chaque requête depuis la documentation |
97
97
  | Hébergement | S'exécute en local, sans relais cloud | Votre propre infrastructure |
98
98
 
99
99
  ## Configuration assistée par IA en un clic
@@ -236,13 +236,13 @@ Configurés automatiquement par `npm run setup`. Nécessite Node.js ≥ 20 et le
236
236
 
237
237
  ## Outils disponibles
238
238
 
239
- **298 outils**, 100% de couverture de la Sell API, organisés par catégorie. Chaque lien pointe vers les définitions d'outils et leurs handlers dans [`src/tools/categories/`](src/tools/categories/) :
239
+ **305 outils**, 100% de couverture de la Sell API, organisés par catégorie. Chaque lien pointe vers les définitions d'outils et leurs handlers dans [`src/tools/categories/`](src/tools/categories/) :
240
240
 
241
241
  | Catégorie | Ce que vous pouvez faire |
242
242
  | --- | --- |
243
243
  | [Connector](src/tools/categories/connector.ts) | Outils search/fetch du connecteur ChatGPT sur le catalogue eBay MCP |
244
244
  | [Account](src/tools/categories/account.ts) | Politiques commerciales, d'expédition, de paiement et de retour ; programmes ; abonnements ; taxe de vente |
245
- | [Inventory](src/tools/categories/inventory.ts) | Articles d'inventaire, offres, emplacements, groupes d'articles, opérations en masse, mappage SKU/emplacement |
245
+ | [Inventory](src/tools/categories/inventory.ts) | Articles d'inventaire, offres, emplacements, groupes d'articles, opérations en masse, mappage SKU/emplacement et envoi de photos/vidéos locales ([`media.ts`](src/tools/categories/media.ts), Media API) |
246
246
  | [Fulfillment](src/tools/categories/fulfillment.ts) | Commandes, expédition, remboursements, litiges, preuves de litiges de paiement |
247
247
  | [Marketing](src/tools/categories/marketing.ts) | Campagnes d'annonces sponsorisées, annonces, promotions, enchères, opérations en masse |
248
248
  | [Analytics](src/tools/categories/analytics.ts) | Rapports de trafic, standards vendeur, métriques de service client |
@@ -251,7 +251,7 @@ Configurés automatiquement par `npm run setup`. Nécessite Node.js ≥ 20 et le
251
251
  | [Taxonomy](src/tools/categories/taxonomy.ts) | Arbres de catégories, aspects d'articles, états d'articles |
252
252
  | [Browse](src/tools/categories/browse.ts) | Recherche d’annonces vendues/terminées (Finding API) pour comparaisons de prix |
253
253
  | [Other](src/tools/categories/other.ts) | Identity, VeRO, traduction et APIs d’expédition internationale (les outils Compliance signalent la décommission eBay du 2026-03-30) |
254
- | [Trading (XML hérité)](src/tools/categories/trading.ts) | Créer, réviser, remettre en vente et clôturer des annonces à prix fixe |
254
+ | [Trading (XML hérité)](src/tools/categories/trading.ts) | Créer, réviser, remettre en vente et clôturer des annonces à prix fixe et des enchères |
255
255
  | [Developer](src/tools/categories/developer.ts) | Limites de débit, clés de signature, enregistrement de clients |
256
256
  | [Token Management](src/tools/categories/tokenManagement.ts) | Génération d'URL OAuth et gestion des jetons |
257
257
 
@@ -299,7 +299,7 @@ Tâches courantes, formulées comme vous les demanderiez à votre assistant IA :
299
299
 
300
300
  ### Qu'est-ce que le serveur MCP eBay ?
301
301
 
302
- Un serveur local du [Model Context Protocol](https://modelcontextprotocol.io) qui expose **298 outils** couvrant **100% des Sell APIs d'eBay** (270 endpoints) aux assistants IA — inventaire, traitement des commandes, marketing, analytique et outils développeur.
302
+ Un serveur local du [Model Context Protocol](https://modelcontextprotocol.io) qui expose **305 outils** couvrant **100% des Sell APIs d'eBay** (274 endpoints) aux assistants IA — inventaire, traitement des commandes, marketing, analytique et outils développeur.
303
303
 
304
304
  ### Est-ce un produit officiel eBay ?
305
305
 
@@ -319,7 +319,7 @@ Les vues interactives [MCP Apps](#interface-interactive-mcp-apps) n'apparaissent
319
319
 
320
320
  ### Combien d'API et d'outils eBay couvre-t-il ?
321
321
 
322
- 298 outils sur 270 endpoints uniques — 100% des Sell APIs d'eBay.
322
+ 305 outils sur 274 endpoints uniques — 100% des Sell APIs d'eBay.
323
323
 
324
324
  ### Est-il gratuit et open source ?
325
325
 
@@ -347,11 +347,19 @@ Les identifiants sont stockés localement dans votre fichier `.env` et utilisés
347
347
 
348
348
  ### En quoi est-ce différent d'appeler directement l'API eBay ?
349
349
 
350
- Vous interagissez en langage naturel via votre assistant IA. La gestion des jetons OAuth, les nouvelles tentatives automatiques avec recul et la validation typée via Zod sont intégrées. Voir le [tableau comparatif](#ebay-mcp-face-à-lapi-brute-debay) ci-dessus.
350
+ Vous interagissez en langage naturel via votre assistant IA. La gestion des jetons OAuth, les nouvelles tentatives automatiques avec recul et la validation typée basée sur Effect sont intégrées. Voir le [tableau comparatif](#ebay-mcp-face-à-lapi-brute-debay) ci-dessus.
351
+
352
+ ### Peut-il envoyer mes photos et vidéos ?
353
+
354
+ Oui. `ebay_upload_images`, `ebay_upload_video` et `ebay_attach_media_to_inventory_item` lisent des fichiers locaux (chemins absolus ou références `media://`) et les envoient via la Media API d'eBay, en renvoyant des URL d'images EPS et des identifiants de vidéos pour `product.imageUrls` / `product.videoIds`. L'accès au système de fichiers est optionnel : rien n'est lisible tant que `EBAY_MCP_MEDIA_DIRS` ou `EBAY_MCP_MEDIA_ROOT` ne désigne pas les répertoires. Voir [Photos and videos from local files](README.md#photos-and-videos-from-local-files) (en anglais).
355
+
356
+ ### Prend-il en charge les enchères ?
357
+
358
+ Oui, via les outils d'offres de l'Inventory API (REST) : créez l'offre avec `format: "AUCTION"`, un `auctionStartPrice`, un `auctionReservePrice` facultatif et une `listingDuration` en jours, puis publiez-la. Voir [Auction offers](README.md#auction-offers) (en anglais). Les outils de la Trading API utilisent le même sélecteur : `ebay_create_listing` avec `format: "AUCTION"` envoie `AddItem` avec `ListingType` Chinese, une mise à prix `StartPrice` et une `ListingDuration` en jours.
351
359
 
352
360
  ### Prend-il en charge l'ancienne Trading API d'eBay (XML) ?
353
361
 
354
- Oui. Les opérations de création, révision, remise en vente et clôture d'annonces à prix fixe sont prises en charge via les outils de la Trading API.
362
+ Oui. Les opérations de création, révision, remise en vente et clôture d'annonces sont prises en charge via les outils de la Trading API, pour les annonces à prix fixe (famille `AddFixedPriceItem`, par défaut) comme pour les enchères (`format: "AUCTION"` → `AddItem`, `ReviseItem`, `EndItem`, `RelistItem`).
355
363
 
356
364
  ### Comment obtenir des limites de débit plus élevées ?
357
365
 
@@ -359,7 +367,7 @@ Terminez le flux OAuth avec `npm run setup` pour vous authentifier avec un jeton
359
367
 
360
368
  ### Avec quoi est-il construit ?
361
369
 
362
- TypeScript et Node.js (ESM), avec le SDK officiel MCP, Zod pour la validation et des types générés à partir d'OpenAPI.
370
+ TypeScript et Node.js (ESM), avec le SDK officiel MCP, une validation basée sur Effect avec un adaptateur MCP compatible Zod et des types générés à partir d'OpenAPI.
363
371
 
364
372
  ### Comment mettre à jour vers la dernière version ?
365
373
 
package/README.ja.md CHANGED
@@ -5,7 +5,7 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <strong>eBay MCP サーバー — Claude、Cursor、そしてあらゆる AI アシスタントに eBay の Sell API への完全なアクセスを。在庫・注文・マーケティング・分析向けの 298 ツールを、自分の鍵でローカル実行。</strong>
8
+ <strong>eBay MCP サーバー — Claude、Cursor、そしてあらゆる AI アシスタントに eBay の Sell API への完全なアクセスを提供します。在庫・注文・マーケティング・分析向けの 305 ツールを、自分の鍵でローカル実行。</strong>
9
9
  </p>
10
10
 
11
11
  <p align="center"><sub>非公式のオープンソースプロジェクト — eBay Inc. との提携・認可・承認はありません。</sub></p>
@@ -20,7 +20,7 @@
20
20
  </p>
21
21
 
22
22
  <p align="center">
23
- <img src="https://img.shields.io/badge/tools-298-8957e5?logo=ebay&logoColor=white" alt="298 個の eBay API ツール" />
23
+ <img src="https://img.shields.io/badge/tools-305-8957e5?logo=ebay&logoColor=white" alt="305 個の eBay API ツール" />
24
24
  <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="eBay Sell API を 100% カバー" />
25
25
  <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="Model Context Protocol 対応" />
26
26
  <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="1000 件以上のテストに合格" />
@@ -47,7 +47,7 @@
47
47
 
48
48
  > **注意:** 最新の製品情報(ツールファミリー、API 廃止、バージョン注記)の正本は英語の [README.md](README.md) です。この翻訳は遅れている場合があります。
49
49
 
50
- **eBay MCP** は、AI アシスタント —Claude Desktop、Claude Code、Cursor、Cline、Windsurf、Zed、Continue.dev、Roo Code、Amazon Q— を **eBay の Sell API** に直接接続するローカルの [Model Context Protocol](https://modelcontextprotocol.io) サーバーです。**eBay Sell API の全面(270 の固有エンドポイント)の 100%** をカバーする **298 個のツール** を提供し、在庫管理、注文処理、プロモーション広告のマーケティング、分析、開発者向けツールに対応します。すべては STDIO またはローカル HTTP 経由であなたのマシン上で動作し、**クラウド中継はありません**。eBay の認証情報がコンピューターから外に出ることは決してありません。
50
+ **eBay MCP** は、AI アシスタント —Claude Desktop、Claude Code、Cursor、Cline、Windsurf、Zed、Continue.dev、Roo Code、Amazon Q— を **eBay の Sell API** に直接接続するローカルの [Model Context Protocol](https://modelcontextprotocol.io) サーバーです。**eBay Sell API の全面(274 の固有エンドポイント)の 100%** をカバーする **305 個のツール** を提供し、在庫管理、注文処理、プロモーション広告のマーケティング、分析、開発者向けツールに対応します。すべては STDIO またはローカル HTTP 経由であなたのマシン上で動作し、**クラウド中継はありません**。eBay の認証情報がコンピューターから外に出ることは決してありません。
51
51
 
52
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) を参照してください。
53
53
 
@@ -71,11 +71,11 @@
71
71
 
72
72
  ## 機能
73
73
 
74
- - **298 個の eBay API ツール** — 在庫、注文、マーケティング、分析、メタデータ、タクソノミー、開発者向けツールにわたり eBay Sell API を 100% カバー。
74
+ - **305 個の eBay API ツール** — 在庫、注文、マーケティング、分析、メタデータ、タクソノミー、開発者向けツールにわたり eBay Sell API を 100% カバー。
75
75
  - **9 つの AI クライアントを自動設定** — Claude Desktop、Cursor、Zed、Cline、Continue.dev、Windsurf、Roo Code、Claude Code CLI、Amazon Q Developer。
76
76
  - **OAuth 2.0 を内蔵** — ユーザートークンの完全な管理と自動更新に加え、ユーザートークン(1 日 1 万〜5 万リクエスト)からクライアント認証情報(1 日 1 千リクエスト)へのスマートなフォールバック。
77
77
  - **既定で堅牢** — `429` レート制限時に指数バックオフで自動リトライし、一貫した明確なエラー表示を行います。
78
- - **型安全** — エンドツーエンドの TypeScript、Zod による検証付きのツール入力、OpenAPI から生成された型。
78
+ - **型安全** — エンドツーエンドの TypeScript、Effect による検証付きのツール入力、OpenAPI から生成された型。
79
79
  - **ローカルかつプライベート** — STDIO またはローカル HTTP で動作。認証情報やデータがマシンから外に出ることはありません。
80
80
  - **サンドボックスと本番** — 変数 1 つで環境を切り替え。
81
81
  - **1 コマンドで設定** — `npm run setup` が認証情報、OAuth、MCP クライアントを設定し、OAuth フローのためにブラウザを自動で開きます。
@@ -90,10 +90,10 @@
90
90
  | インターフェース | AI アシスタントを介した自然言語 | 手書きの HTTP リクエストと JSON 解析 |
91
91
  | OAuth とトークン更新 | 内蔵、自動更新あり | 自分で実装・保守 |
92
92
  | レート制限の処理 | 指数バックオフによる自動リトライ | `429` とバックオフの手動処理 |
93
- | 入力検証 | すべてのツールに Zod スキーマ + TypeScript 型 | なし — 自分でペイロードを検証 |
93
+ | 入力検証 | すべてのツールに Effect ベースのスキーマ + TypeScript 型 | なし — 自分でペイロードを検証 |
94
94
  | セットアップ | 1 つのウィザード(`npm run setup`) | 呼び出しごとに認証・ヘッダー・マーケットプレイス |
95
95
  | AI クライアント対応 | 9 クライアントを自動設定 | 該当なし |
96
- | API カバレッジ | Sell API の 100% にわたる 298 ツール、すぐ呼び出し可能 | ドキュメントから各リクエストを構築 |
96
+ | API カバレッジ | Sell API の 100% にわたる 305 ツール、すぐ呼び出し可能 | ドキュメントから各リクエストを構築 |
97
97
  | ホスティング | ローカル動作、クラウド中継なし | 自前のインフラ |
98
98
 
99
99
  ## AI ワンクリック設定
@@ -236,13 +236,13 @@ EBAY_MCP_UI=on # インタラクティブな MCP Apps 表
236
236
 
237
237
  ## 利用可能なツール
238
238
 
239
- **298 ツール**、Sell API を 100% カバー、カテゴリ別に整理。各リンクは [`src/tools/categories/`](src/tools/categories/) 内のツール定義とそのハンドラーを指します:
239
+ **305 ツール**、Sell API を 100% カバー、カテゴリ別に整理。各リンクは [`src/tools/categories/`](src/tools/categories/) 内のツール定義とそのハンドラーを指します:
240
240
 
241
241
  | カテゴリ | できること |
242
242
  | --- | --- |
243
243
  | [Connector](src/tools/categories/connector.ts) | eBay MCP カタログ向け ChatGPT コネクタの search/fetch |
244
244
  | [Account](src/tools/categories/account.ts) | ビジネス・配送・支払い・返品ポリシー、プログラム、サブスクリプション、販売税 |
245
- | [Inventory](src/tools/categories/inventory.ts) | 在庫アイテム、オファー、ロケーション、アイテムグループ、一括操作、SKU/ロケーションのマッピング |
245
+ | [Inventory](src/tools/categories/inventory.ts) | 在庫アイテム、オファー、ロケーション、アイテムグループ、一括操作、SKU/ロケーションのマッピング、ローカル写真・動画のアップロード([`media.ts`](src/tools/categories/media.ts)、Media API) |
246
246
  | [Fulfillment](src/tools/categories/fulfillment.ts) | 注文、配送、返金、係争、支払い係争の証拠 |
247
247
  | [Marketing](src/tools/categories/marketing.ts) | プロモーション広告キャンペーン、広告、プロモーション、入札、一括操作 |
248
248
  | [Analytics](src/tools/categories/analytics.ts) | トラフィックレポート、出品者基準、カスタマーサービス指標 |
@@ -251,7 +251,7 @@ EBAY_MCP_UI=on # インタラクティブな MCP Apps 表
251
251
  | [Taxonomy](src/tools/categories/taxonomy.ts) | カテゴリツリー、アイテムの特性、アイテムのコンディション |
252
252
  | [Browse](src/tools/categories/browse.ts) | 価格比較のための売約済み/完了リスティング検索(Finding API) |
253
253
  | [Other](src/tools/categories/other.ts) | Identity、VeRO、翻訳、国際配送サポート API(Compliance ツールは eBay の 2026-03-30 廃止を報告) |
254
- | [Trading(レガシー XML)](src/tools/categories/trading.ts) | 固定価格出品の作成・修正・再出品・終了 |
254
+ | [Trading(レガシー XML)](src/tools/categories/trading.ts) | 固定価格出品とオークションの作成・修正・再出品・終了 |
255
255
  | [Developer](src/tools/categories/developer.ts) | レート制限、署名キー、クライアント登録 |
256
256
  | [Token Management](src/tools/categories/tokenManagement.ts) | OAuth URL の生成とトークン管理 |
257
257
 
@@ -299,7 +299,7 @@ AI アシスタントに尋ねるように表現した一般的なタスク:
299
299
 
300
300
  ### eBay MCP サーバーとは何ですか?
301
301
 
302
- AI アシスタントに **eBay Sell API の 100%**(270 エンドポイント)をカバーする **298 個のツール** を公開するローカルの [Model Context Protocol](https://modelcontextprotocol.io) サーバーです — 在庫、注文処理、マーケティング、分析、開発者向けツール。
302
+ AI アシスタントに **eBay Sell API の 100%**(274 エンドポイント)をカバーする **305 個のツール** を公開するローカルの [Model Context Protocol](https://modelcontextprotocol.io) サーバーです — 在庫、注文処理、マーケティング、分析、開発者向けツール。
303
303
 
304
304
  ### これは eBay の公式製品ですか?
305
305
 
@@ -319,7 +319,7 @@ AI アシスタントに **eBay Sell API の 100%**(270 エンドポイント
319
319
 
320
320
  ### eBay の API とツールはどれくらいカバーしていますか?
321
321
 
322
- 270 の固有エンドポイントにわたる 298 ツール — eBay Sell API の 100% です。
322
+ 274 の固有エンドポイントにわたる 305 ツール — eBay Sell API の 100% です。
323
323
 
324
324
  ### 無料でオープンソースですか?
325
325
 
@@ -347,11 +347,19 @@ Node.js ≥ 20、無料の [eBay 開発者アカウント](https://developer.eba
347
347
 
348
348
  ### eBay API を直接呼び出すのと何が違いますか?
349
349
 
350
- AI アシスタントを通じて自然言語でやり取りします。OAuth トークン管理、バックオフ付きの自動リトライ、Zod による型安全な検証が組み込まれています。上の [比較表](#ebay-mcp-と素の-ebay-api) を参照してください。
350
+ AI アシスタントを通じて自然言語でやり取りします。OAuth トークン管理、バックオフ付きの自動リトライ、Effect による型安全な検証が組み込まれています。上の [比較表](#ebay-mcp-と素の-ebay-api) を参照してください。
351
+
352
+ ### 写真や動画をアップロードできますか?
353
+
354
+ はい。`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)(英語)を参照してください。
355
+
356
+ ### オークション出品に対応していますか?
357
+
358
+ はい。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` を送信します。
351
359
 
352
360
  ### eBay のレガシー Trading API(XML)に対応していますか?
353
361
 
354
- はい。固定価格出品の作成・修正・再出品・終了の操作が Trading API ツールでサポートされています。
362
+ はい。出品の作成・修正・再出品・終了の操作が Trading API ツールでサポートされています。固定価格出品(`AddFixedPriceItem` 系、デフォルト)とオークション(`format: "AUCTION"` → `AddItem`、`ReviseItem`、`EndItem`、`RelistItem`)の両方に対応します。
355
363
 
356
364
  ### より高いレート制限を得るには?
357
365
 
@@ -359,7 +367,7 @@ AI アシスタントを通じて自然言語でやり取りします。OAuth
359
367
 
360
368
  ### 何で構築されていますか?
361
369
 
362
- TypeScript と Node.js(ESM)で、公式の MCP SDK、検証用の Zod、OpenAPI から生成された型を使用しています。
370
+ TypeScript と Node.js(ESM)で、公式の MCP SDK、Zod 互換の MCP アダプターを備えた Effect ベースの検証、OpenAPI から生成された型を使用しています。
363
371
 
364
372
  ### 最新バージョンへの更新方法は?
365
373