Openfoodfacts Tools#

Configuration File: openfoodfacts_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the openfoodfacts_tools.json configuration file.

Available Tools#

OpenFoodFacts_filter_products_by_tags (Type: BaseRESTTool)#

Structured Open Food Facts v2 tag search. Multiple controlled-vocabulary filters combine with AND…

OpenFoodFacts_filter_products_by_tags tool specification

Tool Information:

  • Name: OpenFoodFacts_filter_products_by_tags

  • Type: BaseRESTTool

  • Description: Structured Open Food Facts v2 tag search. Multiple controlled-vocabulary filters combine with AND. Returns one page plus total/continuation metadata; follow metadata.next_page while metadata.has_more is true. Upstream page_count is only the number returned on the current page, not the total page count.

Parameters:

  • additives_tags ([‘string’, ‘null’]) (optional) Filter by food-additive tag, e.g. ‘en:e322’ (lecithin), ‘en:e330’ (citric acid). Find tags via the product profile additives_tags field.

  • allergens_tags ([‘string’, ‘null’]) (optional) Filter by allergen tag, e.g. ‘en:peanuts’, ‘en:milk’, ‘en:gluten’.

  • categories_tags_en ([‘string’, ‘null’]) (optional) Filter by English category name, e.g. ‘Sodas’, ‘Breakfast cereals’, ‘Olive oils’.

  • brands_tags ([‘string’, ‘null’]) (optional) Filter by brand tag, e.g. ‘coca-cola’, ‘nestle’.

  • nutrition_grades_tags ([‘string’, ‘null’]) (optional) Filter by Nutri-Score grade: ‘a’, ‘b’, ‘c’, ‘d’, or ‘e’.

  • labels_tags ([‘string’, ‘null’]) (optional) Filter by label tag, e.g. ‘en:organic’, ‘en:vegan’, ‘en:gluten-free’, ‘en:fair-trade’.

  • countries_tags ([‘string’, ‘null’]) (optional) Filter by country tag, e.g. ‘en:france’, ‘en:united-states’.

  • fields ([‘string’, ‘null’]) (optional) Comma-separated list of product fields to return. Default: product_name,code,brands,categories_tags_en,nutrition_grades,additives_tags,allergens_tags,labels_tags,nutriments

  • page_size (integer) (optional) Number of results per page (1-100). Default: 20

  • page (integer) (optional) Page number for pagination. Default: 1

Example Usage:

query = {
    "name": "OpenFoodFacts_filter_products_by_tags",
    "arguments": {
    }
}
result = tu.run(query)

OpenFoodFacts_get_product (Type: BaseRESTTool)#

Get detailed information about a specific food product by barcode using the Open Food Facts datab…

OpenFoodFacts_get_product tool specification

Tool Information:

  • Name: OpenFoodFacts_get_product

  • Type: BaseRESTTool

  • Description: Get detailed information about a specific food product by barcode using the Open Food Facts database. Returns complete nutritional data, ingredients, allergens, Nutri-Score, eco-score, and product images. No authentication required.

Parameters:

  • barcode (string) (required) Product barcode (EAN-13 or UPC). Examples: ‘3017620422003’ (Nutella 400g), ‘0737628064502’ (Annie Chun’s), ‘8001505005592’

Example Usage:

query = {
    "name": "OpenFoodFacts_get_product",
    "arguments": {
        "barcode": "example_value"
    }
}
result = tu.run(query)

OpenFoodFacts_search_products (Type: BaseRESTTool)#

Search Open Food Facts products by name or brand. Returns one page of product and nutrition data …

OpenFoodFacts_search_products tool specification

Tool Information:

  • Name: OpenFoodFacts_search_products

  • Type: BaseRESTTool

  • Description: Search Open Food Facts products by name or brand. Returns one page of product and nutrition data plus total/continuation metadata. Follow metadata.next_page while metadata.has_more is true. The upstream field page_count means records on the current page, not total pages; use metadata.total_pages instead.

Parameters:

  • search_terms (string) (required) Food product name or brand to search for. Examples: ‘nutella’, ‘coca cola’, ‘oreo’, ‘kelloggs cornflakes’, ‘olive oil’

  • page_size (integer) (optional) Number of results per page (1-100). Defaults to 50, which is what an unparameterised call has always returned from this endpoint – pass a smaller number for a lighter response.

  • page (integer) (optional) Page number for pagination. Default: 1

Example Usage:

query = {
    "name": "OpenFoodFacts_search_products",
    "arguments": {
        "search_terms": "example_value"
    }
}
result = tu.run(query)