d
Gousto Recipes
Use Caution@dhruvkelawala
npx machina-cli add skill @dhruvkelawala/gousto --openclawFiles (1)
SKILL.md
1.8 KB
Gousto Recipe Skill
Search and browse 9,000+ Gousto recipes from the command line.
Quick Start
# First time: build the cache (~3 min)
./scripts/update-cache.sh
# Search recipes
./scripts/search.sh chicken
./scripts/search.sh "beef curry"
# Get full recipe with ingredients & steps
./scripts/recipe.sh honey-soy-chicken-with-noodles
Scripts
| Script | Purpose |
|---|---|
search.sh <query> | Search recipes by title (uses local cache) |
recipe.sh <slug> | Get full recipe details with ingredients and cooking steps |
update-cache.sh | Rebuild local cache from Gousto API (~3 min) |
API Details
Official Gousto API (recipe listing):
https://production-api.gousto.co.uk/cmsreadbroker/v1/recipes?limit=50&offset=0
- Returns metadata: title, rating, prep_time, url
- Paginate with
offsetparameter (NOTskip— that's broken!) - ~9,300 recipes total
Official Gousto API (single recipe):
https://production-api.gousto.co.uk/cmsreadbroker/v1/recipe/{slug}
- Full recipe with ingredients, cooking steps, nutritional info
- HTML in steps is stripped to plain text by the script
Cache Format
data/recipes.json — array of objects:
{
"title": "Chicken Tikka Masala",
"slug": "chicken-tikka-masala",
"rating": 4.8,
"rating_count": 12543,
"prep_time": 35,
"uid": "blt123..."
}
Notes
- Cache is gitignored — run
update-cache.shafter cloning - Search is instant (local jq filter)
- Recipe fetch requires network (vfjr.dev proxy)
Overview
Gousto Recipe Skill lets you search and browse thousands of Gousto recipes using a local cache built from the official API. It delivers full ingredients, cooking steps, and metadata, with quick scripts to fetch details by slug.
How This Skill Works
First, build a local cache with update-cache.sh (~3 minutes). Then use search.sh <query> to filter the cached recipes via jq for fast results. For full details, fetch a specific recipe with recipe.sh <slug>, which retrieves ingredients, steps, and nutrition from the Gousto API (HTML steps are converted to plain text).
When to Use It
- When you need a quick Gousto recipe search from titles and metadata without hitting the network.
- When you want to refresh or rebuild the local Gousto recipe cache after cloning the repo.
- When you need full recipe details (ingredients and cooking steps) by slug using the official API.
- When exploring recipes by keyword like 'chicken' or 'beef curry' for ideas.
- When you require fast, offline-friendly searching via a local cache (instant results with jq).
Quick Start
- Step 1: ./scripts/update-cache.sh
- Step 2: ./scripts/search.sh chicken
- Step 3: ./scripts/recipe.sh honey-soy-chicken-with-noodles
Best Practices
- Run update-cache.sh after cloning to populate data/recipes.json with ~9k+ Gousto recipes.
- Use quoted queries for multiword searches (e.g., ./scripts/search.sh 'honey soy chicken').
- Verify the slug exists before running recipe.sh to fetch full details.
- Rely on the local cache for search; fetches to the API are required only for full recipe data.
- Regularly refresh the cache to include new Gousto recipes and updates.
Example Use Cases
- Build the cache once, then search for 'chicken' to see matching Gousto titles instantly.
- Search for 'beef curry' and inspect the most highly rated results from the cache.
- Fetch the full recipe for 'honey-soy-chicken-with-noodles' to view ingredients and steps.
- Inspect data/recipes.json to compare prep_time and ratings of top results.
- Update the cache after a Gousto menu refresh and re-run a search for 'vegetarian'.
Frequently Asked Questions
Add this skill to your agents
