{
  "markdown": "# Recipe Commerce Intelligence MCP\n\n[![npm](https://img.shields.io/npm/v/recipe-commerce-mcp)](https://www.npmjs.com/package/recipe-commerce-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Stars](https://img.shields.io/github/stars/teamsincetoday/recipe-commerce-mcp?style=social)](https://github.com/teamsincetoday/recipe-commerce-mcp)\n\n**Turn recipes into affiliate revenue.** Extract every branded ingredient and kitchen tool from any recipe, match each to Amazon Associates, ShareASale, or Awin, and generate a shoppable ingredient list in seconds. F1=100% on eval suite. Free tier: 200 calls/day.\n\n⭐ **If this saves you time, please star the repo** — it helps other developers find it.\n\n> **Live endpoint**: `https://recipe-commerce-mcp.sincetoday.workers.dev/mcp` · [See examples](https://recipe-commerce-mcp.sincetoday.workers.dev/examples)\n\nExtract recipes and ingredients from cooking video transcripts, match to purchasable products, and build affiliate shopping lists. Built on x402, the open payment standard backed by Shopify, Google, Microsoft, Visa, and the Linux Foundation.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `extract_recipe_ingredients` | Extract structured recipe data from a cooking video transcript or YouTube URL |\n| `match_ingredients_to_products` | Match ingredients to purchasable products with affiliate program details |\n| `suggest_affiliate_products` | Generate a ranked affiliate shopping list scored by revenue potential |\n\n## Connect in Claude Code — No Install Required\n\nAdd to your `claude_desktop_config.json` or use `/add-mcp` in Claude Code. Free tier: 200 calls/day, no API key needed:\n\n```json\n{\n  \"mcpServers\": {\n    \"recipe-commerce\": {\n      \"url\": \"https://recipe-commerce-mcp.sincetoday.workers.dev/mcp\"\n    }\n  }\n}\n```\n\n## Quick Start\n\n```bash\n# Install\nnpm install recipe-commerce-mcp\n\n# Configure\ncp .env.example .env\n# Edit .env: set OPENAI_API_KEY\n\n# Run (stdio MCP server)\nnpx recipe-commerce-mcp\n```\n\n## MCP Client Config\n\n```json\n{\n  \"mcpServers\": {\n    \"recipe-commerce\": {\n      \"command\": \"npx\",\n      \"args\": [\"recipe-commerce-mcp\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"sk-...\"\n      }\n    }\n  }\n}\n```\n\n## Tool Reference\n\n### `extract_recipe_ingredients`\n\n```json\n{\n  \"transcript\": \"Cooking video transcript or YouTube URL\",\n  \"recipe_id\": \"optional-cache-key\",\n  \"api_key\": \"optional-paid-key\"\n}\n```\n\nReturns:\n```json\n{\n  \"result\": {\n    \"recipeName\": \"Beef Bourguignon\",\n    \"ingredients\": [\n      { \"name\": \"beef chuck\", \"quantity\": \"2\", \"unit\": \"lbs\", \"category\": \"meat\", \"is_optional\": false }\n    ],\n    \"equipment\": [\n      { \"name\": \"Le Creuset Dutch oven 5.5qt\", \"category\": \"cookware\", \"requiredForRecipe\": true }\n    ],\n    \"techniques\": [\"braising\", \"searing\"],\n    \"cuisineType\": \"French\",\n    \"difficulty\": \"medium\"\n  },\n  \"_meta\": { \"processing_time_ms\": 1950, \"ai_cost_usd\": 0.0024, \"cache_hit\": false, \"recipe_id\": \"...\" }\n}\n```\n\n### `match_ingredients_to_products`\n\n```json\n{\n  \"ingredients\": [{ \"name\": \"beef chuck\", \"quantity\": \"2\", \"unit\": \"lbs\" }],\n  \"recipe_id\": \"optional-uses-cached-ingredients\",\n  \"api_key\": \"optional\"\n}\n```\n\nReturns affiliate program details (Amazon Associates, ShareASale, Awin), price range, commission rate (2–10%), `brand?` (extracted brand name for branded ingredients, e.g. \"Maldon\" for \"Maldon salt\"), `estimatedCommission` (USD estimate based on price × commission rate), and substitution alternatives.\n\n### `suggest_affiliate_products`\n\n```json\n{\n  \"recipe_name\": \"Beef Bourguignon\",\n  \"ingredients\": [...],\n  \"api_key\": \"optional\"\n}\n```\n\nReturns ingredients and equipment ranked by affiliate revenue score. Equipment scores highest (10% commission via Amazon Associates).\n\n## Example Output\n\nReal extraction from a Serious Eats beef bourguignon recipe (live eval avg: **F1=93%**, 98/100 score, $0.000370/call, 2608ms):\n\n```json\n{\n  \"recipe_id\": \"serious-eats-beef-bourguignon\",\n  \"ingredients\": [\n    {\n      \"name\": \"Dutch oven (5.5 qt)\",\n      \"brand\": \"Le Creuset\",\n      \"category\": \"equipment\",\n      \"is_optional\": false,\n      \"affiliate_revenue_score\": 0.92,\n      \"estimatedCommission\": 8.50,\n      \"amazon_search_terms\": [\"dutch oven 5.5 quart\", \"Le Creuset 5.5 qt\"]\n    },\n    {\n      \"name\": \"Maldon sea salt\",\n      \"brand\": \"Maldon\",\n      \"category\": \"ingredient\",\n      \"is_optional\": false,\n      \"affiliate_revenue_score\": 0.18,\n      \"estimatedCommission\": 0.42\n    },\n    {\n      \"name\": \"beef chuck\",\n      \"brand\": null,\n      \"category\": \"ingredient\",\n      \"is_optional\": false,\n      \"affiliate_revenue_score\": 0.12,\n      \"estimatedCommission\": null,\n      \"amazon_search_terms\": null\n    }\n  ]\n}\n```\n\nSee `/examples` endpoint for full output with value narrative: `https://recipe-commerce-mcp.sincetoday.workers.dev/examples`\n\n## Pricing\n\n- Free tier: 200 calls/day per agent (no API key required)\n- Paid: $0.01/call — set `MCP_API_KEYS` with valid keys\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `OPENAI_API_KEY` | Yes | — | OpenAI API key |\n| `AGENT_ID` | No | `anonymous` | Agent identifier for rate limiting |\n| `MCP_API_KEYS` | No | — | Comma-separated paid API keys |\n| `CACHE_DIR` | No | `./data/cache.db` | SQLite cache path |\n| `PAYMENT_ENABLED` | No | `false` | Set `true` to enforce limits |\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck   # Zero type errors\nnpm test            # All tests pass\nnpm run build       # Compile to dist/\n```\n\n## License\n\nMIT — Since Today Studio\n",
  "bytes": 5584,
  "sha": "5988a381d3fc9ef2536e2c66a70ae45b30e5f3de5ab7461f92af119d44ef4002",
  "repo_slug": "teamsincetoday/recipe-commerce-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_teamsincetoday_recipe_commerce_7fc00680/readme"
}