Paprika Recipe Importer
Convert recipe content (any format/language) into a .paprikarecipes file for Paprika 3.
Workflow
- Extract recipe fields from the input (text, image, transcript, URL content).
- Build a JSON recipe object — only include fields actually present in the source; do NOT invent values.
- Run the packaging script to produce the
.paprikarecipesfile. - Deliver the file to the user.
Step 1 — Extract Fields
Parse the input and populate only the fields that exist in the source:
| JSON field | Notes |
|---|---|
name | Recipe title. Required. |
ingredients | Newline-separated list. Format: quantity unit ingredient. |
directions | Newline-separated steps. |
description | Intro/summary paragraph, if present. |
notes | Tips, variations, author notes. |
servings | e.g. "4 porções" or "serves 6" |
prep_time | e.g. "15 min" |
cook_time | e.g. "30 min" |
total_time | e.g. "45 min" |
source | Author name, site name, person. |
source_url | Original URL, if available. |
categories | JSON array of strings, e.g. ["Jantar", "Massas"] |
difficulty | "Easy", "Medium", or "Hard" — only if explicitly stated. |
rating | Integer 1–5 — only if explicitly stated. |
nutritional_info | Any nutritional data present. |
Rules:
- Never fabricate values not present in the source.
- Keep the original language (Portuguese, English, mixed — whatever the source uses).
- Ingredients: one per line, preserve quantities and units exactly.
- Directions: one step per line; numbered steps → strip the number (Paprika handles display).
Step 2 — Build JSON
Write the recipe as a JSON file to a temp path, e.g. /tmp/<recipe-name>.json.
Step 3 — Run the Script
python3 ~/.openclaw/skills/paprika-recipe-importer/scripts/build_paprikarecipes.py \
/tmp/<recipe-name>.json \
/tmp/<recipe-name>.paprikarecipes
The script accepts a single JSON object or a JSON array (for multiple recipes).
Step 4 — Deliver
Send the .paprikarecipes file to the user. Mention:
- How to import: File → Import in Paprika (or double-click the file on macOS/iOS).
- Which fields were found and which were absent from the source.