feat: initial recipe-importer application

Python/Flask web app that scrapes Hungarian recipe sites (mindmegette.hu) and imports them into Mealie via its REST API. Includes dark-themed web UI with editable preview, Dockerfile, build script, and docker-compose. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 21:52:46 +01:00
parent 4da156ef9e
commit f600885b14
16 changed files with 1363 additions and 0 deletions
@@ -0,0 +1,132 @@
+# Recipe Importer
+
+Docker container for importing recipes from Hungarian websites into [Mealie](https://mealie.io/) (Tandoor support planned).
+
+**Problem**: Mealie's built-in URL import cannot parse ingredients and instructions from Hungarian recipe sites like mindmegette.hu — it imports the title and image but shows "Could not detect ingredients / instructions".
+
+**Solution**: This container provides a web UI that scrapes Hungarian recipe pages with site-specific parsers, lets you review and edit the extracted data, then pushes it to Mealie via its REST API.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────┐
+│  recipe-importer container (:8000)              │
+│                                                 │
+│  Flask + Gunicorn                               │
+│  ├── /settings    → Configure Mealie connection │
+│  ├── /import      → Paste URL, scrape, review   │
+│  ├── /scrape      → AJAX: parse recipe HTML     │
+│  ├── /send        → AJAX: push to Mealie API    │
+│  └── /health      → Health check                │
+│                                                 │
+│  Modules:                                       │
+│  ├── app/config.py   → JSON config persistence  │
+│  ├── app/scraper.py  → Site-specific parsers    │
+│  └── app/mealie.py   → Mealie REST API client   │
+└───────────────────┬─────────────────────────────┘
+                    │ HTTP
+                    ▼
+         ┌──────────────────┐
+         │  Mealie instance  │
+         │  POST /api/recipes│
+         │  PATCH /api/...   │
+         │  PUT /api/.../img │
+         └──────────────────┘
+```
+
+## Supported Sites
+
+| Site | Ingredients | Instructions | Image |
+|------|:-----------:|:------------:|:-----:|
+| mindmegette.hu | Yes | Yes | Yes |
+| *Other sites* | Fallback (schema.org JSON-LD) | Fallback (schema.org JSON-LD) | Yes (og:image) |
+
+### Mindmegette.hu Parser
+
+Extracts data from the Angular-rendered HTML:
+
+- **Title**: `og:title` meta tag, with ` | Mindmegette.hu` suffix stripped
+- **Description**: `og:description` meta tag
+- **Image**: `og:image` meta tag
+- **Ingredients**: `div.ingredients` → `div.ingredients-meta` rows, each containing `span.quantity`, `span.unit`, `span.name`, `span.extra`
+- **Instructions**: `mindmegette-wysiwyg-box` → `ol > li` elements
+
+### Generic Fallback Parser
+
+For unsupported sites, attempts extraction via:
+1. Schema.org JSON-LD `@type: Recipe` blocks (`recipeIngredient`, `recipeInstructions`)
+2. OpenGraph meta tags for title, description, image
+
+## Mealie API Integration
+
+The importer uses the Mealie REST API:
+
+1. **POST** `/api/recipes` — create a stub recipe (returns slug)
+2. **PATCH** `/api/recipes/{slug}` — populate ingredients, instructions, description, orgURL
+3. **PUT** `/api/recipes/{slug}/image` — upload the recipe image
+
+Authentication uses a long-lived API token (Bearer header), created in Mealie at *Profile → API Tokens*.
+
+## Configuration
+
+All settings are persisted to `/data/config.json` (mounted as a Docker volume).
+
+| Setting | Description |
+|---------|-------------|
+| `mealie_url` | Full URL to Mealie instance (e.g. `https://mealie.example.com`) |
+| `mealie_api_key` | Mealie API token |
+
+## Deployment
+
+### Docker Compose
+
+```yaml
+services:
+  recipe-importer:
+    image: gitea.dooplex.hu/admin/recipe-importer:0.1.0
+    container_name: recipe-importer
+    restart: unless-stopped
+    ports:
+      - "8011:8000"
+    volumes:
+      - recipe-data:/data
+    environment:
+      - SECRET_KEY=change-me-in-production
+
+volumes:
+  recipe-data:
+```
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SECRET_KEY` | `recipe-importer-dev-key` | Flask session secret |
+| `DATA_DIR` | `/data` | Persistent storage path |
+| `VERSION` | `dev` | Shown in the UI navbar |
+
+## Building
+
+On the build server (192.168.0.180):
+
+```bash
+cd ~/build/recipe-importer
+./build.sh 0.1.0 --push
+```
+
+## Web UI
+
+The UI is in Hungarian and uses a dark theme. The workflow is:
+
+1. **Settings** (`/settings`) — Enter Mealie URL and API key, test connection
+2. **Import** (`/import`) — Paste a recipe URL, click "Beolvasás" (Scrape)
+3. **Review** — Edit the title, description, ingredients, instructions in the preview
+4. **Send** — Click "Importálás Mealie-be" to push to Mealie
+
+## Tech Stack
+
+- **Runtime**: Python 3.12 (slim)
+- **Web framework**: Flask 3.1 + Gunicorn
+- **HTML parsing**: BeautifulSoup 4 + lxml
+- **HTTP client**: requests
+- **Container**: ~60 MB image