OpenCal

OpenCal 是一款具备精美 iOS 应用的卡路里与营养追踪工具。本技能可让您的 AI 代理自动记录餐食、查看进度并更新目标，使用户无需打开 App 即可完成饮食追踪。

“我午餐吃了一个墨西哥卷饼” → 代理执行搜索、按比例换算营养数据并完成记录 → 该条目将立即显示在 App 中。

配置步骤

1. 从 App Store 下载 OpenCal
2. 登录账号并设置您的卡路里/宏量营养素目标
3. 进入 Profile → API Keys → Generate（生成）
4. 设置环境变量：

   export OPENCAL_API_KEY="sk_your-key-here"
   

适用场景

记录一餐

最常见流程：用户说类似“我午餐吃了 200 克鸡胸肉”的话：

1. 搜索食物：

curl -s "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/food/search?q=chicken+breast&limit=5" \
  -H "Authorization: Bearer $OPENCAL_API_KEY" | jq '.results[] | {name, calories, protein, carbs, fat}'

搜索结果中的营养数值均为 每 100 克 的含量。请从中选择最匹配的条目。

2. 按实际摄入量换算并记录：

curl -s -X POST "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/food/log" \
  -H "Authorization: Bearer $OPENCAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Chicken Breast",
    "amount": 200, "unit": "g",
    "calories": 330, "protein": 62, "carbs": 0, "fat": 7.2,
    "mealType": "lunch"
  }'

所有营养数值需乘以 amount / 100 进行换算。记录后条目将即时同步至 App。

mealType 可选值为：breakfast、lunch、dinner 或 snack。 如需补录历史餐食，可在请求体中添加 "loggedAt": "2026-02-18T12:00:00Z"（默认为当前时间）。

3. 向用户确认：“已为您记录午餐：200 克鸡胸肉 —— 330 千卡，62 克蛋白质。”

查看每日进度

curl -s "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/food/log?date=2026-02-18" \
  -H "Authorization: Bearer $OPENCAL_API_KEY" | jq '{totals, entries: [.entries[] | {name, calories, mealType}]}'

若省略 ?date= 参数，则默认查询今日数据。返回内容包含每条记录及总摄入量（卡路里、蛋白质、碳水化合物、脂肪）。

查看与更新目标值

# 查看当前目标
curl -s "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/goals" \
  -H "Authorization: Bearer $OPENCAL_API_KEY" | jq

# 更新目标（仅需提供需修改的字段）
curl -s -X PUT "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/goals" \
  -H "Authorization: Bearer $OPENCAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"calorieGoal": 1800, "proteinGrams": 160}'

删除一条记录

先从每日日志中获取目标条目的 ID，然后执行：

curl -s -X DELETE "${OPENCAL_BASE_URL:-https://api.opencal.ai}/api/v1/food/log/{id}" \
  -H "Authorization: Bearer $OPENCAL_API_KEY"

重要说明

• 搜索结果中的营养数值均为 每 100 克 含量 —— 记录前务必进行换算
• 若用户未说明摄入量，请主动询问，切勿自行猜测
• 若搜索无结果，请尝试更简短或更通用的关键词（例如使用 “rice” 而非 “steamed jasmine rice”）
• 每次记录后均须向用户确认，以便其及时纠正错误
• 调用频率限制：100 次/分钟