Rank foods by single nutrient amount

tw_search_foods_by_nutrient

TW-specificMIT

**關鍵字 / Keywords**: 食物營養素高蛋白高鈣 low-carb search foods by nutrient nutrient-based

依單一營養素排行食物 (per 100g) — 衛福部食品營養成分 dataset 8543.

Args:
    nutrient: 分析項 substring (e.g. "鈉", "蛋白質", "鐵", "鈣",
              "膳食纖維", "膽固醇"). 自動 alias 蛋白質→粗蛋白 etc.
    sort: "desc" (高→低, default) | "asc" (低→高)
    min_per_100g / max_per_100g: 數值 filter (e.g. 找 鈉 > 1000 mg/100g)
    food_category: 食品分類 substring (e.g. "魚貝類", "穀物類")
    limit: 1..500 (default 20)

典型用例:
    「鈉含量最高 20 名食物」     → tw_search_foods_by_nutrient("鈉")
    「高蛋白質低脂食物」          → 兩個 call: search by 粗蛋白 + 篩 max 粗脂肪
    「全穀類含鐵排行」           → tw_search_foods_by_nutrient("鐵",
                                                          food_category="穀物")

Input schema

{
  "properties": {
    "nutrient": {
      "title": "Nutrient",
      "type": "string"
    },
    "sort": {
      "default": "desc",
      "title": "Sort",
      "type": "string"
    },
    "min_per_100g": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Min Per 100G"
    },
    "max_per_100g": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Per 100G"
    },
    "food_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Food Category"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "nutrient"
  ],
  "title": "tw_search_foods_by_nutrientArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see tw_search_foods_by_nutrient. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 tw_search_foods_by_nutrient 處理 "…"。

# It will call:
tw_search_foods_by_nutrient(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs