gousto

# Gousto Recipe Skill

Search and browse 9,000+ Gousto recipes from the command line.

## Quick Start

```bash
# 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:
```json
{
  "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](https://github.com/openclaw/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

```bash
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

```bash
./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

```bash
./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:
```bash
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 `of...