agent: add adapter for Mercado Libre

Author: alectimison-maker

src/chrome/src/agent/adapters.js

@@ -16279,6 +16279,22 @@ const ADAPTERS = [
 - Pre-orders / "Made to order" listings have a longer ship date — surface that to the user before buying.`,
   },
 
+  // ─── Regional — Mercado Libre / Mercado Livre (LATAM) ────────────────
+  // Start with the AR, MX, and BR storefronts requested in CONTRIBUTING.md.
+  // Other country sites need separate localization research before inclusion.
+  {
+    name: 'mercado-libre',
+    category: 'general',
+    matches: (url) => /^https?:\/\/(?:[a-z0-9-]+\.)*(?:mercadolibre\.com\.(?:ar|mx)|mercadolivre\.com\.br)\//.test(url),
+    notes: `
+- Mercado Libre/Livre is a multi-seller MARKETPLACE with localized UI. Argentina/Mexico use Spanish labels such as "Comprar ahora", "Agregar al carrito", and "Otras opciones de compra"; Brazil uses "Comprar agora", "Adicionar ao carrinho", and "Outras opções de compra". Follow the labels for the current country — do not mix the Spanish and Portuguese flows.
+- Catalog product pages can group the same product from many sellers. The main buy box represents ONE seller/offer, while "Otras opciones de compra"/"Outras opções de compra" may have a different price, seller reputation, shipping cost, or arrival date. Compare the active offer before quoting or adding it.
+- Variant trap: choose required color, size ("talle"/"talla"/"tamanho"), capacity, voltage, flavor, or other variation BEFORE adding. A variation can change stock, seller, price, and delivery; read back the selected variation from the product page or cart.
+- LOCATION-FIRST shipping: set the destination postal code ("código postal" in AR/MX, "CEP" in BR) before promising availability, freight, free shipping, pickup, or an arrival date. Re-check these in the cart because they depend on both destination and seller.
+- Displayed discounts and installment amounts ("cuotas"/"parcelas") may depend on the payment method, and the listing price can exclude shipping. Use "Agregar/Adicionar ao carrito" when choices still need review; verify seller, variations, quantity, shipping, and the final payable total before any consequential "Comprar ahora/agora" action.
+- Search/result hosts such as listado.mercadolibre.com.ar, listado.mercadolibre.com.mx, and lista.mercadolivre.com.br may redirect automation to /gz/account-verification. If that verification wall appears, STOP and ask the user to complete it manually; do not retry, bypass it, or claim that results were inspected.`,
+  },
+
   // ─── Regional — Türkiye (TR) ──────────────────────────────────────────
   // Regional adapters are the project's #1 wanted contribution (CONTRIBUTING.md);
   // Türkiye is top of the priority list. Add more TR sites (trendyol,

src/firefox/src/agent/adapters.js

@@ -16277,6 +16277,22 @@ const ADAPTERS = [
 - Pre-orders / "Made to order" listings have a longer ship date — surface that to the user before buying.`,
   },
 
