Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Openfoodfacts MCP Server

de cyanheadsversión 0.4.4i★ 2iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.cyanheads/openfoodfacts-mcp-server

Cómo instalar

What it does

Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.

  • Connects Computadora o nube
  • Account or key No key needed
  • Category Clínicas y salud

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad22/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso42/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Openfoodfacts MCP Server. Sigue https://mcp.popnx.com/i/cyanheads-openfoodfacts-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (openfoodfacts.caseyjhand.com) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreOpenfoodfacts MCP Server
    Remote MCP server URL · Direcciónhttps://openfoodfacts.caseyjhand.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsOpenfoodfacts MCP Server

  4. Pruébalo

    Usa Openfoodfacts MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Openfoodfacts MCP Server o muestra una herramienta de Openfoodfacts MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreOpenfoodfacts MCP Server
    Connection · Direcciónhttps://openfoodfacts.caseyjhand.com/mcp
  3. Elige Openfoodfacts MCP Server en un chat

    Abre un chat nuevo y elige Openfoodfacts MCP Server en tus plugins antes de escribir

  4. Pruébalo

    Usa Openfoodfacts MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Openfoodfacts MCP Server o muestra una herramienta de Openfoodfacts MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user openfoodfacts https://openfoodfacts.caseyjhand.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Openfoodfacts MCP Server en la lista como conectado

  4. Pruébalo

    Usa Openfoodfacts MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Openfoodfacts MCP Server o muestra una herramienta de Openfoodfacts MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Openfoodfacts MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Openfoodfacts MCP Server o muestra una herramienta de Openfoodfacts MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Openfoodfacts MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Openfoodfacts MCP Server o muestra una herramienta de Openfoodfacts MCP Server en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://openfoodfacts.caseyjhand.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Openfoodfacts MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user openfoodfacts https://openfoodfacts.caseyjhand.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "openfoodfacts": {
      "url": "https://openfoodfacts.caseyjhand.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "openfoodfacts": {
      "type": "http",
      "url": "https://openfoodfacts.caseyjhand.com/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user openfoodfacts -- npx -y @cyanheads/openfoodfacts-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "openfoodfacts": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openfoodfacts-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "openfoodfacts": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openfoodfacts-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "openfoodfacts": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openfoodfacts-mcp-server"
      ]
    }
  }
}

Valores que debes completar

  • OFF_BASE_URL env
    Sustituye la URL base de la API de Open Food Facts. Útil para probar contra un servidor de simulación.
    Ver original en inglésOpen Food Facts API base URL override. Useful for testing against a mock server.
  • OFF_RATE_LIMIT_PRODUCT env
    Límite de velocidad de lectura de productos (solicitudes/min). Coincide con los 15 req/min/IP que Open Food Facts documenta para las lecturas de productos.
    Ver original en inglésProduct read rate limit (requests/min). Matches the 15 req/min/IP Open Food Facts documents for product reads.
  • OFF_RATE_LIMIT_SEARCH env
    Límite de velocidad de búsqueda (solicitudes/min).
    Ver original en inglésSearch rate limit (requests/min).
  • OFF_RATE_LIMIT_TAXONOMY env
    Límite de tasa de resolución de taxonomía (solicitudes/min). Se aplica a las búsquedas en vivo del vocabulario de etiquetas que realiza off_browse_taxonomy, a la resolución de valores de etiquetas en búsquedas de texto y a la comprobación de exclusiones de alérgenos y trazas.
    Ver original en inglésTaxonomy resolution rate limit (requests/min). Applies to the live tag-vocabulary lookups off_browse_taxonomy makes, to tag-value resolution on text searches, and to checking allergen and trace exclu…
  • MCP_LOG_LEVEL env
    Establece el nivel mínimo de registro para la salida (p. ej., 'debug', 'info', 'warn').
    Ver original en inglésSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
