fdcnal-usda-fooddata-central-agent

name	fdcnal-usda-fooddata-central-agent
description	The FoodData Central API provides REST access to FoodData Central (FDC), assisting developers in incorporating nutrient data into their applications. It provides access to Standard Reference (SR) Legacy data, USDA Global Branded Foods Database, Foundation Foods, and FNDDS.
env	{"DEEPNLP_ONEKEY_ROUTER_ACCESS":{"required":false,"description":"Onekey Gateway Registerd API and Usage access key"}}
dependencies	{"node":[],"python":[]}

fdcnal-usda-fooddata-central-agent

Auto-generated skill for OneKey Agent Gateway registered agent fdcnal/usda-fooddata-central-agent based on its api_list from registered API metas. Available to use in CLIs, Skills, Rest APIs, and more agent preferred formats.

Quick Start

Set the API providers access key `` or the registered OneKey Gateway access key DEEPNLP_ONEKEY_ROUTER_ACCESS from AI Agent Marketplace.

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_REGISTRY_KEY

Run an API via scripts:

• Node (JS): node scripts/<api_name>.js --data '{"key":"value"}'
• Python: python3 scripts/<api_name>.py --data '{"key":"value"}'

APIs

get_foods_multiple

Fetches details for multiple food items using input FDC IDs

• Method: GET,POST
• Endpoint: https://api.nal.usda.gov/fdc/v1/foods

Parameters:

• fdcIds: array[string]
• format: string=full
• nutrients: array[integer]

Curl

curl -X GET,POST "https://api.nal.usda.gov/fdc/v1/foods" \
  -H "Content-Type: application/json" \
  -d '{}'

Scripts

node scripts/get_foods_multiple.js --data '{}'
python3 scripts/get_foods_multiple.py --data '{}'

get_food_by_id

Fetches details for one food item by FDC ID

• Method: GET
• Endpoint: https://api.nal.usda.gov/fdc/v1/food/{fdcId}

Parameters:

• fdcId: string
• format: string=full
• nutrients: array[integer]

Curl

curl -X GET "https://api.nal.usda.gov/fdc/v1/food/{fdcId}"

Scripts

node scripts/get_food_by_id.js --data '{}'
python3 scripts/get_food_by_id.py --data '{}'

list_foods

Returns a paged list of foods, in the 'abridged' format

• Method: GET,POST
• Endpoint: https://api.nal.usda.gov/fdc/v1/foods/list

Parameters:

• dataType: array[string]
• pageSize: integer=50
• pageNumber: integer=1
• sortBy: string
• sortOrder: string

Curl

curl -X GET,POST "https://api.nal.usda.gov/fdc/v1/foods/list" \
  -H "Content-Type: application/json" \
  -d '{}'

Scripts

node scripts/list_foods.js --data '{}'
python3 scripts/list_foods.py --data '{}'

search_foods

Returns a list of foods that matched search (query) keywords

• Method: GET,POST
• Endpoint: https://api.nal.usda.gov/fdc/v1/foods/search

Parameters:

• query: string
• dataType: array[string]
• pageSize: integer=50
• pageNumber: integer=1
• sortBy: string
• sortOrder: string
• brandOwner: string

Curl

curl -X GET,POST "https://api.nal.usda.gov/fdc/v1/foods/search" \
  -H "Content-Type: application/json" \
  -d '{}'

Scripts

node scripts/search_foods.js --data '{}'
python3 scripts/search_foods.py --data '{}'

Scripts

Each API has a dedicated script in scripts/:

node scripts/<api_name>.js --data '{"key":"value"}'
python3 scripts/<api_name>.py --data '{"key":"value"}'

CLIs

npx onekey agent fdcnal/usda-fooddata-central-agent get_foods_multiple '{"fdcIds":[],"format":"value","nutrients":0}'
npx onekey agent fdcnal/usda-fooddata-central-agent get_food_by_id '{"fdcId":"value","format":"value","nutrients":0}'
npx onekey agent fdcnal/usda-fooddata-central-agent list_foods '{"dataType":[],"pageNumber":0,"pageSize":0,"sortBy":"value","sortOrder":"value"}'
npx onekey agent fdcnal/usda-fooddata-central-agent search_foods '{"brandOwner":"value","dataType":[],"pageNumber":0,"pageSize":0,"query":"value","sortBy":"value"}'

References

• reference/api_list.json: original api_list payload
• reference/api_meta.json: normalized API metadata used by scripts