ClawHub

Open Food Facts API

v1.0.0

Interact with the Open Food Facts API to search for packaged food products by barcode and retrieve nutritional information. Use when the user asks to look up...

⭐ 0· 115·0 current·0 all-time
byPatrik Ekenberg@patello

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for patello/openfoodfacts.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Open Food Facts API" (patello/openfoodfacts) from ClawHub.
Skill page: https://clawhub.ai/patello/openfoodfacts
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required binaries: curl, jq
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install openfoodfacts

ClawHub CLI

Package manager switcher

npx clawhub@latest install openfoodfacts
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name and description match the included scripts and declared binaries. The skill only needs curl and jq to query the Open Food Facts v2 API for product search and barcode lookups; no additional credentials, config paths, or unrelated binaries are requested.
✓
Instruction Scope
SKILL.md and the two shell scripts confine behavior to making HTTPS GET requests to https://world.openfoodfacts.org/api/v2 and formatting the JSON response. The scripts do not read arbitrary files, environment variables, or send data to other endpoints. Error handling and output formatting are local to the scripts.
✓
Install Mechanism
No install spec is provided (instruction-only with bundled scripts). Nothing in the skill downloads or installs additional code from third-party URLs or writes arbitrary archives to disk.
✓
Credentials
No environment variables or credentials are required or declared. The skill does not request secrets or access to unrelated services; its network access is appropriate for querying the public Open Food Facts API.
✓
Persistence & Privilege
The skill does not request persistent/global privileges. always is false, and the skill does not modify other skills or system-wide agent settings. disable-model-invocation is the normal default and not a concern here.
Assessment
This skill appears coherent and limited: it will run shell scripts that make outgoing HTTPS requests to world.openfoodfacts.org and format the JSON responses with jq. No API keys or secrets are requested. Before installing, be aware that: (1) network access to the Open Food Facts site is required; (2) queries with spaces should be quoted (the search script does not URL-encode the query); and (3) rate limits apply (documented in SKILL.md). If you want extra assurance, review the two included shell scripts yourself (they are short and readable) or run them in a restricted environment.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

Binscurl, jq
latestvk970ebhzhb4aza5m93mmra628n83swa3
115downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0
Patrik Ekenberg@patello
latest
Download

Open Food Facts API Skill

This skill provides access to the Open Food Facts database - a global, crowd-sourced food products database with strong European coverage.

Key Features

  • Global coverage: Products from 150+ countries, with strong European presence
  • No API key required: Free to use for basic queries
  • Barcode lookup: Look up products by EAN/UPC barcode
  • Multi-language support: Product data available in many languages
  • Real-time data: Community-maintained with frequent updates

Important Limitations

Packaged Products Only: Open Food Facts only contains products with barcodes (EAN/UPC). This means:

  • ✅ Packaged foods: soft drinks, chocolate, bread, frozen meals, etc.
  • ❌ Fresh produce without packaging: meat from the butcher, loose vegetables, fresh seafood
  • ❌ Generic ingredients: "apples", "chicken breast", "rice" (unless packaged by a brand)

Data Quality: Since this is crowd-sourced data, accuracy and completeness vary by product. Some products may have incomplete nutritional information.

Rate Limits:

  • 100 requests/minute for product lookups (by barcode)
  • 10 requests/minute for search queries
  • No limits on write operations (contributing data)

Geographic Bias: While global, coverage is strongest in Europe (especially France, where the project started) and North America.

API Usage

All API requests are made to https://world.openfoodfacts.org/api/v2.

Commands

Search Products

Search for food products by name or keyword.

Usage:

./skills/openfoodfacts/scripts/off_search.sh "search query" [page_size]

Parameters:

  • search query (required): Keywords to search for (e.g., "chocolate bar")
  • page_size (optional): Number of results (1-100, default: 10)

Example:

./skills/openfoodfacts/scripts/off_search.sh "chocolate bar"
./skills/openfoodfacts/scripts/off_search.sh "oat milk" 20

Response Format: Returns a formatted table with:

  • Product name
  • Barcode
  • Brand

Get Product by Barcode

Retrieve detailed product information including full nutritional data using a barcode (EAN/UPC).

Usage:

./skills/openfoodfacts/scripts/off_product.sh <barcode>

Parameters:

  • barcode (required): The EAN-13 or UPC barcode number (usually 8-13 digits)

Example:

./skills/openfoodfacts/scripts/off_product.sh 5000159325954
./skills/openfoodfacts/scripts/off_product.sh 7622210449283

Response Format: Returns formatted output with:

  • Product name and brand
  • Packaging and quantity
  • Nutritional information per 100g
  • Ingredients (when available)
  • Allergens and labels
  • Nutri-Score (if available)
  • NOVA group (food processing classification)

Finding Barcodes

Barcodes (EAN-13, UPC) are typically found:

  • On the product packaging, below the barcode lines
  • On receipts or invoices
  • In grocery store apps after scanning
  • On product websites

Barcodes are numeric and usually 8-13 digits long.

Error Handling

Common errors:

  • Product not found: Barcode doesn't exist in database
  • Rate limit exceeded: Too many requests - wait before retrying
  • Malformed barcode: Barcode format is invalid

Workflow Examples

Example 1: Find nutrition for a packaged product

  1. Find the barcode on the product packaging (12-13 digit number below the barcode lines)
  2. Lookup the product: ./skills/openfoodfacts/scripts/off_product.sh 5000159325954

Example 2: Search for a product type

  1. Search by name: ./skills/openfoodfacts/scripts/off_search.sh "dark chocolate"
  2. Note the barcode from results
  3. Get full details: ./skills/openfoodfacts/scripts/off_product.sh <barcode>

Nutri-Score Reference

Products may include a Nutri-Score grade:

  • A (dark green): Best nutritional quality
  • B (light green): Good nutritional quality
  • C (yellow): Average nutritional quality
  • D (orange): Poor nutritional quality
  • E (red): Worst nutritional quality

NOVA Classification

Indicates level of food processing:

  • Group 1: Unprocessed/minimally processed foods
  • Group 2: Processed culinary ingredients
  • Group 3: Processed foods
  • Group 4: Ultra-processed foods

Notes

  • Results are formatted for readability (no raw JSON dumps)
  • Nutritional values are typically per 100g or per serving
  • Ingredients may be listed in multiple languages
  • Some products have photos available via the website

Comments

Loading comments...