ebay-mcp-remote-edition 4.2.1 → 4.4.0

package/build/api/browse/browse.js

@@ -0,0 +1,43 @@
+import { getBaseUrl } from '../../config/environment.js';
+/**
+ * Browse API - Search and browse eBay product catalog
+ * Based on: eBay Buy Browse API
+ * Base endpoint: /buy/browse/v1
+ */
+export class BrowseApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search the eBay product catalog by query.
+     * Supports category filtering, sorting, and price filtering.
+     */
+    async searchProducts(query, options) {
+        const environment = this.client.getConfig().environment;
+        const browseUrl = new URL('/buy/browse/v1/item_summary/search', getBaseUrl(environment)).toString();
+        const params = { q: query };
+        if (options?.categoryId)
+            params.category_ids = options.categoryId;
+        if (options?.limit)
+            params.limit = options.limit;
+        if (options?.sort)
+            params.sort = options.sort;
+        if (options?.filter)
+            params.filter = options.filter;
+        if (options?.aspectFilter)
+            params.aspect_filter = options.aspectFilter;
+        return await this.client.getWithFullUrl(browseUrl, params);
+    }
+    /**
+     * Get listing/product suggestions based on search query.
+     * Returns relevant item summaries with pricing and shipping info.
+     */
+    async getSuggestions(query, options) {
+        return await this.searchProducts(query, {
+            marketplaceId: options?.marketplaceId,
+            limit: options?.limit ?? 20,
+            sort: 'bestMatch',
+        });
+    }
+}

package/build/api/client-trading.js

@@ -49,7 +49,7 @@ export class TradingApiClient {
      * Handles nested objects like PrimaryCategory, ShippingDetails, ReturnPolicy,
      * PicturesDetails, and ItemSpecifics that require special XML structure.
      */
-    transformItemForXML(item) {
+    transformItemForXML(item, options = { ensureCountry: true }) {
         const transformed = {};
         for (const [key, value] of Object.entries(item)) {
             if (value === undefined || value === null)
@@ -117,6 +117,13 @@ export class TradingApiClient {
                 transformed.Currency = 'USD';
             }
         }
+        // Ensure Country is present for full listing creation/publish transforms.
+        // ReviseFixedPriceItem may update only a subset of fields; injecting a default Country
+        // can accidentally attempt to change an active listing's country and eBay rejects it as
+        // "Input data is invalid." Skip this default for partial revise payloads.
+        if (options.ensureCountry !== false && !transformed.Country) {
+            transformed.Country = 'USA';
+        }
         return transformed;
     }
     /**
@@ -124,13 +131,14 @@ export class TradingApiClient {
      * eBay Trading API expects: <StartPrice currencyID="USD">34.99</StartPrice>
      */
     transformPrice(price) {
-        if (typeof price === 'string') {
-            return price;
+        if (typeof price === 'string' || typeof price === 'number') {
+            return String(price);
         }
+        const currencyID = price.currencyID ?? price.currency;
         // Use fast-xml-parser attribute convention: @_<attrName> for attributes, #text for content
         return {
             '#text': String(price.value),
-            ...(price.currencyID && { '@_currencyID': price.currencyID }),
+            ...(currencyID && { '@_currencyID': currencyID }),
         };
     }
     /**
@@ -264,7 +272,7 @@ export class TradingApiClient {
         // Transform Item field for proper XML serialization
         const transformedParams = { ...params };
         if (transformedParams.Item && typeof transformedParams.Item === 'object') {
-            transformedParams.Item = this.transformItemForXML(transformedParams.Item);
+            transformedParams.Item = this.transformItemForXML(transformedParams.Item, { ensureCountry: callName !== 'ReviseFixedPriceItem' });
         }
         const xmlObj = {};
         xmlObj[requestTag] = {

package/build/api/index.js

@@ -6,6 +6,7 @@ import { MessageApi } from '../api/communication/message.js';
 import { NegotiationApi } from '../api/communication/negotiation.js';
 import { NotificationApi } from '../api/communication/notification.js';
 import { DeveloperApi } from '../api/developer/developer.js';
+import { MediaApi } from '../api/media/media.js';
 import { InventoryApi } from '../api/listing-management/inventory.js';
 import { MetadataApi } from '../api/listing-metadata/metadata.js';
 import { TaxonomyApi } from '../api/listing-metadata/taxonomy.js';
@@ -18,6 +19,7 @@ import { EDeliveryApi } from '../api/other/edelivery.js';
 import { IdentityApi } from '../api/other/identity.js';
 import { TranslationApi } from '../api/other/translation.js';
 import { VeroApi } from '../api/other/vero.js';
+import { BrowseApi } from '../api/browse/browse.js';
 import { TradingApiClient } from '../api/client-trading.js';
 import { TradingApi } from '../api/trading/trading.js';
 export class EbaySellerApi {
@@ -41,7 +43,9 @@ export class EbaySellerApi {
     translation;
     edelivery;
     developer;
+    media;
     trading;
+    browse;
     constructor(config, context) {
         this.client = new EbayApiClient(config, context);
         this.account = new AccountApi(this.client);
@@ -63,8 +67,10 @@ export class EbaySellerApi {
         this.translation = new TranslationApi(this.client);
         this.edelivery = new EDeliveryApi(this.client);
         this.developer = new DeveloperApi(this.client);
+        this.media = new MediaApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
         this.trading = new TradingApi(tradingClient);
+        this.browse = new BrowseApi(this.client);
     }
     async initialize() {
         await this.client.initialize();
@@ -107,3 +113,4 @@ export * from '../api/other/vero.js';
 export * from '../api/developer/developer.js';
 export * from '../api/trading/trading.js';
 export * from '../api/client-trading.js';
+export * from '../api/browse/browse.js';

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

@@ -360,17 +360,15 @@ export class InventoryApi {
         }
     }
     /**
-     * Get all offers
+     * Get offers for a specific SKU (sku is required)
      * @throws Error if parameters are invalid
      */
     async getOffers(sku, marketplaceId, limit) {
         const params = {};
-        if (sku !== undefined) {
-            if (typeof sku !== 'string') {
-                throw new Error('sku must be a string when provided');
-            }
-            params.sku = sku;
+        if (!sku || typeof sku !== 'string') {
+            throw new Error('sku is required for getOffers');
         }
+        params.sku = sku;
         if (marketplaceId !== undefined) {
             if (typeof marketplaceId !== 'string') {
                 throw new Error('marketplaceId must be a string when provided');

package/build/api/media/media.js

@@ -0,0 +1,244 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Commerce Media API (v1_beta) - Upload and manage images via eBay Picture Services
+ * Based on: https://developer.ebay.com/api-docs/commerce/media/resources/image/from_url/methods
+ */
+export class MediaApi {
+    client;
+    basePath = '/commerce/media/v1_beta';
+    constructor(client) {
+        this.client = client;
+    }
+    async getAccessToken() {
+        return await this.client.getOAuthClient().getAccessToken();
+    }
+    getMediaBaseUrl() {
+        const env = this.client.getConfig().environment;
+        return env === 'production' ? 'https://apim.ebay.com' : 'https://apim.sandbox.ebay.com';
+    }
+    /**
+     * Upload an image from a public URL to eBay Picture Services.
+     *
+     * Flow:
+     * 1. Download image from URL
+     * 2. Validate dimensions (min 500px, max 4800px)
+     * 3. Resize if needed (maintain aspect ratio)
+     * 4. Optimize and convert to JPEG
+     * 5. Upload to eBay via multipart/form-data
+     * 6. Return hosted URL
+     *
+     * Supported formats: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP
+     * Max file size: 10MB per image
+     *
+     * @param imageUrl - Public URL of the image to upload
+     * @param description - Optional description for the image
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async createImageFromUrl(imageUrl, description) {
+        if (!imageUrl || typeof imageUrl !== 'string') {
+            throw new Error('imageUrl is required and must be a string');
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            // Try direct createImageFromUrl endpoint first (eBay downloads server-side)
+            // This avoids the need to download+process+upload ourselves
+            const requestBody = { imageUrl };
+            if (description) {
+                requestBody.description = description;
+            }
+            const response = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_url`, requestBody, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                },
+                timeout: 30000,
+            });
+            const data = response.data;
+            const imageId = data.id;
+            if (imageId) {
+                return await this.getImage(imageId);
+            }
+            // Fallback: if no image ID returned, try download+upload method
+            throw new Error('No image ID returned from createImageFromUrl endpoint');
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status;
+                const data = error.response?.data;
+                const message = typeof data === 'object' && data !== null && 'errors' in data
+                    ? data.errors?.[0]?.longMessage ||
+                        data.errors?.[0]?.message ||
+                        error.message
+                    : error.message;
+                throw new Error(`Failed to upload image from URL (status ${status}): ${message}`, {
+                    cause: error,
+                });
+            }
+            throw new Error(`Failed to upload image from URL: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+    /**
+     * Upload an image from a local file to eBay Picture Services.
+     *
+     * Endpoint: POST /commerce/media/v1/image/create_image_from_file
+     * Content-Type: multipart/form-data
+     *
+     * Supported formats: JPG, GIF, PNG, BMP, TIFF, AVIF, HEIC, WEBP
+     * Max file size: 10MB per image
+     *
+     * @param filePath - Local file path of the image to upload
+     * @param description - Optional description for the image
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async createImageFromFile(filePath, description) {
+        if (!filePath || typeof filePath !== 'string') {
+            throw new Error('filePath is required and must be a string');
+        }
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            const fileBuffer = fs.readFileSync(filePath);
+            // Build multipart/form-data body manually
+            const boundary = `----FormBoundary${Date.now()}`;
+            const fileName = path.basename(filePath);
+            // Build the multipart body
+            let body = '';
+            // File part
+            body += `--${boundary}\r\n`;
+            body += `Content-Disposition: form-data; name="imageFile"; filename="${fileName}"\r\n`;
+            body += `Content-Type: application/octet-stream\r\n\r\n`;
+            // Description part (optional)
+            if (description) {
+                body += `--${boundary}\r\n`;
+                body += `Content-Disposition: form-data; name="description"\r\n\r\n`;
+                body += `${description}\r\n`;
+            }
+            body += `--${boundary}--\r\n`;
+            const multipartBody = Buffer.concat([Buffer.from(body, 'utf-8'), Buffer.from(fileBuffer)]);
+            const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_file`, multipartBody, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': `multipart/form-data; boundary=${boundary}`,
+                    Prefer: 'return=representation',
+                },
+                timeout: 30000,
+            });
+            // Extract image ID from response body or Location header
+            const responseData = createResponse.data;
+            const imageId = typeof responseData.id === 'string'
+                ? responseData.id
+                : createResponse.headers.location?.split('/').pop();
+            if (!imageId) {
+                throw new Error('No image ID returned from create endpoint');
+            }
+            // Fetch image details to get the eBay-hosted URL
+            return await this.getImage(imageId);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status;
+                const data = error.response?.data;
+                const message = typeof data === 'object' && data !== null && 'errors' in data
+                    ? data.errors?.[0]?.longMessage ||
+                        data.errors?.[0]?.message ||
+                        error.message
+                    : error.message;
+                throw new Error(`Failed to upload image from file (status ${status}): ${message}`, {
+                    cause: error,
+                });
+            }
+            throw new Error(`Failed to upload image from file: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+    /**
+     * Upload a processed image buffer to eBay Picture Services.
+     *
+     * @param buffer - Processed image buffer
+     * @param metadata - Image metadata
+     * @param token - OAuth access token
+     * @param baseUrl - Media API base URL
+     * @param description - Optional description
+     * @returns Object with image ID and eBay-hosted image URL
+     */
+    async uploadProcessedImage(buffer, metadata, token, baseUrl, description) {
+        // Build multipart/form-data body
+        const boundary = `----FormBoundary${Date.now()}`;
+        const fileName = `image_${Date.now()}.jpg`;
+        let body = `--${boundary}\r\n`;
+        body += `Content-Disposition: form-data; name="imageFile"; filename="${fileName}"\r\n`;
+        body += `Content-Type: image/jpeg\r\n\r\n`;
+        if (description) {
+            body += `--${boundary}\r\n`;
+            body += `Content-Disposition: form-data; name="description"\r\n\r\n`;
+            body += `${description}\r\n`;
+        }
+        body += `--${boundary}--\r\n`;
+        const multipartBody = Buffer.concat([Buffer.from(body, 'utf-8'), buffer]);
+        const createResponse = await axios.post(`${baseUrl}${this.basePath}/image/create_image_from_file`, multipartBody, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+                Prefer: 'return=representation',
+            },
+            timeout: 30000,
+        });
+        const responseData = createResponse.data;
+        const imageId = typeof responseData.id === 'string'
+            ? responseData.id
+            : createResponse.headers.location?.split('/').pop();
+        if (!imageId) {
+            throw new Error('No image ID returned from create endpoint');
+        }
+        return await this.getImage(imageId);
+    }
+    /**
+     * Get image details including the eBay-hosted URL.
+     *
+     * @param imageId - The image ID returned from createImageFromUrl
+     * @returns Image details including hosted URL
+     */
+    async getImage(imageId) {
+        if (!imageId || typeof imageId !== 'string') {
+            throw new Error('imageId is required and must be a string');
+        }
+        const token = await this.getAccessToken();
+        const baseUrl = this.getMediaBaseUrl();
+        try {
+            const response = await axios.get(`${baseUrl}${this.basePath}/image/${imageId}`, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: 'application/json',
+                },
+                timeout: 30000,
+            });
+            const data = response.data;
+            return {
+                id: data.id,
+                imageUrl: data.imageUrl,
+                description: typeof data.description === 'string' ? data.description : undefined,
+            };
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const status = error.response?.status;
+                const data = error.response?.data;
+                const message = typeof data === 'object' && data !== null && 'errors' in data
+                    ? data.errors?.[0]?.longMessage ||
+                        data.errors?.[0]?.message ||
+                        error.message
+                    : error.message;
+                throw new Error(`Failed to get image details (status ${status}): ${message}`, {
+                    cause: error,
+                });
+            }
+            throw new Error(`Failed to get image details: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
+        }
+    }
+}

package/build/api/trading/trading.js

@@ -3,6 +3,14 @@ export class TradingApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Transform an item for Trading API XML serialization.
+     * Ensures required fields like Currency and Country are always present.
+     * Used by publish_offer flow to pre-transform inventory items before publishing.
+     */
+    transformItemForXML(item) {
+        return this.client.transformItemForXML(item);
+    }
     async getActiveListings(page = 1, entriesPerPage = 50) {
         const result = await this.client.execute('GetMyeBaySelling', {
             ActiveList: {
@@ -51,7 +59,8 @@ export class TradingApi {
         return items?.[0] || result;
     }
     async createListing(item) {
-        return await this.client.execute('AddFixedPriceItem', { Item: item });
+        const transformed = this.client.transformItemForXML(item);
+        return await this.client.execute('AddFixedPriceItem', { Item: transformed });
     }
     async reviseListing(itemId, fields) {
         if (!itemId)

package/build/auth/oauth.js

@@ -46,6 +46,7 @@ export class EbayOAuthClient {
                     clientId: this.config.clientId,
                     clientSecret: this.config.clientSecret,
                     redirectUri: this.config.redirectUri,
+                    ruName: this.config.ruName,
                     userAccessToken: tokenData.access_token,
                     userRefreshToken: tokenData.refresh_token || envRefreshToken,
                     tokenType: tokenData.token_type,
@@ -99,6 +100,7 @@ export class EbayOAuthClient {
             clientId: this.config.clientId,
             clientSecret: this.config.clientSecret,
             redirectUri: this.config.redirectUri,
+            ruName: this.config.ruName,
             userAccessToken: accessToken,
             userRefreshToken: refreshToken,
             tokenType: 'Bearer',
@@ -128,8 +130,9 @@ export class EbayOAuthClient {
         return this.appAccessToken;
     }
     async exchangeCodeForToken(code) {
-        if (!this.config.redirectUri) {
-            throw new Error('Redirect URI is required for authorization code exchange');
+        const redirectUriForExchange = this.config.ruName || this.config.redirectUri;
+        if (!redirectUriForExchange) {
+            throw new Error('RuName (EBAY_RUNAME) or redirectUri is required for authorization code exchange');
         }
         const tokenUrl = this.getTokenEndpoint();
         const credentials = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString('base64');
@@ -137,7 +140,7 @@ export class EbayOAuthClient {
             const response = await axios.post(tokenUrl, new URLSearchParams({
                 grant_type: 'authorization_code',
                 code,
-                redirect_uri: this.config.redirectUri,
+                redirect_uri: redirectUriForExchange,
             }).toString(), {
                 headers: {
                     'Content-Type': 'application/x-www-form-urlencoded',
@@ -150,6 +153,7 @@ export class EbayOAuthClient {
                 clientId: this.config.clientId,
                 clientSecret: this.config.clientSecret,
                 redirectUri: this.config.redirectUri,
+                ruName: this.config.ruName,
                 userAccessToken: tokenData.access_token,
                 userRefreshToken: tokenData.refresh_token,
                 tokenType: tokenData.token_type,
@@ -195,6 +199,7 @@ export class EbayOAuthClient {
             clientId: this.config.clientId,
             clientSecret: this.config.clientSecret,
             redirectUri: this.config.redirectUri,
+            ruName: this.config.ruName,
             userAccessToken: tokenData.access_token,
             userRefreshToken: tokenData.refresh_token || this.userTokens.userRefreshToken,
             tokenType: tokenData.token_type,
@@ -215,6 +220,7 @@ export class EbayOAuthClient {
             hasRefreshToken: !!this.userTokens?.userRefreshToken,
             hasAccessToken: !!this.userTokens?.userAccessToken,
             hasRedirectUri: !!this.config.redirectUri,
+            hasRuName: !!this.config.ruName,
             ...(this.userTokens?.userRefreshTokenExpiry
                 ? { refreshTokenExpiry: this.userTokens.userRefreshTokenExpiry }
                 : {}),

package/build/config/environment.js

@@ -268,19 +268,18 @@ export function getEbayConfig(environmentOverride) {
         : process.env.EBAY_SANDBOX_CLIENT_SECRET || process.env.EBAY_CLIENT_SECRET || '';
     // Preferred var is EBAY_RUNAME (clearer naming — it IS the RuName, not a URL).
     // EBAY_REDIRECT_URI is kept for backward compatibility.
+    // RuName is for token exchange; redirectUri is for browser OAuth flow. Separate purposes.
+    const fallbackRuName = environment === 'production'
+        ? process.env.EBAY_PRODUCTION_RUNAME || process.env.EBAY_RUNAME || ''
+        : process.env.EBAY_SANDBOX_RUNAME || process.env.EBAY_RUNAME || '';
     const fallbackRedirectUri = environment === 'production'
-        ? process.env.EBAY_PRODUCTION_RUNAME ||
-            process.env.EBAY_PRODUCTION_REDIRECT_URI ||
-            process.env.EBAY_RUNAME ||
-            process.env.EBAY_REDIRECT_URI
-        : process.env.EBAY_SANDBOX_RUNAME ||
-            process.env.EBAY_SANDBOX_REDIRECT_URI ||
-            process.env.EBAY_RUNAME ||
-            process.env.EBAY_REDIRECT_URI;
+        ? process.env.EBAY_PRODUCTION_REDIRECT_URI || process.env.EBAY_REDIRECT_URI || ''
+        : process.env.EBAY_SANDBOX_REDIRECT_URI || process.env.EBAY_REDIRECT_URI || '';
     return {
         clientId: secretConfig?.clientId || fallbackClientId,
         clientSecret: secretConfig?.clientSecret || fallbackClientSecret,
-        redirectUri: secretConfig?.redirectUri || fallbackRedirectUri,
+        redirectUri: secretConfig?.redirectUri || fallbackRedirectUri || undefined,
+        ruName: secretConfig?.ruName || fallbackRuName || undefined,
         marketplaceId: (process.env.EBAY_MARKETPLACE_ID ?? '').trim() || 'EBAY_US',
         contentLanguage: (process.env.EBAY_CONTENT_LANGUAGE ?? '').trim() || 'en-US',
         environment,

package/build/server-http.js

@@ -745,7 +745,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/authorize] Credential check`, {
                 environment,
                 envSource,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 ruNameDetectedEnv: credCheck.detectedEnv,
                 credentialValid: credCheck.valid,
             });
@@ -770,7 +770,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/authorize] Redirecting to eBay OAuth`, {
                 state: stateRecord.state,
                 environment,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 expectedCallbackUrl: getExpectedOAuthCallbackUrl(serverUrl),
             });
             res.redirect(oauthUrl);
@@ -874,7 +874,7 @@ function mountEnvRouter(hardcodedEnv, serverUrl, iconBaseUrl) {
             serverLogger.info(`[${prefix || 'root'}/oauth/start] Redirecting to eBay OAuth`, {
                 state: stateRecord.state,
                 environment,
-                ruName: ebayConfig.redirectUri,
+                ruName: ebayConfig.ruName || ebayConfig.redirectUri,
                 expectedCallbackUrl: getExpectedOAuthCallbackUrl(serverUrl),
                 returnTo,
             });
@@ -1132,7 +1132,7 @@ async function handleOAuthCallback(req, res, serverUrl) {
             environment,
             tokenBaseUrl: getBaseUrl(environment),
             clientIdPrefix: ebayConfig.clientId ? `${ebayConfig.clientId.slice(0, 12)}...` : '(missing)',
-            ruName: ebayConfig.redirectUri ?? '(missing)',
+            ruName: (ebayConfig.ruName || ebayConfig.redirectUri) ?? '(missing)',
         });
         const userId = randomUUID();
         const api = await createUserScopedApi(userId, environment);

package/build/tools/definitions/browse.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+export const browseTools = [
+    {
+        name: 'ebay_get_suggestions',
+        description: 'Get listing/product suggestions based on search query. Returns relevant item summaries with pricing and shipping info from the eBay Browse API.',
+        inputSchema: {
+            query: z.string().describe('Search query for product suggestions'),
+            marketplaceId: z.string().default('EBAY_US').describe('Marketplace ID (default: EBAY_US)'),
+            limit: z.number().default(20).describe('Number of suggestions to return (default: 20)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Get Suggestions',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+    {
+        name: 'ebay_search_products',
+        description: 'Search the eBay product catalog by query. Supports category filtering, sorting, and price filtering. Uses the eBay Browse API.',
+        inputSchema: {
+            query: z.string().describe('Search query for products'),
+            marketplaceId: z.string().describe('Marketplace ID (e.g., EBAY_US)'),
+            categoryId: z.string().optional().describe('Filter by category ID'),
+            limit: z.number().default(20).describe('Results to return (1-200, default: 20)'),
+            sort: z
+                .enum(['bestMatch', 'newlyListed'])
+                .optional()
+                .describe('Sort order (default: bestMatch)'),
+            filter: z
+                .string()
+                .optional()
+                .describe('Filter expression (e.g., price:[300..800],priceCurrency:USD)'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Search Products',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+    {
+        name: 'ebay_get_item_specifics',
+        description: 'Get required and optional item specifics (aspects) for a given category. Use this to understand what fields are needed for listing in a category. This is an alias to ebay_get_item_aspects_for_category.',
+        inputSchema: {
+            categoryTreeId: z.string().describe('Category tree ID'),
+            categoryId: z.string().describe('Category ID'),
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                success: { type: 'boolean' },
+                data: { type: 'object' },
+            },
+        },
+        annotations: {
+            title: 'Get Item Specifics',
+            readOnlyHint: true,
+        },
+        _meta: {
+            category: 'browse',
+            version: '1.0.0',
+        },
+    },
+];

package/build/tools/definitions/index.js

@@ -18,12 +18,13 @@ import { marketingTools } from './marketing.js';
 import { analyticsTools } from './analytics.js';
 import { metadataTools } from './metadata.js';
 import { taxonomyTools } from './taxonomy.js';
+import { browseTools } from './browse.js';
 import { communicationTools } from './communication.js';
 import { otherApiTools } from './other.js';
 import { developerTools } from './developer.js';
 import { tradingTools } from './trading.js';
 // Export individual categories
-export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, communicationTools, otherApiTools, developerTools, tradingTools, };
+export { tokenManagementTools, accountTools, inventoryTools, fulfillmentTools, marketingTools, analyticsTools, metadataTools, taxonomyTools, browseTools, communicationTools, otherApiTools, developerTools, tradingTools, };
 // Export all tools as a single array
 export const allTools = [
     ...tokenManagementTools,
@@ -34,6 +35,7 @@ export const allTools = [
     ...analyticsTools,
     ...metadataTools,
     ...taxonomyTools,
+    ...browseTools,
     ...communicationTools,
     ...otherApiTools,
     ...developerTools,