Faro
Tools/nutrition
Nutrition & Food

Nutrition & Food

Active

Your agent guesses nutrition numbers; this returns real values from USDA and Open Food Facts.

4 tools

Food and nutrition data: search USDA FoodData Central for foods and nutrient profiles, and look up packaged products by barcode or filters via Open Food Facts. USDA data is US public domain; Open Food Facts data is licensed under the Open Database License (ODbL), credit "Open Food Facts".

Knowledge & Referencenutritionfoodingredientscaloriesbarcode

Tools (4)

▶off_search

Filter Open Food Facts products by category, brand, label, or Nutri-Score.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Find organic breakfast cereals on Open Food Facts”
  • “List products with Nutri-Score A in the snacks category”
  • “Show popular products from a given brand”

Parameters

pageintegeroptionaldefault: 1

Result page.

fieldsstringoptional

Comma-separated fields to return (e.g. "product_name,brands,nutriscore_grade").

sort_bystringoptional

Sort key (e.g. "popularity_key", "unique_scans_n").

page_sizeintegeroptionaldefault: 24

Results per page (1-100).

brands_tagsstringoptional

Exact brand tag.

labels_tagsstringoptional

Exact label tag (e.g. "organic", "vegan").

categories_tags_enstringoptional

Exact English category tag (e.g. "breakfast-cereals").

nutrition_grades_tagsstringoptional

Nutri-Score grade.

API Usage

curl -X POST "https://skill.askfaro.com/skills/nutrition/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find organic breakfast cereals on Open Food Facts"
  }
}'

CLI Usage

askfaro describe nutrition/off_search

Install pip install askfaro-cli, then askfaro auth login.

▶usda_search_foods

Search USDA FoodData Central for foods and their nutrient summaries.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Search USDA for cheddar cheese”
  • “Find branded foods matching "greek yogurt"”
  • “Look up nutrition data for raw spinach”

Parameters

querystringrequired

Food search terms.

sortBystringoptional

Field to sort by.

dataTypestringoptional

Comma-separated data types to include (e.g. "Foundation,SR Legacy,Branded").

pageSizeintegeroptionaldefault: 50

Results per page (1-200).

sortOrderstringoptional

Sort direction.

brandOwnerstringoptional

Filter branded foods by brand owner.

pageNumberintegeroptionaldefault: 1

Page number.

API Usage

curl -X POST "https://skill.askfaro.com/skills/nutrition/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Search USDA for cheddar cheese"
  }
}'

CLI Usage

askfaro describe nutrition/usda_search_foods

Install pip install askfaro-cli, then askfaro auth login.

▶usda_food_details

Get the full nutrient profile for a single USDA food by its FDC ID.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Get the full nutrition for FDC ID 173410”
  • “Show all nutrients for this food”
  • “What are the calories and protein in this item?”

Parameters

fdcIdintegerrequired

USDA FoodData Central ID.

formatstringoptionaldefault: "full"

Response detail level.

nutrientsstringoptional

Comma-separated nutrient numbers to limit the response (max 25).

API Usage

curl -X POST "https://skill.askfaro.com/skills/nutrition/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get the full nutrition for FDC ID 173410"
  }
}'

CLI Usage

askfaro describe nutrition/usda_food_details

Install pip install askfaro-cli, then askfaro auth login.

▶off_product_by_barcode

Look up a packaged food product by its barcode (EAN/UPC).

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Look up barcode 3017620422003”
  • “What are the ingredients of this product barcode?”
  • “Get the Nutri-Score for this packaged food”

Parameters

fieldsstringoptional

Comma-separated fields to return (e.g. "product_name,brands,nutriments").

barcodestringrequired

Product barcode digits (EAN/UPC).

API Usage

curl -X POST "https://skill.askfaro.com/skills/nutrition/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Look up barcode 3017620422003"
  }
}'

CLI Usage

askfaro describe nutrition/off_product_by_barcode

Install pip install askfaro-cli, then askfaro auth login.