A cookbook companion
RandomEats
Scan. Pick. Shop.
A REST API and companion for your physical cookbook collection. Photograph a page, let Claude Vision extract every recipe, then let fate decide what you cook tonight.
How it works
Scan
Photograph any cookbook page. Claude Vision reads every recipe — title, ingredients, servings, page number.
Pick
Call /recipes/random — or filter by category —
and let chance choose your next meal.
Shop
Open the AnyList page in Safari on iOS. One tap imports the full ingredient list into your shopping app.
Features
Claude Vision OCR
Post a base64-encoded photo to
POST /recipes/ocr.
Claude Haiku extracts every recipe on the page — including sauces and accompaniments —
each with its own ingredients. Multiple recipes on the same page are automatically
disambiguated as 22#1, 22#2, and so on.
Random Recipe Picker
Hit GET /recipes/random
for a pick across your entire library, or pass
?category=main to scope it.
Ten categories: starter · soup · side · main · terrine · salad · bread · sauce · dessert · other.
AnyList Import
Every recipe has an
/anylist
page serving schema.org Recipe markup. Open it in Safari on iOS, tap Share, select AnyList —
the ingredient list imports automatically. No copy-paste, no manual entry.
API Reference
| Method | Path | Description |
|---|---|---|
| GET |
/books
|
List all cookbooks with recipe counts |
| POST |
/books
|
Add a new cookbook |
| GET |
/recipes
|
List recipes — filter with ?category= or ?book_id= |
| GET |
/recipes/random
|
Pick a random recipe — optional ?category= |
| POST |
/recipes/ocr
|
Scan a cookbook page with Claude Vision |
| GET |
/recipes/:id/anylist
|
AnyList schema.org import page |