jp-nutrition 食品成分 API

食品成分データベースを、自前構築せずに使う

文部科学省「日本食品標準成分表(八訂)増補2023年」の成分値を、AI エージェントにそのまま聞けます。食品名から食品番号を探し、5桁の食品番号で可食部100g当たりの成分値を照会できます。グラム数での換算も、出典と版が付いた形で返ります。

できること

食品成分 API でできること

食品名から食品番号を探す

search_foods は食品名の一部から候補を探します。返すのは食品番号・食品名のみで、成分値は返しません。候補が返ったら、その食品番号で成分値を照会してください。

例:search_foods {"query": "さば", "limit": 5}

100g 当たりの成分値

食品名を渡すと候補が返り、5桁の食品番号を渡すと可食部100g当たりの成分値が返ります。返すのは8成分のうち指定したものだけです。8成分以外の栄養素コードは入力の誤り(invalid_input)として返します。

例:lookup_nutrition {"food_id": "01001", "nutrient_codes": ["ENERC_KCAL", "PROT-", "FAT-"]}

グラム数で換算する

calc_nutrition は食品番号とグラム数を受け取り、可食部100g当たりの成分値を分量で換算します。換算式は per_100g_value * grams / 100 です。分量換算も無料で使えます。上限と数え方は料金と上限をご覧ください。

例:calc_nutrition {"food_id": "01001", "grams": 150, "nutrient_codes": ["ENERC_KCAL"]}

claude mcp add --transport http jp-nutrition https://jp-nutrition.plugrail.dev/mcp

search_foods     {"query":"さば","limit":5}
lookup_nutrition {"food_id":"01001","nutrient_codes":["ENERC_KCAL","PROT-","FAT-"]}
calc_nutrition   {"food_id":"01001","grams":150,"nutrient_codes":["ENERC_KCAL"]}

人間の聞き方:
「さばのたんぱく質と脂質を教えて」
「ごはん 150g のカロリーは?」

8成分

対応する8成分

照会できるのは次の8成分だけです。指定しなかった成分は返りません。

栄養素コード成分単位
ENERC_KCALエネルギーkcal
PROT-たんぱく質g
FAT-脂質g
CHOAVLM炭水化物(単糖当量)g
FIB-食物繊維総量g
NACL_EQ食塩相当量g
VITA_RAEビタミンA(レチノール活性当量)μg
ALCアルコールg

自前 JSON 化・有料 DB との違い

自前 JSON 化・有料 DB との違い

版が固定されている

版は「日本食品標準成分表(八訂)増補2023年・更新日2026-03-27」固定です。成分表を自分で JSON 化して保守したり、異なる版の数値が混ざったりしません。

出典が付く

すべての返答に出典と版が付きます。AI エージェントの答えをうのみにせず、出典元で確かめられます。

Tr と - の扱い

Tr は微量のため0にせず trace として返します。- は未測定の欠測として null で返し、()付き数値は推定値として扱います。原表の記号を勝手に数値へ置き換えません。

栄養成分の確認全般についてはjp-nutrition のページもご覧ください。

返答の根拠

返答には出典と版が付きます

どの返答にも、参照した公表データの名称と URL、版が付きます。

出典: 文部科学省「日本食品標準成分表(八訂)増補2023年」(https://www.mext.go.jp/a_menu/syokuhinseibun/ )を加工して作成。「日本食品標準成分表(八訂)増補2023年から引用」。版は「日本食品標準成分表(八訂)増補2023年・更新日2026-03-27」固定です。

出典の利用条件は「出典明記のみ(許諾不要・商用可)」です。出典と加工の旨を明記してご利用ください。

つなぎ方

接続は3ステップ

  1. 無料キー登録でアカウントを作る(登録なしでも使えます/キーの管理は /dashboard/)
  2. 下のコマンドで MCP サーバーを追加する(接続先URL: https://jp-nutrition.plugrail.dev/mcp)
  3. 食品名・食品番号を貼り、AI エージェントに「成分を教えて」と頼む

Claude Code の場合は、ターミナルで次のコマンドを実行します。

claude mcp add --transport http jp-nutrition https://jp-nutrition.plugrail.dev/mcp

料金と上限

無料ではじめる

匿名・無料アカウントとも月100回まで無料です(暦月・日本時間、カード不要)。回数は日本時間の毎月1日にリセットされます。数えるのはツールの呼び出し(tools/call)だけです。search_foods で20件の候補を取得しても、回数は1回です。

  • 短時間の集中利用には分あたりの上限があります(ログインなしは1分あたり10回、無料アカウントは60回、プロは毎分600回)。
  • プロは月次の回数制限がありません。プロの料金は未定のため、決まり次第このページで案内します。
  • ログインなしは IP アドレス単位、アカウントでは所有者単位で数えます。
  • SLA は設けていません。

注意

ご利用前に

  • 無料枠の数え方・回数のリセット・分あたりの上限は料金と上限にまとめています。
  • 元データは文部科学省の「日本食品標準成分表(八訂)増補2023年」です。
  • 返すのは数値と換算値だけです。食品の推奨や摂取可否の判断はしません。医療に関する助言もしません。摂取可否・量の判断はしかるべき専門家・基準にご相談ください。
  • 返答には「可食部100g当たりの成分値です(出典の版の通り)。摂取可否・量の判断はしかるべき専門家・基準にご相談ください。推奨はしません。」という注意書きが付きます。
  • 出典: 文部科学省「日本食品標準成分表(八訂)増補2023年」(https://www.mext.go.jp/a_menu/syokuhinseibun/ )を加工して作成。
  • 利用記録は収集から90日で削除します。
  • 重要な判断では、出典元の一次情報もご確認ください。

質問

よくある質問

エラーが出たとき

よくあるエラーと対処

返ってくる内容 原因 対処
HTTP 401「認証に失敗しました。」 APIキーの形式が違うか、失効している 管理画面でキーを確かめ、Authorization: Bearer <キー> で送り直す。キーなしでも月100回までは使える
HTTP 429「レート制限を超過しました。」 1分あたりの上限(ログインなし10回・無料60回・プロ600回)に達した 返ってきた Retry-After の秒数だけ待って再試行する
「今月の無料枠(100回)を超えました。」 日本時間の今月、ツール呼び出しが100回を超えた 翌月1日に回数が戻る。
invalid_input 番号の桁が足りないなど、入力の形が違う ページ上部の入力例の形に合わせる

まず動くか確かめる(curl)

curl -s https://jp-nutrition.plugrail.dev/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ツールの一覧が返れば接続はできています。

次の一歩

まず1食品、成分を聞いてみる

Excel の成分表をダウンロードする前に、まず1食品だけ聞いてみてください。