Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Openfoodfacts MCP Server

von cyanheadsVersion 0.4.4i★ 2iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.cyanheads/openfoodfacts-mcp-server

So installierst du es

What it does

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

  • Connects Computer oder Cloud
  • Account or key No key needed
  • Category Praxen & Gesundheit

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit22/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert42/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Openfoodfacts MCP Server. Folge https://mcp.popnx.com/i/cyanheads-openfoodfacts-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (openfoodfacts.caseyjhand.com) · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameOpenfoodfacts MCP Server
    Remote MCP server URL · Adressehttps://openfoodfacts.caseyjhand.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsOpenfoodfacts MCP Server

  4. Ausprobieren

    Nutze Openfoodfacts MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Openfoodfacts MCP Server nutzt, oder ein Werkzeug von Openfoodfacts MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameOpenfoodfacts MCP Server
    Connection · Adressehttps://openfoodfacts.caseyjhand.com/mcp
  3. Openfoodfacts MCP Server im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Openfoodfacts MCP Server aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Openfoodfacts MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Openfoodfacts MCP Server nutzt, oder ein Werkzeug von Openfoodfacts MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

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

    Openfoodfacts MCP Server sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Openfoodfacts MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Openfoodfacts MCP Server nutzt, oder ein Werkzeug von Openfoodfacts MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Openfoodfacts MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Openfoodfacts MCP Server nutzt, oder ein Werkzeug von Openfoodfacts MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Openfoodfacts MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Openfoodfacts MCP Server nutzt, oder ein Werkzeug von Openfoodfacts MCP Server in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://openfoodfacts.caseyjhand.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Openfoodfacts MCP Server nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
    }
  }
}

Auf deinem Computer installiert

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"
      ]
    }
  }
}

Werte, die du selbst einträgst

  • OFF_BASE_URL env
    Überschreibt die Basis-URL der Open-Food-Facts-API. Nützlich für Tests gegen einen Mock-Server.
    Englisches Original anzeigenOpen Food Facts API base URL override. Useful for testing against a mock server.
  • OFF_RATE_LIMIT_PRODUCT env
    Leselimit für Produkte (Anfragen/Min.). Entspricht den 15 Anfragen/Min./IP, die Open Food Facts für Produktabfragen dokumentiert.
    Englisches Original anzeigenProduct read rate limit (requests/min). Matches the 15 req/min/IP Open Food Facts documents for product reads.
  • OFF_RATE_LIMIT_SEARCH env
    Suchratenlimit (Anfragen/Minute).
    Englisches Original anzeigenSearch rate limit (requests/min).
  • OFF_RATE_LIMIT_TAXONOMY env
    Ratenlimit für die Auflösung der Taxonomie (Anfragen/Min.). Gilt für die Live-Abfragen des Tag-Vokabulars durch off_browse_taxonomy, für die Auflösung von Tag-Werten bei Textsuchen sowie für die Prüfung von Allergen- und Spurenausschlüssen.
    Englisches Original anzeigenTaxonomy 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
    Legt die minimale Protokollstufe für die Ausgabe fest (z. B. 'debug', 'info', 'warn').
    Englisches Original anzeigenSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
764/Wo.
Lizenzi
Apache-2.0
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.4.4
In der Registry veröffentlichti
9. Nov. 2026
Code zuletzt geänderti
13. Nov. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
cyanheads
Pakete
npm: @cyanheads/openfoodfacts-mcp-server
npm: @cyanheads/openfoodfacts-mcp-server
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 19. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto cyanheads bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 6 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 502 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 4 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Die Cloud-Adresse hat bei 5 der letzten 5 Prüfungen geantwortet · zuletzt 502 ms · geprüft 19. Nov. 2026

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @cyanheads/openfoodfacts-mcp-server@0.4.4

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Praxen & Gesundheiti

  • Mehr Sterne als 88 % der anderen 1190 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 74 % der anderen 1190 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1190 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Openfoodfacts MCP Server sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.4.4) kam vor 10 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

von medplumWeit verbreitet★ 2804Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

von thetahealthWachsend↓ 725/Wo.★ 1581Aktualisiert vor 9 Tagen

Läuft auf deinem Computer✓ thetahealth.ai

Marrow

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

von skeletonarmytechAm Anfang↓ 62/Wo.★ 5Aktualisiert vor 28 Tagen

Läuft auf deinem Computer✓ skeletonarmy.tech

WHOOP — MissingMCP

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

von VelkyVenikAm Anfang★ 21 Sterne des ganzen ReposAktualisiert vor 4 Monaten

Läuft in der Cloud✓ missingmcp.com
Im Vergleich mit ähnlichen
Dieser
Openfoodfacts MCP Server
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertWird auf deinem Rechner installiertWird auf deinem Rechner installiertLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/54/43/32/33/32/4
LizenzApache-2.0Apache-2.0Apache-2.0NOASSERTIONMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@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

Nur der Anfang wird gezeigt; den Rest findest du im Repo