Fdcnal Usda Fooddata Central Agent

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.

bashCopy code
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

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

Scripts

bashCopy code
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

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

Scripts

bashCopy code
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

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

Scripts

bashCopy code
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

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

Scripts

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

Scripts

Each API has a dedicated script in scripts/:

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

CLIs

shellCopy code
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