# Astray Recipes

> A searchable collection of recipes served in both HTML and Markdown. Request any page with `Accept: text/markdown` for clean Markdown output.

## Docs

- [Recipe index](https://www.astray.com/recipes/): Browse recipes by cuisine, protein, dietary need, and more
- [Agent skills index](https://www.astray.com/.well-known/agent-skills/index.json): Machine-readable discovery document for available agent skills
- [Agent skill](https://www.astray.com/.well-known/agent-skills/browse-astray-recipes/SKILL.md): Full instructions for searching and retrieving recipes via Markdown

## Embedded agent skill

The full agent skill is embedded below so single-file clients can use it without fetching `https://www.astray.com/.well-known/agent-skills/browse-astray-recipes/SKILL.md` separately.

---
name: browse-astray-recipes
description: Search and retrieve Astray recipe pages in Markdown format. Extracts title, yield, ingredients, directions, related recipes, and source URL from astray.com. Use when finding recipes, looking up cooking instructions, or browsing astray.com.
compatibility: Requires curl with --compressed support (standard on macOS/Linux).
---

# Browse Astray Recipes

Astray Recipes serves clean Markdown when requested with `Accept: text/markdown`. Use `curl` to search, browse, and retrieve full recipe content.

## Setup

No setup required. Uses `curl` which is available on all standard systems.

## Usage

All requests must include `-H 'Accept: text/markdown'` and should use `--compressed` and `-L` for redirects.

### Browse the homepage

```sh
curl -L 'https://www.astray.com/recipes/' \
  -H 'Accept: text/markdown' \
  --compressed
```

### Search for recipes

Replace `<query>` with `+`-delimited search terms:

```sh
curl -L 'https://www.astray.com/recipes/?search=<query>' \
  -H 'Accept: text/markdown' \
  --compressed
```

Example — search for fat-free desserts:

```sh
curl -L 'https://www.astray.com/recipes/?search=fat-free+dessert' \
  -H 'Accept: text/markdown' \
  --compressed
```

### Open a specific recipe

Use the recipe title from search results as the `show` parameter:

```sh
curl -L 'https://www.astray.com/recipes/?show=<recipe title>' \
  -H 'Accept: text/markdown' \
  --compressed
```

Example — open "Fat-free frozen mango dessert" from search results:

```sh
curl -L 'https://www.astray.com/recipes/?show=Fat-free+frozen+mango+dessert' \
  -H 'Accept: text/markdown' \
  --compressed
```

## Extracting Recipe Details

From each recipe page, extract:

- **Title** — recipe name
- **Yield** — servings or quantity produced
- **Ingredients** — full list with measurements
- **Directions** — step-by-step preparation instructions
- **Related recipes** — links to similar recipes on the site
- **Source URL** — the URL used to retrieve the recipe

## Quality Checks

After retrieving a recipe, verify:

- All measurements have specific quantities
- Steps include timings and temperatures where relevant
- Yield is plausible for the ingredient quantities
- No broken formatting, missing steps, or corrupted text

If a recipe fails these checks, note the issues and search for an alternative.