# Paprika Recipe Importer

> Convert recipe text (pasted text, video transcript, image description, or any raw content) into a .paprikarecipes file that can be imported directly into the Paprika Recipe Manager app. Use when the user shares a recipe in any format (text, transcript, image) and wants a Paprika import file. Triggers on phrases like "create a Paprika file", "import into Paprika", "save this recipe to Paprika", or when a recipe is shared and export to Paprika is implied.

- Skill: `modbender/paprika-recipe-importer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/paprika-recipe-importer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/paprika-recipe-importer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/paprika-recipe-importer

---


# Paprika Recipe Importer

Convert recipe content (any format/language) into a `.paprikarecipes` file for Paprika 3.

## Workflow

1. **Extract** recipe fields from the input (text, image, transcript, URL content).
2. **Build** a JSON recipe object — only include fields actually present in the source; do NOT invent values.
3. **Run** the packaging script to produce the `.paprikarecipes` file.
4. **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

```bash
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.