+  // ─── Regional — Mercado Libre / Mercado Livre (LATAM) ────────────────
+  // Start with the AR, MX, and BR storefronts requested in CONTRIBUTING.md.
+  // Other country sites need separate localization research before inclusion.
+  {
+    name: 'mercado-libre',
+    category: 'general',
+    matches: (url) => /^https?:\/\/(?:[a-z0-9-]+\.)*(?:mercadolibre\.com\.(?:ar|mx)|mercadolivre\.com\.br)\//.test(url),
+    notes: `
+- Mercado Libre/Livre is a multi-seller MARKETPLACE with localized UI. Argentina/Mexico use Spanish labels such as "Comprar ahora", "Agregar al carrito", and "Otras opciones de compra"; Brazil uses "Comprar agora", "Adicionar ao carrinho", and "Outras opções de compra". Follow the labels for the current country — do not mix the Spanish and Portuguese flows.
+- Catalog product pages can group the same product from many sellers. The main buy box represents ONE seller/offer, while "Otras opciones de compra"/"Outras opções de compra" may have a different price, seller reputation, shipping cost, or arrival date. Compare the active offer before quoting or adding it.
+- Variant trap: choose required color, size ("talle"/"talla"/"tamanho"), capacity, voltage, flavor, or other variation BEFORE adding. A variation can change stock, seller, price, and delivery; read back the selected variation from the product page or cart.
+- LOCATION-FIRST shipping: set the destination postal code ("código postal" in AR/MX, "CEP" in BR) before promising availability, freight, free shipping, pickup, or an arrival date. Re-check these in the cart because they depend on both destination and seller.
+- Displayed discounts and installment amounts ("cuotas"/"parcelas") may depend on the payment method, and the listing price can exclude shipping. Use "Agregar/Adicionar ao carrito" when choices still need review; verify seller, variations, quantity, shipping, and the final payable total before any consequential "Comprar ahora/agora" action.
+- Search/result hosts such as listado.mercadolibre.com.ar, listado.mercadolibre.com.mx, and lista.mercadolivre.com.br may redirect automation to /gz/account-verification. If that verification wall appears, STOP and ask the user to complete it manually; do not retry, bypass it, or claim that results were inspected.`,
+  },
+
   // ─── Regional — Türkiye (TR) ──────────────────────────────────────────
   // Regional adapters are the project's #1 wanted contribution (CONTRIBUTING.md);
   // Türkiye is top of the priority list. Add more TR sites (trendyol,

test/run.js

@@ -2387,6 +2387,46 @@ test('matches apple store pages', () => {
   assert.equal(getActiveAdapter('https://secure.store.apple.com/shop/checkout')?.name, 'apple');
 });
 
+test('matches Mercado Libre LATAM storefronts and includes marketplace guidance', () => {
+  const trustedUrls = [
+    'https://mercadolibre.com.ar/',
+    'https://www.mercadolibre.com.ar/notebook/p/MLA123',
+    'https://listado.mercadolibre.com.ar/notebook',
+    'https://articulo.mercadolibre.com.ar/MLA-123-notebook-_JM',
+    'https://www.mercadolibre.com.mx/notebook/p/MLM123',
+    'https://listado.mercadolibre.com.mx/notebook',
+    'https://mercadolivre.com.br/',
+    'https://www.mercadolivre.com.br/notebook/p/MLB123',
+    'https://lista.mercadolivre.com.br/notebook',
+    'https://produto.mercadolivre.com.br/MLB-123-notebook-_JM',
+  ];
+  for (const url of trustedUrls) {
+    assert.equal(getActiveAdapter(url)?.name, 'mercado-libre');
+    assert.equal(getActiveAdapterFx(url)?.name, 'mercado-libre');
+  }
+
+  const rejectedUrls = [
+    'https://mercadolibre.com.ar.phishing.example/notebook',
+    'https://mercadolivre.com.br.evil.example/notebook',
+    'https://example.com/mercadolibre.com.mx/notebook',
+    // Other country storefronts need their own localized research before inclusion.
+    'https://www.mercadolibre.cl/notebook',
+  ];
+  for (const url of rejectedUrls) {
+    assert.notEqual(getActiveAdapter(url)?.name, 'mercado-libre');
+    assert.notEqual(getActiveAdapterFx(url)?.name, 'mercado-libre');
+  }
+
+  const adapter = getActiveAdapter('https://www.mercadolibre.com.mx/notebook/p/MLM123');
+  const firefoxAdapter = getActiveAdapterFx('https://www.mercadolivre.com.br/notebook/p/MLB123');
+  assert.match(adapter?.notes || '', /MARKETPLACE/);
+  assert.match(adapter?.notes || '', /Otras opciones de compra/);
+  assert.match(adapter?.notes || '', /Outras opções de compra/);
+  assert.match(adapter?.notes || '', /CEP/);
+  assert.match(adapter?.notes || '', /account-verification/);
+  assert.equal(firefoxAdapter?.notes, adapter?.notes);
+});
+
 test('matches sahibinden.com and includes anti-bot guidance', () => {
   assert.equal(getActiveAdapter('https://www.sahibinden.com/')?.name, 'sahibinden');
   assert.equal(getActiveAdapter('https://sahibinden.com/kategori/vasita')?.name, 'sahibinden');