764/sem
Licenciai
Apache-2.0
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.4.4
Publicado en el registroi
9 nov 2026
Último cambio de códigoi
13 nov 2026
Última revisión
19 nov 2026
Creador
cyanheads
Paquetes
npm: @cyanheads/openfoodfacts-mcp-server
npm: @cyanheads/openfoodfacts-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 19 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • off_get_product

    Fetch a packaged food product by barcode (4–40 digits: EAN-13, EAN-8, UPC, and the shorter and longer codes Open Food Facts also holds) from Open Food Facts. Returns the product name and generic name, brand, quantity, ingredients (raw text and parsed list), declared allergens, tr

  • off_search_products

    Search Open Food Facts by full-text query, structured tag filters, or both at once. Returns a summary list with barcodes, product names, brands, Nutri-Score, NOVA group, Green-Score, and categories — enough for triage and selection, not full label data. Use off_get_product on the

  • off_compare_products

    Side-by-side nutrition and scoring comparison for 2–10 products per call by barcode; a repeated barcode is compared once, so two identical barcodes yield one row, and barcodes past the 10th distinct one are listed in unprocessed rather than fetched. Returns a normalized table of

  • off_browse_taxonomy

    Resolve a human term to the canonical Open Food Facts tag ID that off_search_products filters on. Covers categories, labels/certifications, allergens, additives, countries, ingredients, NOVA groups, and Nutri-Score grades. Pass a search term to resolve against the Open Food Facts

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub cyanheads, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • ✓ Superada

    El endpoint responde

    Respondió en 502 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 4 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

La dirección en la nube respondió 5 de las últimas 5 comprobaciones · última 502 ms · revisado 19 nov 2026

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @cyanheads/openfoodfacts-mcp-server@0.4.4

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cyanheads-openfoodfacts-mcp-server.svg)](https://mcp.popnx.com/en/servers/cyanheads-openfoodfacts-mcp-server)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Clínicas y saludi

  • Más estrellas que el 88% de los otros 1190 servidores de esta categoría
  • Publicado en el registro más recientemente que el 74% de los otros 1190 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1190 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Openfoodfacts MCP Server?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.4.4) llegó al registro hace 10 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Medplum MCP, Codescene MCP Server, Marrow, WHOOP — MissingMCP, athletedata

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

de medplumMuy usado★ 2,8 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · medplum.com

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

de codescene-ossEn crecimiento↓ 3,8 mil/sem★ 85Actualizado hace 8 meses

Se ejecuta en tu computadora✓ del servicio · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

de skeletonarmytechInicial↓ 62/sem★ 5Actualizado hace 28 días

Se ejecuta en tu computadora✓ skeletonarmy.tech

WHOOP — MissingMCP

WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.

de VelkyVenikInicial★ 21 Estrellas de todo el repositorioActualizado hace 4 meses

Se ejecuta en la nube✓ missingmcp.com

athletedata

Your Garmin, Oura, WHOOP, Hevy and 35 more fitness apps, queryable from your own AI.

de athletedata-healthInicial★ 3Actualizado hace 28 días

Se ejecuta en la nube✓ del servicio · athletedata.health
Comparado con otros parecidos
Este
Openfoodfacts MCP Server
Medplum MCPCodescene MCP ServerMarrowWHOOP — MissingMCPathletedata
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas5/54/42/33/32/44/4
LicenciaApache-2.0Apache-2.0NOASSERTIONMITMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@cyanheads/openfoodfacts-mcp-server Look up food products by barcode, search by keyword, tag, allergen, or nutrition filter, compare products side-by-side, and browse the canonical tag vocabulary via MCP. STDIO or Streamable HTTP. 4 Tools

Public Hosted Server: https://openfoodfacts.caseyjhand.com/mcp


Overview

Packaged-food data from Open Food Facts, a crowd-sourced database of 3M+ products. Look up items by barcode, search by text, tags, allergens, and nutrient thresholds, compare products side by side, and resolve everyday terms to the canonical tags the filters take.

