gousto
Provides search and retrieval of Gousto recipes via a local cache and the official Gousto API. Contains shell scripts the user/agent is instructed to run (./scripts/update-cache.sh, ./scripts/search.sh, ./scripts/recipe.sh) and makes network requests to https://production-api.gousto.co.uk.
🍳 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:
- Search recipes with
./scripts/search.sh <query> - 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