# Nutrition

> Skill `nutrition` on Faro. 4 sub-skills.

Looks up nutritional information for foods, ingredients, and packaged products: calories, macronutrients, vitamins, and minerals. Works with food names, ingredient lists, and product barcodes, drawing on authoritative food databases for generic and branded items alike.

**Category:** Knowledge & Reference  
**Tags:** nutrition, food, ingredients, calories, barcode  
**Use when:** You need verified calorie, macro, or ingredient numbers for a food or a packaged product instead of guessing.  
**Not for:** Personalized diet or medical advice, computing %DV or daily-value targets, summing a full dish across its ingredients, restaurant or menu items, or live food prices.  
**Returns:** information — Returns structured nutrition data, which is candidate foods with their identifiers, a full nutrient profile with the measurement basis stated, or packaged-product facts with a quality grade. Not a downloadable file. Packaged-product data carries the credit "Open Food Facts".

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/nutrition/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What foods come up when I search for \"greek yogurt\"?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run nutrition "What foods come up when I search for "greek yogurt"?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What foods come up when I search for "greek yogurt"?
- How many calories and how much protein is in 100g of raw spinach?
- What are the ingredients and nutrition facts for barcode 3017620422003?
- Show me popular breakfast cereals with a nutrition grade of A or B

## Sub-skills

### Find a food

Resolves a food name to candidate matches with their identifiers.

**Cost:** 0.1 credits / search

**Use when:** You have a food name and need to identify it before pulling its full nutrient profile.

**Details:** https://askfaro.com/llms/skills/nutrition/lookup_food.md

---

### Food profile

Returns the full nutrient profile for an identified food, with the measurement basis stated.

**Cost:** 0.1 credits / lookup

**Use when:** You have identified a food and need its complete calories, macros, vitamins, and minerals.

**Details:** https://askfaro.com/llms/skills/nutrition/food_facts.md

---

### Product by barcode

Returns facts, ingredients, and a quality grade for a packaged product from its barcode.

**Cost:** 0.1 credits / lookup

**Use when:** You have a scanned or known barcode (EAN or UPC) for a packaged product.

**Details:** https://askfaro.com/llms/skills/nutrition/product_by_barcode.md

---

### Browse products

Lists packaged products filtered by category, brand, label, or quality grade.

**Cost:** 0.1 credits / search

**Use when:** You want products in a category, from a brand, with a label like organic, or at a given quality grade.

**Details:** https://askfaro.com/llms/skills/nutrition/browse_products.md

---

---
On the web: https://askfaro.com/search/nutrition