Recipe Serving Size Adjuster

WHAT IT DOES

Recipe Serving Size Adjuster extracts any recipe from the current page and scales all ingredient quantities and cooking times to match your desired serving size. Whether you need to double a recipe for a crowd or halve it for a smaller household, this tool provides a complete scaled recipe with updated measurements and time modifications. It rounds measurements to practical, usable amounts and adjusts cooking times for optimal results.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on recipe blogs, cooking websites, food magazines, and virtually any page containing recipe content. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you cook and plan meals.

HOW TO USE

Click "Scan Recipe" to automatically extract the recipe content from the current page. The tool intelligently identifies ingredient lists, quantities, and cooking instructions. Enter the original serving size if known (optional), and select your target serving size from the dropdown menu (2, 4, 6, 8, or 12 servings). Configure your preferences: toggle "Round measurements to practical amounts" for usable measurements like 1/3 cup instead of decimal values, and toggle "Include adjusted cooking times" for scaled time and temperature modifications. Click "Adjust Recipe" to send the recipe to the AI backend. Within moments, you'll receive a complete scaled recipe with all ingredients and cooking instructions updated for your serving size. Use the "Copy Adjusted Recipe" button to save it for your cooking session.

TECHNICAL OPERATION

Recipe Serving Size Adjuster employs a multi-strategy extraction pipeline that first checks for selected text, then attempts WebMCP (navigator.modelContext) when available—a W3C proposal for structured page content access—and falls back to DOM-based content detection using prioritized selectors for recipe containers, ingredient lists, and content areas. The user's target serving size, original serving size (if provided), rounding preference, and time inclusion setting are encoded as system-level instructions in the prompt sent to the AI. The text is truncated to 8000 characters and transmitted via GM_xmlhttpRequest to the AI backend. The AI, specifically prompted as a culinary mathematician, identifies all ingredient quantities and unit measurements using pattern recognition that handles various measurement formats (cups, teaspoons, ounces, grams, etc.). It then calculates proportional adjustments using the scaling factor (target servings ÷ original or estimated servings), applies rounding logic to convert decimals to practical fractions, and modifies cooking times based on batch size and pan size considerations. The output preserves recipe structure and instructions while updating all numerical values. Each request is authenticated with a subscription key and counts against your monthly usage cap.

THE PANEL

The Recipe Serving Size Adjuster panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and an active subscription to access the AI backend. AI-generated adjusted recipes are intended as cooking guidance and should be tested before serving, especially for baked goods which may require additional adjustments. Results may vary based on ingredient quality, pan size, and cooking equipment. Always use your judgment and adjust further as needed. No page data is stored or transmitted beyond the content you explicitly submit for adjustment. All processing occurs through secure HTTPS connections, and your subscription key is never exposed to the page context.