E-commerce
Mercado Livre en tu producto y en tus agentes de IA, con una API
El toolkit de Mercado Livre cubre la cuenta del vendedor, búsqueda y detalles de anuncios, predicción de categoría y atributos, creación y actualización de anuncios y descripciones, pedidos y preguntas de compradores. Tu cliente conecta su cuenta de vendedor una vez con OAuth, y tu producto o agente de IA ejecuta cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/mercado_livre_create_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"family_name": "<family_name>",
"category_id": "<category_id>",
"price": 1,
"currency_id": "<currency_id>",
"available_quantity": 1,
"buying_mode": "buy_it_now",
"listing_type_id": "<listing_type_id>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Mercado Livre.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Mercado Livre. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Mercado Livre.
Publica anuncios desde tu catálogo
Predice la categoría a partir de un título, lee los atributos obligatorios y crea el ítem y su descripción con los datos de tu propio producto.
Sincroniza pedidos y stock
Busca los pedidos del vendedor y lee cada venta con ítems, pagos e id de envío para alimentar tu ERP o flujo de despacho.
Agente responde preguntas de compradores
Un agente de IA lista las preguntas sin responder en los anuncios del vendedor y publica la respuesta con Responder pregunta.
Tools
14 tools de Mercado Livre
- Obtener usuario actualGETDevuelve la cuenta de vendedor conectada: id, nickname, email, site_id y reputación del vendedor. El id es el user_id, seller y seller_id de las demás herramientas, y el site_id (MLB en Brasil) va en Buscar categorías.
- Buscar anunciosGETLista los ids de los anuncios del vendedor, 50 por página por defecto. results tiene solo ids de anuncios: Listar anuncios devuelve sus detalles. Pagina con offset y limit; pasados 1000 resultados usa search_type scan y el scroll_id de cada respuesta.
- Listar anunciosGETDevuelve hasta 20 anuncios por id en una llamada: título, precio, available_quantity, sold_quantity, status, permalink, imágenes y atributos. Cada elemento tiene status_code, id y el anuncio en body.
- Buscar categoríasGETPredice la categoría de un producto a partir del título, con el dominio y los atributos reconocidos en el texto. El primer resultado es el más probable. Su category_id va en Crear anuncio y en Listar atributos de la categoría.
- Listar atributos de la categoríaGETLista los atributos de una categoría con id, value_type, valores aceptados y tags. Los atributos con la tag required deben enviarse en Crear anuncio, y los new_required cuando el ítem es nuevo.
- Crear anuncioPOSTPublica un anuncio y lo devuelve con su id. En el modelo User Products, activo para todos los vendedores, envía family_name y ningún title: Mercado Livre arma el título. La descripción se agrega después con Crear descripción del anuncio.
- Actualizar anuncioPUTCambia un anuncio y lo devuelve. Solo cambian los campos enviados. status paused lo oculta, active lo reactiva y closed lo termina para siempre. title y family_name solo cambian mientras el anuncio no tiene ventas.
- Obtener descripción del anuncioGETDevuelve la descripción de un anuncio en plain_text, con date_created y last_updated.
- Crear descripción del anuncioPOSTAgrega la descripción a un anuncio que no tiene una, como uno recién creado con Crear anuncio. Falla con 400 cuando ya existe una descripción: usa Actualizar descripción del anuncio.
- Actualizar descripción del anuncioPUTReemplaza la descripción de un anuncio que ya tiene una.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/mercado_livre, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Mercado Livre
¿Necesito implementar la API de Mercado Livre?
No. Connect ya trae 14 tools de Mercado Livre descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Mercado Livre?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
