Cómo conectar eBay Browse (product search) a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → eBay Browse (product search), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

eBay Browse (product search) + Cursor

Busca anuncios activos de eBay y lee los detalles de los artículos con la Browse API de eBay: precios, estado, vendedor, envío y características del artículo, por palabra clave, categoría, GTIN o id de producto. Datos públicos del marketplace con un token de aplicación, sin necesidad de cuenta de vendedor.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_MARKETPLACE_ID

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta gratuita de desarrollador de eBay con un keyset de production; no hace falta cuenta de vendedor en eBay ni iniciar sesión.

1. Inicia sesión en developer.ebay.com, abre Application Keys y crea un keyset de production (no sandbox).
2. Copia el App ID (Client ID) en EBAY_CLIENT_ID y el Cert ID (Client Secret) del mismo keyset en EBAY_CLIENT_SECRET.
3. Pon en EBAY_MARKETPLACE_ID el sitio de eBay donde quieres buscar, por ejemplo EBAY_ES, EBAY_US o EBAY_DE. AnythingMCP obtiene un token de aplicación con el flujo client credentials de eBay y lo renueva solo cada dos horas.
4. Instala el conector y ejecuta ebay_browse_search_items con la palabra clave book y un límite de 1: devuelve un anuncio activo de tu marketplace.

Solo el lado comprador: este conector busca y lee anuncios públicos tal como los ve un comprador. Vender (tus pedidos, tu inventario, tus ofertas) es cosa del conector aparte eBay Sell, que necesita el token de usuario de un vendedor. Puedes instalar los dos a la vez.

Qué lee: anuncios activos del marketplace configurado, encontrados por palabra clave, categoría, GTIN (EAN, UPC o ISBN) o id de producto de eBay (ePID), cada uno con título, precio, estado, nombre y valoraciones del vendedor, opciones de envío, formatos de compra (Cómpralo ya, subasta, mejor oferta), ubicación del artículo y enlace al anuncio. De un anuncio concreto lee la descripción completa, la descripción del estado, las características del artículo, marca, MPN y GTIN, imágenes, condiciones de envío y devolución, cantidad disponible y entrega estimada.

Números de artículo y variantes: pega el número del enlace de un anuncio (ebay.es/itm/123456789012) y la IA lo abre con ebay_browse_get_item_by_legacy_id. Un anuncio con tallas o colores es un grupo de artículos: ebay_browse_get_item_group devuelve cada variante con su propio precio y disponibilidad.

Buscar y filtrar: una búsqueda necesita al menos una palabra clave, una categoría, un GTIN o un ePID. La IA la acota con filtros como price:[10..50],priceCurrency:EUR, conditions:{NEW}, buyingOptions:{FIXED_PRICE} o itemLocationCountry:ES, y ordena por precio, recién publicados o próximos a terminar (si no, por relevancia). Filtrar por características del artículo, como el color, necesita además una categoría.

Los precios cambian sin parar: los precios son cadenas con moneda, en la moneda del marketplace salvo que el vendedor publique en otra. Precio y disponibilidad cambian constantemente, así que la IA los da siempre con la hora de la consulta.

Solo lectura: no hay ninguna herramienta de escritura. El conector no compra, no puja, no hace ofertas ni cambia nada en eBay, así que no hay nada que confirmar.

Límites: un keyset de aplicación empieza con 5.000 llamadas Browse al día. Una página trae hasta 200 artículos y la paginación se detiene en 10.000 resultados (offset más limit), así que en búsquedas amplias la IA acota con filtros en lugar de recorrerlo todo.

Errores frecuentes: si eBay rechaza el App ID o el Cert ID, seguramente pegaste claves de sandbox: usa las de un keyset de production. Una búsqueda sin palabra clave, categoría, GTIN ni ePID se rechaza. EBAY_MARKETPLACE_ID debe tener la forma de EBAY_ES, con el prefijo EBAY_.

El conector no compra ni puja, no inicia sesión en ninguna cuenta de eBay, no busca anuncios terminados o vendidos y no gestiona tus propios anuncios, pedidos o inventario (para eso está el conector eBay Sell).

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de eBay Browse (product search).

Herramientas disponibles

Ejemplos de prompts

• "Búscame en eBay un LEGO Technic 42115 por menos de 300 euros, solo Cómpralo ya, desde España y ordenado por precio."
• "¿Qué dice el anuncio de eBay 123456789012 sobre el estado, los gastos de envío y las devoluciones?"
• "Busca en eBay el EAN 4006381333931 y enséñame las ofertas nuevas más baratas con el envío incluido."
• "¿Qué tallas y colores del anuncio de eBay 123456789012 siguen disponibles y cuánto cuesta cada uno?"
• "¿Cuánto piden ahora los vendedores en eBay por un iPhone 15 de 128 GB usado? Dame el precio más bajo, el habitual y el más alto."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT