SculleryScore

Score any recipe 0–100 by how much cleanup it creates — dishes dirtied, scrub difficulty, and wash time.

原始信息汇总

数据集概览：SculleryScore

核心功能

• 一个用于评估食谱清洁负担的API，根据清洗难度（弄脏的餐具数量、擦洗难度、清洗时间）为任意食谱打出0–100的评分（分数越高表示清理越轻松）。
• 支持对最多25个食谱进行排序，按清洁程度从最干净到最脏排列。

评分机制

• 评分是确定性的且具有版本号（rubricVersion）：相同输入始终产生相同输出，结果可安全缓存用于排序对比。
• 清洁分数基于多个维度：清洗时间（四舍五入到最近的5分钟）、器皿数量分类（锅、平底锅、碗、烤盘、小工具、其他）、每个器皿的擦洗难度（冲洗/清洗/浸泡）及是否洗碗机安全。

输入方式

• 支持三种输入模式：
  • recipeUrl：公开食谱页面URL（通过 schema.org JSON-LD 解析，设备从指令中推断）。
  • instructions：原始食谱指令文本（设备从文本中提取）。
  • equipment：预先提取的器皿列表（跳过提取，速度最快）。
• 可选字段：ingredients（改善残留物检测，如油腻、粘稠、烤焦）和 title（回显标签）。

Endpoint

方法	路径	描述
POST	/v1/score	对单个食谱评分，返回分数、清洗时间、器皿明细、原因解释及评分版本。
POST	/v1/rank	对最多25个食谱评分并按cleanupScore排序（清洁优先）。
GET	/health	服务健康检查。

响应字段示例

• cleanupScore：0–100 整数。
• cleanupMinutes：估计总清洗时间（分钟）。
• vesselCount：各类器皿数量分类。
• items[]：每个器皿的详情（名称、洗碗机安全、擦洗难度、清洗分钟）。
• whyMessy：人类可读的解释。
• rubricVersion：评分规则版本号。

认证与限制

• 通过 RapidAPI 进行认证，需在请求头中携带 X-RapidAPI-Key 和 X-RapidAPI-Host。
• 注意事项：
  • URL提取依赖食谱页面发布标准 schema.org Recipe 数据；部分大型发布商可能阻止自动化抓取，此时应直接传入 instructions。
  • 速率限制按订阅计划执行，同时服务器端也设有保护措施防止滥用。

定价方案

方案	月费
BASIC	$0.00
PRO	$25.00
ULTRA	$99.00
MEGA	$300.00

提供方信息

• API创建者：Bruno Curi
• 订阅者数量：1
• 分类：Food