recipe-commerce-mcp

Recipe Commerce Intelligence MCP

レシピをアフィリエイト収益に変えましょう。 あらゆるレシピからブランド付きの材料やキッチンツールをすべて抽出し、Amazon Associates、ShareASale、Awinの商品と照合して、数秒で購入可能な材料リストを作成します。評価スイートで F1=100%。無料枠は1日200回の呼び出しです。

⭐ 時間の節約に役立ったら、ぜひリポジトリにスターを付けてください — ほかの開発者がこのプロジェクトを見つけやすくなります。

ライブエンドポイント：https://recipe-commerce-mcp.sincetoday.workers.dev/mcp · 例を見る

料理動画の文字起こしからレシピと材料を抽出し、購入可能な商品と照合して、アフィリエイト用の買い物リストを作成します。Shopify、Google、Microsoft、Visa、Linux Foundation が後援するオープンな決済標準、x402 を基盤に構築されています。

ツール

ツール	説明
extract_recipe_ingredients	料理動画の文字起こしまたはYouTube URLから、構造化されたレシピデータを抽出します
match_ingredients_to_products	材料をアフィリエイトプログラムの詳細とともに購入可能な商品と照合します
suggest_affiliate_products	収益の可能性に基づいてスコア付けした、順位付きのアフィリエイト用買い物リストを生成します

Claude Code に接続 — インストール不要

claude_desktop_config.json に追加するか、Claude Code で /add-mcp を使用してください。無料枠は1日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、1回あたり$0.000370、2608ms）：

{
  "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

料金

• 無料枠：エージェントあたり1日200回（APIキー不要）
• 有料：1回あたり$0.01 — 有効なキーを MCP_API_KEYS に設定してください

環境変数

変数	必須	デフォルト	説明
OPENAI_API_KEY	はい	—	OpenAI APIキー
AGENT_ID	いいえ	anonymous	レート制限に使用するエージェント識別子
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