smart_search_cocktails
Search cocktails by ingredients, flavors, or similarity using batch processing to retrieve complete recipes with measurements, instructions, and specifications.
Instructions
🚀 PREFERRED TOOL: Advanced cocktail search with intelligent batch processing and complete recipes.
🎯 BATCH PROCESSING SYSTEM:
High Performance: Parallel processing with 5-10x speed improvement
Smart Caching: Automatic caching for 70%+ faster repeated searches
Error Resilience: Individual failures don't break entire batch operations
Flexible Limits: Configure result count (default: 20, max: 50)
📋 Use Cases:
General searches: "gin cocktails", "winter drinks", "classic cocktails"
Similarity queries: "cocktails like Manhattan", "similar to Negroni"
Ingredient-based: "cocktails with bourbon", "drinks using Campari"
Flavor profiles: "bitter cocktails", "sweet drinks", "herbal spirits"
Complex filtering: combine ingredients, ABV ranges, glass types, methods
Batch comparisons: Multiple ingredient searches simultaneously
🔄 Batch Processing Examples:
Single search: {query: "Manhattan"} → Complete recipe + similar cocktails
Multi-ingredient: {ingredient: "gin", must_include: ["vermouth", "bitters"]}
Similarity batch: {similar_to: "Negroni", limit: 10} → 10 similar cocktails
Complex filter: {preferred_flavors: ["bitter"], abv_min: 25, limit: 15}
📊 Response Format: Returns structured data with complete recipes including:
Ingredients with precise measurements in oz (auto-converted from ml)
Step-by-step preparation instructions
Cocktail specifications (ABV, glass, method, garnish)
Direct links to cocktail database pages
Performance metrics (processing time, cache hits)
Similar cocktail recommendations with full recipes
⚡ Performance Features:
Parallel API processing for multiple results
Intelligent caching system with TTL management
Batch fetching of complete recipe details
Error isolation and fallback handling
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | 🔍 Natural language search query (e.g., "Negroni", "gin cocktails", "bitter drinks") | |
| similar_to | No | 🔄 Find cocktails similar to this name (e.g., "Manhattan", "Negroni"). Triggers similarity batch processing. | |
| similar_to_id | No | 🆔 Find cocktails similar to this ID. Use similar_to (by name) unless you have the specific ID. | |
| ingredient | No | 🥃 Primary ingredient filter (e.g., "gin", "whiskey", "campari"). Combines with other filters for batch processing. | |
| must_include | No | ✅ Required ingredients array. Batch processes cocktails containing ALL these ingredients. | |
| must_exclude | No | ❌ Excluded ingredients array. Filters out cocktails with ANY of these ingredients. | |
| preferred_flavors | No | 🎯 Flavor profile preferences: ["bitter", "sweet", "sour", "spicy", "herbal"]. Improves batch ranking. | |
| preferred_strength | No | 💪 Alcohol strength preference. Filters batch results by ABV ranges. | |
| abv_min | No | 📊 Minimum ABV percentage. Lower bound for batch filtering. | |
| abv_max | No | 📊 Maximum ABV percentage. Upper bound for batch filtering. | |
| glass_type | No | 🥂 Required glassware (e.g., "coupe", "rocks", "martini"). Filters entire batch. | |
| preparation_method | No | 🔧 Required method (e.g., "shake", "stir", "build"). Filters batch by technique. | |
| limit | No | 🎛️ Maximum results to return (default: 20, max: 50). Controls batch size for optimal performance. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cocktails | No | Complete cocktail recipes with full details | |
| search_results | No | ||
| search_metadata | No | ||
| similar_cocktails | No | Additional similar cocktails (when using similarity search) | |
| performance_metrics | No | Batch processing performance data |