Cómo conectar GTIN Barcode Lookup a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → GTIN / Barcode Lookup, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

GTIN Barcode Lookup + Gemini

Haz que tu IA convierta un código de barras en datos de producto: consulta alimentos y bebidas, artículos de comercio general, cosmética y libros por EAN, UPC o ISBN, o busca por nombre o marca para encontrar el GTIN de un producto. Lee bases de datos públicas y gratuitas (Open Food Facts, UPCitemdb, Open Beauty Facts, Google Books), sin cuenta y sin clave de API.

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:

(ninguna: datos públicos, sin clave de API)

Paso 1 — Obtener credenciales

1. En la tienda de conectores, elige GTIN / Barcode Lookup e instálalo. No hay nada que pegar: todas las fuentes son bases de datos públicas que no necesitan cuenta ni clave de API, y no hay paso Authorize with Provider.
2. Prueba con un código que conozcas: pide a la IA que ejecute gtin_lookup_food con 3017620422003 (un tarro de Nutella). Devuelve el nombre del producto, la marca, la cantidad, las categorías, el Nutri-Score y un enlace a la imagen.
3. A partir de ahí la IA usa la herramienta que corresponde al producto: gtin_lookup_retail para electrónica, artículos del hogar, juguetes y herramientas, gtin_lookup_beauty para cosmética y cuidado personal, gtin_lookup_book para libros.

Qué cubre cada base de datos: gtin_lookup_food y gtin_lookup_search_food leen Open Food Facts (alimentos, bebidas y bienes de consumo envasados; millones de productos, multilingüe, con marca, categorías, cantidad, sellos, Nutri-Score, ingredientes e imagen). gtin_lookup_retail y gtin_lookup_search_retail leen UPCitemdb (electrónica, hogar, juguetes, herramientas y otros artículos de comercio, con título, descripción, marca, modelo, imágenes y ofertas conocidas en marketplaces). gtin_lookup_beauty lee Open Beauty Facts (cosmética y cuidado personal, con ingredientes y el periodo después de abrir). gtin_lookup_book lee Google Books (título, autores, editorial, fecha de publicación, descripción y portada). Cada base de datos conoce productos distintos: si una no encuentra nada, la IA prueba la siguiente.

De un nombre a un código de barras: gtin_lookup_search_food busca por nombre de producto o marca (10 resultados por defecto, hasta 50) y gtin_lookup_search_retail por palabra clave. Ambas devuelven el código de barras de cada resultado, así pasas de una descripción al GTIN.

Formatos y dígito de control: pasa el código de barras como dígitos y conserva los ceros iniciales. El EAN-13 (GTIN-13) tiene 13 dígitos, el UPC-A tiene 12, y un UPC-A también se encuentra como su GTIN-13 con un 0 delante. El GTIN de un libro es su ISBN-13, el número de 13 dígitos que empieza por 978 o 979 impreso junto al código de barras en la contraportada, y es lo que espera gtin_lookup_book. Los libros más antiguos a menudo solo llevan un ISBN de 10 dígitos: su ISBN-13 es 978, luego los nueve primeros dígitos y luego un dígito de control recalculado. El último dígito de todo GTIN e ISBN-13 es un dígito de control calculado a partir de los demás, así que un solo dígito mal escrito da un código que no existe, no un producto distinto.

Cuando no se encuentra un código: Open Food Facts y Open Beauty Facts responden con status 0, UPCitemdb con un array items vacío. Solo significa que esa base de datos no conoce el producto: la IA prueba entonces la herramienta de otro tipo de producto o busca por nombre y marca. Open Food Facts y Open Beauty Facts los completan voluntarios, así que faltan algunos productos y algunos campos están vacíos.

Límites de peticiones: estas fuentes gratuitas limitan las peticiones por dirección IP. El nivel de prueba gratuito de UPCitemdb permite unas 100 peticiones al día por IP, Google Books tiene una cuota anónima compartida y Open Food Facts pide mantener la carga baja. Cuando se agota el límite diario de UPCitemdb, las herramientas de comercio fallan hasta el día siguiente; las consultas de alimentos, cosmética y libros no se ven afectadas. Cada herramienta pasa por el proxy de la instancia cuando hay uno configurado, lo que reparte la carga y evita bloqueos de IP. Consulta los códigos de uno en uno y reutiliza los resultados en lugar de pedir el mismo código otra vez.

Solo lectura: las seis herramientas solo leen. Lo único que se envía a las bases de datos es el código de barras o el término de búsqueda.

El conector no añade ni edita productos en estas bases de datos, no crea códigos de barras y no descifra imágenes de códigos de barras: trabaja con los dígitos del código.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de GTIN Barcode Lookup.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué producto tiene el código de barras 3017620422003? Dime la marca, la cantidad, el Nutri-Score y los ingredientes principales."
• "Encuentra el código de barras de la Coca-Cola Zero en botella de 1,5 litros."
• "Busca el libro con ISBN 9780141036144: título, autor, editorial y año de publicación."
• "El albarán de nuestro proveedor trae los códigos 4006381333931, 5449000000996 y 012345678905. ¿Qué productos son y cuáles no has podido encontrar?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse