recipe-commerce-mcp

Recipe Commerce Intelligence MCP

将食谱转化为联盟营销收入。 从任意食谱中提取所有品牌食材和厨房工具，将它们与 Amazon Associates、ShareASale 或 Awin 上的商品匹配，并在数秒内生成可购物食材清单。评估套件的 F1 = 100%。免费套餐：每天 200 次调用。

⭐ 如果这为你节省了时间，请给仓库点个 Star —— 这能帮助其他开发者发现它。

在线端点：https://recipe-commerce-mcp.sincetoday.workers.dev/mcp · 查看示例

从烹饪视频转录文本中提取食谱和食材，将它们与可购买的商品匹配，并构建联盟营销购物清单。基于 x402 构建，这是由 Shopify、Google、Microsoft、Visa 和 Linux Foundation 支持的开放支付标准。

工具

工具	描述
extract_recipe_ingredients	从烹饪视频转录文本或 YouTube URL 中提取结构化食谱数据
match_ingredients_to_products	将食材与可购买的商品匹配，并提供联盟营销计划详情
suggest_affiliate_products	生成按收入潜力评分排序的联盟营销购物清单

在 Claude Code 中连接 — 无需安装

添加到你的 claude_desktop_config.json，或在 Claude Code 中使用 /add-mcp。免费套餐：每天 200 次调用，无需 API 密钥：

{
  "mcpServers": {
    "recipe-commerce": {
      "url": "https://recipe-commerce-mcp.sincetoday.workers.dev/mcp"
    }
  }
}

快速开始

# Install
npm install recipe-commerce-mcp

# Configure
cp .env.example .env
# Edit .env: set OPENAI_API_KEY

# Run (stdio MCP server)
npx recipe-commerce-mcp

MCP 客户端配置

{
  "mcpServers": {
    "recipe-commerce": {
      "command": "npx",
      "args": ["recipe-commerce-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

工具参考

extract_recipe_ingredients

{
  "transcript": "Cooking video transcript or YouTube URL",
  "recipe_id": "optional-cache-key",
  "api_key": "optional-paid-key"
}

返回：

{
  "result": {
    "recipeName": "Beef Bourguignon",
    "ingredients": [
      { "name": "beef chuck", "quantity": "2", "unit": "lbs", "category": "meat", "is_optional": false }
    ],
    "equipment": [
      { "name": "Le Creuset Dutch oven 5.5qt", "category": "cookware", "requiredForRecipe": true }
    ],
    "techniques": ["braising", "searing"],
    "cuisineType": "French",
    "difficulty": "medium"
  },
  "_meta": { "processing_time_ms": 1950, "ai_cost_usd": 0.0024, "cache_hit": false, "recipe_id": "..." }
}

match_ingredients_to_products

{
  "ingredients": [{ "name": "beef chuck", "quantity": "2", "unit": "lbs" }],
  "recipe_id": "optional-uses-cached-ingredients",
  "api_key": "optional"
}

返回联盟营销计划详情（Amazon Associates、ShareASale、Awin）、价格范围、佣金率（2–10%）、brand?（品牌食材提取出的品牌名称，例如，“Maldon salt”中的“Maldon”）、estimatedCommission（根据价格 × 佣金率估算的美元金额），以及替代选项。

suggest_affiliate_products

{
  "recipe_name": "Beef Bourguignon",
  "ingredients": [...],
  "api_key": "optional"
}

返回按联盟营销收入评分排序的食材和设备。设备得分最高（通过 Amazon Associates 可获得 10% 佣金）。

示例输出

从 Serious Eats 的一份勃艮第红酒炖牛肉食谱中实时提取（在线评估平均值：F1 = 93%，98/100 分，每次调用 $0.000370，耗时 2608 毫秒）：

{
  "recipe_id": "serious-eats-beef-bourguignon",
  "ingredients": [
    {
      "name": "Dutch oven (5.5 qt)",
      "brand": "Le Creuset",
      "category": "equipment",
      "is_optional": false,
      "affiliate_revenue_score": 0.92,
      "estimatedCommission": 8.50,
      "amazon_search_terms": ["dutch oven 5.5 quart", "Le Creuset 5.5 qt"]
    },
    {
      "name": "Maldon sea salt",
      "brand": "Maldon",
      "category": "ingredient",
      "is_optional": false,
      "affiliate_revenue_score": 0.18,
      "estimatedCommission": 0.42
    },
    {
      "name": "beef chuck",
      "brand": null,
      "category": "ingredient",
      "is_optional": false,
      "affiliate_revenue_score": 0.12,
      "estimatedCommission": null,
      "amazon_search_terms": null
    }
  ]
}

访问 /examples 端点查看包含价值说明的完整输出：https://recipe-commerce-mcp.sincetoday.workers.dev/examples

定价

• 免费套餐：每个 Agent 每天 200 次调用（无需 API 密钥）
• 付费：每次调用 $0.01 — 设置 MCP_API_KEYS 并提供有效密钥

环境变量

变量	必需	默认值	描述
OPENAI_API_KEY	是	—	OpenAI API 密钥
AGENT_ID	否	anonymous	用于速率限制的 Agent 标识符
MCP_API_KEYS	否	—	以逗号分隔的付费 API 密钥
CACHE_DIR	否	./data/cache.db	SQLite 缓存路径
PAYMENT_ENABLED	否	false	设置为 true 以强制执行限制

开发

npm install
npm run typecheck   # Zero type errors
npm test            # All tests pass
npm run build       # Compile to dist/

许可证

MIT — Since Today Studio