Thermomix-MCP

Rezepte aus beliebigen Quellen (Rezept-Websites, YouTube, Instagram, TikTok, KI) in ein Thermomix-Rezept verwandeln — und wahlweise direkt in Cookidoo → „Meine Kreationen" hochladen, inkl. Guided-Cooking-Schritten und Bild, sodass es am TM7 abrufbar ist.

Zwei Betriebsarten:

• MCP-Server (Chat-Flow) — Claude bekommt die Rohdaten und baut das Rezept.
• Webhook (headless) — nimmt eine geteilte URL entgegen und macht die Umwandlung selbst per Anthropic-API. Ideal für einen „aus jeder App teilen"-Flow.

Kein offizielles Vorwerk-/Cookidoo-API. Der Cookidoo-Upload nutzt eine reverse-engineerte Schnittstelle (cookidoo-api

• rohe created-recipes-Endpoints) und ein aktives Cookidoo-Abo. Das kann jederzeit brechen. Der TM7 selbst lässt sich nicht fernsteuern — nur Content-Sync über den Account.

Quellen

Quelle	Weg
Rezept-Websites (Chefkoch & Co.)	schema.org/Recipe / JSON-LD (recipe-scrapers)
YouTube	Beschreibung + Transkript
Instagram / TikTok	Caption (oEmbed), optional Tonspur-Transkription (Whisper)
KI-generiert	Claude erstellt das Rezept ohne Quelle

Enthält ein Post kein Rezept (z. B. TikTok-Caption „recipe on the blog"), sucht der Deep-Hunt die Original-Rezeptseite per Websuche und transkribiert notfalls die Tonspur.

MCP-Tools & Prompts

Tool	Zweck
fetch_recipe(url)	Rezept-Rohdaten aus Web/YouTube/Instagram/TikTok
find_recipe_image(query)	Fallback-Bildsuche (Pexels)
save_thermomix_recipe(markdown, filename)	Rezept-Karte als .md speichern
upload_thermomix_recipe(recipe, image_url=…)	Rezept nach Cookidoo hochladen (Guided)

Prompts: thermomix_guide (TM-Konvertierungsregeln), cookidoo_guide (Modus-Zuordnung).

Setup

uv sync                         # Kern
uv sync --extra cookidoo        # + Cookidoo-Upload
uv sync --extra whisper         # + Audio-Transkription (Social-Reels)
cp .env.example .env            # Keys/Optionen eintragen

ffmpeg wird für YouTube-/Social-Audio gebraucht (brew install ffmpeg).

In Claude Code einbinden

claude mcp add thermomix -- uv --directory /pfad/zu/thermomix-mcp run thermomix-mcp

Dann z. B.: „Mach mir aus dieser Chefkoch-URL ein Thermomix-Rezept."

Webhook — „aus jeder App teilen"

uv run thermomix-webhook        # startet auf 0.0.0.0:8787

Endpunkte:

• GET /health → Status
• POST /recipe mit {"url": "…", "caption": "…"(optional)} und Header X-Auth-Token: <WEBHOOK_TOKEN> → extrahiert, wandelt um, speichert die Karte, lädt (wenn konfiguriert) nach Cookidoo hoch. Rezeptlose Video-Posts → sofort 202 + Deep-Hunt im Hintergrund.

Für den Zugriff von unterwegs den Webhook über einen Tunnel freigeben (z. B. Tailscale Funnel oder Cloudflare Tunnel — feste HTTPS-URL, keine Portfreigabe). Ein iOS-Kurzbefehl im Teilen-Menü POSTet die geteilte URL dorthin. Vor jeder öffentlichen Exposure WEBHOOK_TOKEN setzen.

Konfiguration (.env)

Variable	Zweck
THERMOMIX_OUTPUT_DIR	Zielordner für Rezept-Karten (Default ./recipes)
PEXELS_API_KEY	Fallback-Bildsuche (kostenlos)
WHISPER_MODEL	tiny/base/small/medium (Default base)
YTDLP_COOKIES_FROM_BROWSER	safari/chrome/… für Login-Wände bei Instagram/TikTok
ANTHROPIC_API_KEY	Webhook: für die headless-Umwandlung nötig
THERMOMIX_LLM_MODEL	Webhook-Modell (Default Haiku; claude-sonnet-5 für mehr Qualität)
WEBHOOK_TOKEN	Webhook: Auth-Token — vor öffentlicher Exposure zwingend
WEBHOOK_HOST / WEBHOOK_PORT	Webhook-Bind (Default 0.0.0.0:8787)
COOKIDOO_EMAIL / COOKIDOO_PASSWORD	Cookidoo-Upload (braucht aktives Abo)

Lizenz

MIT