Tools
ToolDescription
off_get_productFetch one product by barcode: ingredients, allergens and traces, additives, scores, nutrition, and tags
off_search_productsSearch by text, tag filters, allergen exclusions, and nutrient thresholds (per 100 g, or per 100 ml for liquids); returns summary rows with barcodes
off_compare_productsCompare up to 10 products per call by barcode on nutrition (per 100 g, or per 100 ml for liquids), Nutri-Score, NOVA, and Green-Score
off_browse_taxonomyResolve a human term to the canonical tag ID that off_search_products filters on
Skills
SkillDescription
openfoodfacts-guideJudgment for calling the tools: allergy checks that never overclaim, choosing among a product's barcodes, where tag IDs come from, grade ranges, free-from searches, and the shared search budget. Served over MCP as skill://openfoodfacts-guide/SKILL.md and shipped in the plugin, npm package, and .mcpb bundle.

Capability reference

off_get_product tool
  • barcode is digits only, 4–40 digits after any leading zeros; optional fields trims the response and pulls in what a field depends on (nutriments brings the serving size, quantity, and unit, and serving_quantity and serving_quantity_unit each bring the other plus the serving size), with requested_fields echoing what was fetched
  • Returns product_name and generic_name (what the product is, in its main language), ingredients (raw text plus a parsed tree up to three levels deep with percent_estimate), allergens_tags, traces_tags, additives_tags, ingredients_analysis_tags (vegan, vegetarian, palm-oil verdicts), nutriscore_grade, nova_group, ecoscore_grade (Green-Score), nutrient_levels (Open Food Facts' low, moderate, or high for fat, saturated fat, sugars, and salt, with a basis of as_sold or prepared naming the figures it judged; fields: ["nutrient_levels"] brings nutriments for that reason), nutriments (per serving, and per 100 g, or per 100 ml for liquids), category/label/packaging/origin/country tags, image_url, and completeness (0–1)
  • traces_tags: ["en:none"] means the label states no traces, while an empty array means none entered yet; a barcode no contributor has recorded fails as not_found
  • Open Food Facts returns one preparation state of the nutrition per read. A read of prepared-product figures puts them under keys ending in _prepared in additional_100g and additional_serving, and prints them in "as prepared" sections. When a read returns only prepared figures, one more product read fetches the single as-sold set the record stores (/api/v3.5 fields=nutrition.input_sets) and fills the named as-sold fields per 100 g, or per 100 ml for liquids, with no as-sold per-serving figure; nutriments.stored_as_sold reports read, none (the record stores no usable set), or unread with a reason, an error, and, when the failure named a wait, retryAfter in whole seconds (the call itself still succeeds). Other reads send nothing extra
  • source (off_api or off_mirror) names where the product was read; a barcode a local mirror holds is read from it with no upstream request, with mirror_as_of (the time up to which the copy reflects every product contributed or edited on Open Food Facts) and a mirror_snapshot note, and the stored as-sold set comes from the same stored record

off_search_products tool
  • query (up to 24 words, all of which must match the name, generic name, categories, labels, or brand; punctuation separates words, so milk-chocolate requires both) plus the tag filters categories_tag, brands_tag, labels_tag (up to 10), allergens_tag, traces_tag, ingredients_analysis_tag, ingredients_tag (up to 10, all of which must appear), additives_tag, nutrition_grade, nova_group, ecoscore_grade (Green-Score), countries_tag, the exclude_allergens / exclude_traces lists (up to 14 each), and up to 18 nutrient_filters (per 100 g, or per 100 ml for liquids), all combined as AND; optional sort_by
  • nutrition_grade, nova_group, and ecoscore_grade each take one grade or an array matching any of them (["a", "b"] for Nutri-Score B or better), where a labels_tag array requires all of its values; ecoscore_grade a excludes a-plus. A grade filter never changes which backend answers; on a text search it matches the grades the index holds, which each row shows. A tag-only ecoscore_grade search matches the grade Open Food Facts files for France, while each row shows the world grade
  • page_size defaults to 20 and is served at up to 100 per call; a larger value, with no ceiling, is served at 100 and flagged in page_size_capped, and page counts pages of 100. Rows carry barcode, product_name, brands, nutriscore_grade, nova_group, ecoscore_grade, and categories_tags, plus total, total_is_lower_bound, last_page, omitted, and truncated (more matches beyond this page). Exclusions add exclusion_coverage, since products with no allergen data entered pass them; nutrient_filters add indexed_nutriments (the index values the filters checked, which can differ from off_get_product)
  • The text index compares energy-kcal, fat, saturated-fat, carbohydrates, and sugars as whole numbers (sugars lte 3 returns a row at 3.53). A nutrient_filters search sends gt and gte on those five as [floor(value) TO *] so no match is lost, then checks every returned row against every constraint at the index's 32-bit precision. Rows that fail leave the page and count in outside_constraints, so a page can come back short or empty while later pages hold matches. total, total_is_lower_bound, and last_page describe the index's whole-number answer and still count those rows. A range inside one whole number (sugars gt 3.9 and lt 4) can pass few of the 10,000 reachable rows; add query or tag filters to narrow it
  • ingredients_tag takes canonical ingredient IDs (en:inulin; resolve one with off_browse_taxonomy facet ingredients, where IDs are singular), and each parsed ingredient also carries its taxonomy parents, so en:vegetable matches a product listing carrot. It is answered only by the text index, with or without query, since the mirror indexes no ingredients and the live tag path stops at page 10
  • query, nutrient_filters, or ingredients_tag searches a text index that lags the live database (flagged in text_index_snapshot), reaches only the first 10,000 results, and rejects additives_tag as additives_filter_needs_tag_search; tag-only searches read the live database through page 10, unless a local mirror serves them: with every tag value confirmed, a mirror-served search has an exact total and reaches its first 10,000 results, and one carrying ecoscore_grade is served only once a full reload of the mirror has indexed Green-Score. A page past any of these limits fails as page_out_of_range
  • source (off_api or off_mirror) names where the answer was read; from the mirror it also carries mirror_as_of and a mirror_snapshot note, and the default order and sort_by popularity_key and unique_scans_n follow the values stored with each record, which can differ from a live search, which ranks by its current scan counts

off_compare_products tool
  • 2–100 barcodes, one row each in input order; repeated barcodes are compared once, and those past the 10th distinct one are listed in unprocessed without being fetched
  • Rows carry found, nutriscore_grade, nova_group, ecoscore_grade, energy, fat, saturated fat, carbohydrates, sugars, salt, protein, and fiber (per 100 g, or per 100 ml for liquids), and completeness; missing values stay absent, never imputed
  • A read of prepared-product figures adds a prepared object on the row with the same columns, read from the *_prepared_100g keys and never substituted for an as-sold figure. A row whose read returned only prepared figures gets the same stored as-sold read as off_get_product, once every barcode's product read has settled, and reports it as stored_as_sold (read, none, or unread, which never moves the barcode into failed). A row with as-sold figures appears in the as-sold table, a row with prepared in the "as prepared" table, and a row with both appears in both
  • Each row carries source (off_api or off_mirror), and mirror_as_of for a row read from a local mirror, so one comparison can mix the two; a mirror_snapshot note appears when any row came from it
  • not_found lists barcodes with no contributor record and failed lists fetches that failed, each with a reason and, when the failure named a wait, retryAfter in whole seconds; a failed barcode gets no row and never blocks the rest

off_browse_taxonomy tool
  • facet is one of categories, labels, allergens, additives, countries, ingredients, nova_groups, nutrition_grades; search matches a substring of the tag ID, name, or a synonym ("shel

Solo se muestra el principio; lee el resto en el repo