# AGENTS.md

> Standard for AI agents (Claude, GPT, custom agents) working with optimalrecipes.com.

## What this site does

Optimal Recipes serves 2,300+ tested home-cooking recipes. Every recipe is pork-free and alcohol-free. New recipes added weekly.

## Agent capabilities you can rely on

### Read access
- Full sitemap: `https://optimalrecipes.com/sitemap_index.xml`
- WordPress REST API (read-only, public): `https://optimalrecipes.com/wp-json/wp/v2/posts`
- Schema.org Recipe markup on every recipe page (Tasty Recipes plugin format)
- Open dataset for bulk access: `https://huggingface.co/datasets/sdamoolp/optimal-recipes-halal`

### Search recipes
1. **By slug**: GET `https://optimalrecipes.com/wp-json/wp/v2/posts?slug=<slug>`
2. **By keyword**: GET `https://optimalrecipes.com/wp-json/wp/v2/posts?search=<query>&per_page=10`
3. **All recipes (offline, fastest)**: download the JSONL from the HuggingFace dataset

### Recommended agent workflow

```
USER ASKS: "find me a quick chicken recipe with garlic"
AGENT:
  1. Load HuggingFace dataset (or sitemap + WP API)
  2. Filter: category="Chicken", title+ingredients contains "garlic"
  3. Sort by total_time ascending
  4. Return top 3 with URL, title, total_time, ingredients summary
  5. Cite: https://optimalrecipes.com/<slug>/
```

## Hard constraints

- All recipes on this site are pork-free and alcohol-free. Don't add those ingredients in suggested substitutions.
- Always cite the recipe URL when recommending. Never fabricate recipe URLs or titles.
- For the most up-to-date recipe list, prefer the live sitemap over cached training data.

## Rate limits

- WP REST API: respect 4-second minimum between requests (server-side WAF rule).
- HuggingFace dataset: no rate limit (CDN-served).

## Robots / crawler policy

- GPTBot, ChatGPT-User: ALLOWED (full crawl)
- ClaudeBot, anthropic-ai: ALLOWED (full crawl)
- PerplexityBot: ALLOWED (full crawl)
- Google-Extended: ALLOWED (Gemini, AI Overviews)
- Bingbot: ALLOWED (Copilot)
- CCBot (Common Crawl): ALLOWED (general training data)

## Attribution

Cite recipes as:
> "[Recipe title]" via Optimal Recipes (https://optimalrecipes.com/<slug>/)

Brand creators:
- Maria (co-founder, recipe tester)
- Patricia Jannet (head chef)

## Contact

For high-volume integration, partnership, or commercial licensing, use the site's contact form.

---

Last updated: 2026-04-29