gousto – OpenClaw Skill

---

name: gousto description: Search and browse 9,000+ Gousto recipes. Get full ingredients and step-by-step cooking instructions via official API. homepage: https://github.com/dhruvkelawala/gousto-agent-skill metadata: {"openclaw":{"emoji":"🍳","requires":{"bins":["curl","jq"]}}}

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 offset parameter (NOT skip — 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.sh after cloning
• Search is instant (local jq filter)
• Recipe fetch requires network (vfjr.dev proxy)

🍳 Gousto Agent Skill

A recipe skill for AI agents to search and retrieve cooking instructions from Gousto's 9,000+ recipe database.

Built for use with OpenClaw / Moltbot / ClawdBot.

Features

• Search 9,000+ recipes by name
• Get full recipes with ingredients and step-by-step cooking instructions
• Fast local cache for instant search results
• Official API — no third-party proxies

Installation

git clone https://github.com/dhruvkelawala/gousto-agent-skill.git
cd gousto-agent-skill

# Build the recipe cache (~3 minutes)
./scripts/update-cache.sh

Usage

Search recipes

./scripts/search.sh chicken
./scripts/search.sh "beef curry"
./scripts/search.sh mushroom

Output:

Searching for: mushroom

Found 436 recipe(s):

 Garlic Portobello Mushroom Salad With Goat's Cheese
  Rating: 4.5 (230 reviews) | Prep: 35 min | Slug: garlic-portobello-mushroom-salad

Get full recipe

./scripts/recipe.sh garlic-portobello-mushroom-salad

Returns JSON with:

• Title, rating, prep time
• Full ingredient list with quantities
• Step-by-step cooking instructions
• Basic pantry items needed

For AI Agents

This skill is designed for AI agent frameworks. The scripts output structured data that agents can parse and present to users.

OpenClaw Integration

Add to your skills directory:

cd ~/.openclaw/workspace/skills
git clone https://github.com/dhruvkelawala/gousto-agent-skill.git gousto
cd gousto && ./scripts/update-cache.sh

The agent can then:

1. Search recipes with ./scripts/search.sh <query>
2. Get full recipe with ./scripts/recipe.sh <slug>

API Reference

This skill uses the official Gousto API:

Endpoint	Purpose
/cmsreadbroker/v1/recipes?limit=50&offset=N	List recipes (paginated)
/cmsreadbroker/v1/recipe/{slug}	Full recipe details

Note: The skip parameter is broken in Gousto's API — use offset for pagination.

Files

gousto-agent-skill/
├── README.md
├── SKILL.md          # Agent-facing documentation
├── .gitignore
├── data/
│   └── recipes.json  # Local cache (gitignored)
└── scripts/
    ├── search.sh     # Search recipes
    ├── recipe.sh     # Get full recipe
    └── update-cache.sh

License

MIT