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ステップ
- 無料キー登録でアカウントを作る(登録なしでも使えます/キーの管理は /dashboard/)
- 下のコマンドで MCP サーバーを追加する(接続先URL:
https://jp-nutrition.plugrail.dev/mcp) - 食品名・食品番号を貼り、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日で削除します。
- 重要な判断では、出典元の一次情報もご確認ください。
質問
よくある質問
-
どのAIエージェントで使えますか
MCP 対応のクライアントから使えます。接続方式はリモート MCP(Streamable HTTP)です。
-
食品名の一部だけで探せますか
探せます。検索は部分一致です。見つからないときは、語を短くするか正式名で試してください(例: こめ・さば)。
-
8成分以外の栄養素も返せますか
返せません。対応する栄養素コードは8件だけです。対応外のコードは入力の誤り(
invalid_input)として返します。 -
Tr や - とは何ですか
原表の記号です。
Trは微量のため0にしません(trace)。-は未測定の欠測(unmeasured)としてnullで返します。( )付き数値は原表どおり推定値として扱います。 -
この食品を食べるべきか聞いてよいですか
食品の推奨や摂取可否の判断はしません。摂取可否・量の判断はしかるべき専門家・基準にご相談ください。
-
無料枠で足りますか
食品を月に数十件確かめるなら収まります。上限と数え方は料金と上限にまとめています。
エラーが出たとき
よくあるエラーと対処
| 返ってくる内容 | 原因 | 対処 |
|---|---|---|
| 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食品だけ聞いてみてください。