🥖 Recipe Extractor API

Web API that extracts structured recipes from Instagram and TikTok and saves them to Notion. Designed for iOS Shortcuts: share a post URL → new page in your Notion database.

Specification

• Platforms: Instagram, TikTok (JS-rendered; static fetch returns shell HTML)
• Output: Schema.org-style Recipe (name, description, author, ingredients, instructions)
• Endpoint: POST /api/notion with { "url": "https://instagram.com/..." } → creates Notion page
• Response: 201 with { notionPageId, notionUrl }; 422 if extraction fails; 502 if Notion fails; 503 if Notion not configured

How to run

bun install
bun run dev

• GET / → health check
• .env for local; wrangler secret put for Cloudflare Workers

Services

Service	Purpose
Cloudflare Browser Rendering	Renders IG/TikTok pages (static fetch returns shell HTML)
Cloudflare Workers AI	Suggests page emoji and tags (optional; falls back to defaults)
Notion API	Creates recipe pages in a database

Environment

Copy .env.example to .env and fill in your values. Notion: create integration at notion.so/my-integrations, create database, share with integration; DB ID from the database URL.