mcp-recipes 3.0.0 → 4.0.0

package/README.md

@@ -6,6 +6,7 @@
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.smeet666/mcp-recipes)
 [![Glama](https://glama.ai/mcp/servers/smeet666/mcp-recipes/badges/score.svg)](https://glama.ai/mcp/servers/smeet666/mcp-recipes)
 [![M8ven](https://m8ven.ai/badge/mcp/smeet666-mcp-recipes-1o0x5l?variant=verified)](https://m8ven.ai/mcp/smeet666-mcp-recipes-1o0x5l)
+[![LobeHub](https://lobehub.com/badge/mcp/smeet666-mcp-recipes)](https://lobehub.com/mcp/smeet666-mcp-recipes)
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=recipes&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1yZWNpcGVzIl19)
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=recipes&config=%7B%22name%22%3A%22recipes%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-recipes%22%5D%7D)
 
@@ -15,17 +16,15 @@ a serving is, and a wiki cookbook in English, with equipment lists and prose the
 first has no field for. Asking a question of one of them answers about one of
 them.
 
-This server reads five at once. Three publish in French:
-[Marmiton](https://www.marmiton.org), where home cooks publish,
-[Ptitchef](https://www.ptitchef.com), which files its recipes under a tree of
-ingredients, and [Supertoinette](https://www.supertoinette.com), which prints a
-resting time of its own. Two publish in English: the
-[Wikibooks Cookbook](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents),
-written and maintained in the open, and
-[BBC Good Food](https://www.bbcgoodfood.com), which groups an ingredient list
-under headings. You can search them all with one question, read a recipe from any
-of them in one shape, put several versions of the same dish side by side, and
-rescale any ingredient list. It needs no API key and no account.
+This server reads six. Three publish in French,
+[Marmiton](https://www.marmiton.org), [Ptitchef](https://www.ptitchef.com) and
+[Supertoinette](https://www.supertoinette.com); two in English, the
+[Wikibooks Cookbook](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents)
+and [BBC Good Food](https://www.bbcgoodfood.com); and one in Spanish,
+[Pequerecetas](https://www.pequerecetas.com). You can search them all with
+one question, read a recipe from any of them in one shape, put several versions
+of the same dish side by side, and rescale any ingredient list. It needs no API
+key and no account.
 
 _[Version française](#mcp-recipes-français)_
 
@@ -66,7 +65,7 @@ Node 24 or later is required, and no environment variable has to be set.
   "mcpServers": {
     "recipes": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-recipes:3.0.0"]
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-recipes:4.0.0"]
     }
   }
 }
@@ -75,12 +74,12 @@ Node 24 or later is required, and no environment variable has to be set.
 `-i` keeps stdin open, which is where the protocol travels, and `-t` is left out
 because a TTY rewrites the stream. The container needs outbound HTTPS to
 `www.marmiton.org`, `api.wikimedia.org`, `www.ptitchef.com`,
-`www.bbcgoodfood.com` and `www.supertoinette.com`, and nothing else:
-no volume, no port, no credential.
+`www.bbcgoodfood.com`, `www.supertoinette.com` and `www.pequerecetas.com`, and
+nothing else: no volume, no port, no credential.
 
 ### Bundle, without npm
 
-Download `mcp-recipes-3.0.0.mcpb` from
+Download `mcp-recipes-4.0.0.mcpb` from
 [the latest release](https://github.com/smeet666/mcp-recipes/releases/latest) and
 open it. A client that supports MCP bundles installs it on its own, with no npm
 and no configuration file to edit. The bundle carries its dependencies, so
@@ -106,11 +105,21 @@ its source, and `get_recipe` takes it.
 | `ptitchef`      | `www.ptitchef.com`      | French   |
 | `goodfood`      | `www.bbcgoodfood.com`   | English  |
 | `supertoinette` | `www.supertoinette.com` | French   |
+| `pequerecetas`  | `www.pequerecetas.com`  | Spanish  |
 
 A row's `id` names its source, so an identifier read from one answer goes back to
 the right site. **Counts are never added across sources**, and a source that
 failed is reported as having failed rather than as having found nothing.
 
+Each site is read at its own pace: two of them ask for three seconds between
+requests, and a setting posted for all of them can only make this server more
+patient than the slowest asks for.
+
+Two of these sites file something other than a recipe at the address a recipe
+lives at. The Wikibooks Cookbook keeps pages about an ingredient beside the
+recipes using it, and Pequerecetas publishes articles that gather recipes. A
+search says so, and `get_recipe` says what it read off the page.
+
 ## Tools
 
 | Tool                | What it does                                               |
@@ -136,8 +145,10 @@ Searches every source with one question.
 `image_url`; and an `excerpt` where the source offers one. `per_source` gives one
 report per site with its `status`, reading `answered` or `failed`, the `count` it
 contributed, and its `reported_total` alongside `reported_total_means`, which
-says what that number counts on that site. `order` says in words how the list was
-built.
+says what that number counts on that site. `names_the_dish` says how many of that
+site's rows carry the dish in their title, out of `count`: a search index answers
+the words it is handed, so a site can offer rows and none of them be the dish.
+`order` says in words how the list was built.
 
 ### `get_recipe`
 
@@ -149,17 +160,26 @@ Reads one recipe from any source, in one shape.
 | `servings`       | integer, 1 to 500                                                                                              | no       | Rescale the ingredients to this many servings.                                                                                         |
 | `sections`       | array of `ingredients`, `steps`, `times`, `nutrition`, `tips`, `equipment`, default `["ingredients", "steps"]` | no       | Which parts to return.                                                                                                                 |
 | `max_steps`      | integer, 1 to 100, default `20`                                                                                | no       | Steps to serve.                                                                                                                        |
+| `max_gathered`   | integer, 1 to 500, default `30`                                                                                | no       | Recipes and headings to return from an address that gathers recipes.                                                                   |
 | `max_step_chars` | integer, 80 to 4000, default `600`                                                                             | no       | Characters kept per step.                                                                                                              |
 
-**In return:** the recipe in the shape every source is rendered into, whichever
-published it: its title, its address, its ingredients with each line's `scaling`,
+**In return:** `kind` says what the address held. A `recipe` answer carries
+`recipe` and no `collection`; a `collection` answer carries `collection` and no
+`recipe`, and is an article gathering other recipes, with the `headings` it is
+built from and the `recipes` it points at, each of them readable with
+`get_recipe`.
+
+A recipe comes in the shape every source is rendered into, whichever
+published it: its title, its address, its ingredients with each line's `scaling`
+and `is_equipment`,
 its steps, and the sections asked for. A field one source publishes and another
 has no notion of comes back absent rather than invented. `rest_minutes` carries a
 resting time from a source that prints one apart, and is in no other time here.
 `steps_as_one_block` says when a source published its method as one block of
 prose rather than as steps. `withheld` names a part a source keeps for its
 subscribers, which is a part the page has rather than a part that could not be
-read. Raise `max_step_chars` when a step was cut mid-sentence.
+read. `scaling_summary` counts the lines four ways, and the four add up to the
+list. Raise `max_step_chars` when a step was cut mid-sentence.
 
 ### `compare_recipes`
 
@@ -181,18 +201,18 @@ search does.
 
 ### `scale_ingredients`
 
-Rescales any ingredient list, with no request to either site.
+Rescales any ingredient list, with no request to any site.
 
-| Argument        | Type                                 | Required   | What it does                               |
-| --------------- | ------------------------------------ | ---------- | ------------------------------------------ |
-| `ingredients`   | array of 1 to 200 lines              | yes        | The lines to rescale.                      |
-| `factor`        | number, up to 1000                   | one of two | The multiplier to apply.                   |
-| `from_servings` | integer, 1 to 500                    | one of two | How many servings the list is written for. |
-| `to_servings`   | integer, 1 to 500                    | one of two | How many servings are wanted.              |
-| `language`      | `auto`, `fr` or `en`, default `auto` | no         | How each line is read.                     |
+| Argument        | Type                                       | Required   | What it does                               |
+| --------------- | ------------------------------------------ | ---------- | ------------------------------------------ |
+| `ingredients`   | array of 1 to 200 lines                    | yes        | The lines to rescale.                      |
+| `factor`        | number, up to 1000                         | one of two | The multiplier to apply.                   |
+| `from_servings` | integer, 1 to 500                          | one of two | How many servings the list is written for. |
+| `to_servings`   | integer, 1 to 500                          | one of two | How many servings are wanted.              |
+| `language`      | `auto`, `fr`, `en` or `es`, default `auto` | no         | How each line is read.                     |
 
 Pass `factor`, or the `from_servings` and `to_servings` pair. `auto` reads each
-line on its own, which is what a list holding both languages needs; naming a
+line on its own, which is what a list holding more than one language needs; naming a
 language reads every line that way.
 
 **In return:** the rescaled lines in the shape `get_recipe` returns, each with
@@ -219,22 +239,22 @@ say they were recomputed when you show them.
 Every answer accounts for each source separately. A site that failed, one nobody
 asked, and one that answered with nothing are three different things, and they
 are reported as three. A total stays beside the source that published it, with
-what that source counts when it says it: one site counts a whole category and the
-other counts the rows it served.
+what that source counts when it says it: one site counts a whole category, another
+counts the rows it served, and a third publishes no total at all.
 
 ## Configuration
 
 Every variable is optional. Set them in the `env` block of your client config.
 
-| Variable                    | Default              | What it does                                                                         |
-| --------------------------- | -------------------- | ------------------------------------------------------------------------------------ |
-| `RECIPES_USER_AGENT`        | the project identity | Names your application to both sites, with an address where a person can be reached. |
-| `RECIPES_MIN_INTERVAL_MS`   | `1000`               | Gap between two requests to one site, from 500 to 60000.                             |
-| `RECIPES_TIMEOUT_MS`        | `20000`              | Deadline for one request, from 1000 to 120000.                                       |
-| `RECIPES_MAX_RETRIES`       | `3`                  | Attempts after a transient failure, from 0 to 8.                                     |
-| `RECIPES_CACHE_TTL_MS`      | `900000`             | How long an answer stays in memory, from 0 to 86400000.                              |
-| `RECIPES_CACHE_MAX_ENTRIES` | `200`                | Answers held in memory at once, from 1 to 5000.                                      |
-| `RECIPES_LOG_LEVEL`         | `error`              | `silent`, `error`, `info` or `debug`, written to stderr.                             |
+| Variable                    | Default              | What it does                                                                        |
+| --------------------------- | -------------------- | ----------------------------------------------------------------------------------- |
+| `RECIPES_USER_AGENT`        | the project identity | Names your application to the sites, with an address where a person can be reached. |
+| `RECIPES_MIN_INTERVAL_MS`   | `1000`               | Gap between two requests to one site, from 500 to 60000.                            |
+| `RECIPES_TIMEOUT_MS`        | `20000`              | Deadline for one request, from 1000 to 120000.                                      |
+| `RECIPES_MAX_RETRIES`       | `3`                  | Attempts after a transient failure, from 0 to 8.                                    |
+| `RECIPES_CACHE_TTL_MS`      | `900000`             | How long an answer stays in memory, from 0 to 86400000.                             |
+| `RECIPES_CACHE_MAX_ENTRIES` | `200`                | Answers held in memory at once, from 1 to 5000.                                     |
+| `RECIPES_LOG_LEVEL`         | `error`              | `silent`, `error`, `info` or `debug`, written to stderr.                            |
 
 A value outside its range falls back to the default, and the reason is written to
 stderr.
@@ -258,25 +278,47 @@ so one silent site never hides the other.
 
 ## As a library
 
-The layer reading the two sites is published on its own, with its pacing, its
-cache and its errors, and with no protocol attached.
+The layer reading the sites is published on its own, with its pacing, its cache
+and its errors, and with no protocol attached.
 
 ```ts
 import { RecipesClient } from "mcp-recipes/client";
 
 const client = new RecipesClient();
-const read = await client.search({ query: "carbonara", limitPerSource: 3 });
-console.log(read.data.results.length);
+const { rows, reports } = await client.searchRecipes("carbonara", 3);
+console.log(
+  rows.length,
+  reports.map((report) => report.status),
+);
+
+const { recipe } = await client.getRecipe(rows[0].id);
 ```
 
-Each read answers `{ data, cached }`, and throws an error carrying one of the six
-codes. Each site keeps its own pace, and the floor holds here as well.
+`searchRecipes(query, limitPerSource, sources?, options?)` answers
+`{ rows, reports }`: one report per source, saying whether it answered and what
+its own count measured, so a source that failed is never read as a source that
+holds nothing. `getRecipe(id)` answers `{ recipe, cached, read }`, and throws an
+error carrying one of the six codes. `client.profiles` lists the sources the
+build registers.
+
+The scaler is published separately at `mcp-recipes/scale`, and works offline on
+any list:
+
+```ts
+import { scaleIngredients } from "mcp-recipes/scale";
+
+scaleIngredients(["200 g de harina", "4 oeufs", "1 cup milk"], { factor: 2 });
+```
+
+Each site keeps its own pace, and the floors hold here as well.
 
 ## Pacing and attribution
 
 Each site is paced on its own, one request at a time with at least a second
 between two, and the floor of half a second holds however the server is
-configured. Asking every site at once therefore costs each of them one request,
+configured. Two of the sites ask for more, three seconds between two requests,
+and they get it: a setting posted for every source can raise a site's spacing
+and never lower it. Asking every site at once therefore costs each of them one request,
 never two. The `User-Agent` always ends with the project identity and an address
 where a person can be reached.
 
@@ -284,7 +326,7 @@ Every row carries the address of the recipe's own page and the name of the site
 that published it. The Cookbook pages are published under
 [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/), which asks that
 what is built on them be shared under the same licence. Marmiton, Ptitchef, BBC
-Good Food and Supertoinette state no terms on a recipe page, and their recipes
+Good Food, Supertoinette and Pequerecetas state no terms on a recipe page, and their recipes
 belong to those sites and to the cooks who wrote them. Silence is not a grant, so
 credit the site and link the page you took a recipe from.
 
@@ -305,7 +347,8 @@ sites it reads.
 
 This server collects nothing about you and sends nothing to its author. It runs
 on your machine, contacts `www.marmiton.org`, `api.wikimedia.org`,
-`www.ptitchef.com`, `www.bbcgoodfood.com` and `www.supertoinette.com` and nothing
+`www.ptitchef.com`, `www.bbcgoodfood.com`, `www.supertoinette.com` and
+`www.pequerecetas.com` and nothing
 else, holds its answers in memory while it runs,
 and writes nothing to disk. [PRIVACY.md](PRIVACY.md) states what a request
 carries and which settings change any of it.
@@ -349,18 +392,15 @@ qu'est une part, et un wiki de cuisine en anglais, avec des listes de matériel
 une prose pour lesquelles le premier n'a aucun champ. Poser une question à l'un
 d'eux répond au sujet de l'un d'eux.
 
-Ce serveur en lit cinq à la fois. Trois publient en français :
-[Marmiton](https://www.marmiton.org), où des cuisiniers publient,
-[Ptitchef](https://www.ptitchef.com), qui range ses recettes sous un arbre
-d'ingrédients, et [Supertoinette](https://www.supertoinette.com), qui imprime un
-temps de repos à part. Deux publient en anglais : le
-[Cookbook des Wikibooks](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents),
-écrit et entretenu à découvert, et
-[BBC Good Food](https://www.bbcgoodfood.com), qui groupe une liste d'ingrédients
-sous des intertitres. On peut chercher dans les cinq avec une seule question,
-lire une recette de n'importe lequel sous une seule forme, mettre plusieurs
-versions d'un même plat côte à côte, et adapter n'importe quelle liste
-d'ingrédients. Aucune clé d'API, aucun compte.
+Ce serveur en lit six. Trois publient en français,
+[Marmiton](https://www.marmiton.org), [Ptitchef](https://www.ptitchef.com) et
+[Supertoinette](https://www.supertoinette.com) ; deux en anglais, le
+[Cookbook des Wikibooks](https://en.wikibooks.org/wiki/Cookbook:Table_of_Contents)
+et [BBC Good Food](https://www.bbcgoodfood.com) ; un en espagnol,
+[Pequerecetas](https://www.pequerecetas.com). On peut chercher dans les six
+avec une seule question, lire une recette de n'importe lequel sous une seule
+forme, mettre plusieurs versions d'un même plat côte à côte, et adapter
+n'importe quelle liste d'ingrédients. Aucune clé d'API, aucun compte.
 
 ## Installation
 
@@ -398,7 +438,7 @@ renseigner.
   "mcpServers": {
     "recipes": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-recipes:3.0.0"]
+      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-recipes:4.0.0"]
     }
   }
 }
@@ -407,12 +447,12 @@ renseigner.
 `-i` garde l'entrée standard ouverte, qui est le canal du protocole, et `-t` est
 omis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS
 sortant vers `www.marmiton.org`, `api.wikimedia.org`, `www.ptitchef.com`,
-`www.bbcgoodfood.com` et `www.supertoinette.com`, et de
+`www.bbcgoodfood.com`, `www.supertoinette.com` et `www.pequerecetas.com`, et de
 rien d'autre : aucun volume, aucun port, aucun identifiant.
 
 ### Bundle, sans npm
 
-Téléchargez `mcp-recipes-3.0.0.mcpb` depuis
+Téléchargez `mcp-recipes-4.0.0.mcpb` depuis
 [la dernière publication](https://github.com/smeet666/mcp-recipes/releases/latest)
 et ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et
 sans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc
@@ -438,20 +478,31 @@ qui nomme sa source, et `get_recipe` le reprend.
 | `ptitchef`      | `www.ptitchef.com`      | français |
 | `goodfood`      | `www.bbcgoodfood.com`   | anglais  |
 | `supertoinette` | `www.supertoinette.com` | français |
+| `pequerecetas`  | `www.pequerecetas.com`  | espagnol |
 
 L'`id` d'une ligne nomme sa source, donc un identifiant lu dans une réponse
 retourne vers le bon site. **Les comptes ne sont jamais additionnés entre
 sources**, et une source qui a échoué est rapportée comme ayant échoué plutôt que
 comme n'ayant rien trouvé.
 
+Chaque site est lu à son propre rythme : deux d'entre eux demandent trois
+secondes entre deux requêtes, et un réglage posé pour tous ne peut que rendre ce
+serveur plus patient que ce que le plus lent demande.
+
+Deux de ces sites rangent autre chose qu'une recette à l'adresse où vit une
+recette. Le Cookbook des Wikibooks garde des pages sur un ingrédient à côté des
+recettes qui l'emploient, et Pequerecetas publie des articles qui rassemblent
+des recettes. Une recherche le dit, et `get_recipe` dit ce qu'il a lu sur la
+page.
+
 ## Les outils
 
-| Outil               | Ce qu'il fait                                              |
-| ------------------- | ---------------------------------------------------------- |
-| `search_recipes`    | Cherche dans toutes les sources avec une seule question.   |
-| `get_recipe`        | Lit une recette de l'une ou l'autre, sous une seule forme. |
-| `compare_recipes`   | Met plusieurs versions d'un même plat côte à côte.         |
-| `scale_ingredients` | Adapte n'importe quelle liste d'ingrédients, sans requête. |
+| Outil               | Ce qu'il fait                                                     |
+| ------------------- | ----------------------------------------------------------------- |
+| `search_recipes`    | Cherche dans toutes les sources avec une seule question.          |
+| `get_recipe`        | Lit une recette de n'importe quelle source, sous une seule forme. |
+| `compare_recipes`   | Met plusieurs versions d'un même plat côte à côte.                |
+| `scale_ingredients` | Adapte n'importe quelle liste d'ingrédients, sans requête.        |
 
 ### `search_recipes`
 
@@ -469,8 +520,11 @@ Cherche dans toutes les sources avec une seule question.
 `url` ; `image_url` ; et un `excerpt` là où la source en propose un.
 `per_source` donne un rapport par site avec son `status`, valant `answered` ou
 `failed`, le `count` qu'il a fourni, et son `reported_total` accompagné de
-`reported_total_means`, qui dit ce que ce nombre compte sur ce site. `order` dit
-en mots comment la liste a été bâtie.
+`reported_total_means`, qui dit ce que ce nombre compte sur ce site.
+`names_the_dish` dit combien des lignes de ce site portent le plat dans leur
+titre, sur `count` : un index de recherche répond aux mots qu'on lui tend, donc
+un site peut rendre des lignes dont aucune n'est le plat. `order` dit en mots
+comment la liste a été bâtie.
 
 ### `get_recipe`
 
@@ -481,17 +535,26 @@ Lit une recette de n'importe quelle source, sous une seule forme.
 | `id`             | chaîne, 1 à 500 caractères                                                                                      | oui    | L'identifiant d'une ligne, tel que `marmiton:44078`. Deux sources adressent une recette par un nombre nu : écrivez l'id avec sa source. |
 | `servings`       | entier, 1 à 500                                                                                                 | non    | Adapte les ingrédients à ce nombre de parts.                                                                                            |
 | `sections`       | tableau de `ingredients`, `steps`, `times`, `nutrition`, `tips`, `equipment`, défaut `["ingredients", "steps"]` | non    | Les parties à rendre.                                                                                                                   |
+| `max_gathered`   | entier, 1 à 500, défaut `30`                                                                                    | non    | Recettes et intertitres rendus pour une adresse qui rassemble des recettes.                                                             |
 | `max_steps`      | entier, 1 à 100, défaut `20`                                                                                    | non    | Étapes à servir.                                                                                                                        |
 | `max_step_chars` | entier, 80 à 4000, défaut `600`                                                                                 | non    | Caractères gardés par étape.                                                                                                            |
 
-**En retour :** la recette dans la forme où toutes les sources sont rendues, quelle
+**En retour :** `kind` dit ce que l'adresse portait. Une réponse `recipe` porte
+`recipe` et pas de `collection` ; une réponse `collection` porte `collection` et
+pas de `recipe`, et c'est un article rassemblant d'autres recettes, avec les
+`headings` dont il est bâti et les `recipes` vers lesquelles il pointe, chacune
+lisible par `get_recipe`.
+
+Une recette vient dans la forme où toutes les sources sont rendues, quelle
 que soit celle qui l'a publiée : son titre, son adresse, ses ingrédients avec le
-`scaling` de chaque ligne, ses étapes, et les parties demandées. Un champ qu'une
+`scaling` et l'`is_equipment` de chaque ligne, ses étapes, et les parties
+demandées. Un champ qu'une
 source publie et dont une autre n'a pas la notion revient absent plutôt
 qu'inventé. `rest_minutes` porte le temps de repos d'une source qui l'imprime à
 part, et il n'entre dans aucun autre temps rendu ici. `steps_as_one_block` dit
 quand une source a publié sa méthode d'un seul bloc de prose plutôt qu'en étapes.
-`withheld` nomme la partie qu'une source réserve à ses abonnés, qui est une
+`scaling_summary` compte les lignes de quatre façons, et les quatre font le
+total de la liste. `withheld` nomme la partie qu'une source réserve à ses abonnés, qui est une
 partie que la page porte et non une partie illisible. Augmentez `max_step_chars`
 quand une étape a été coupée au milieu d'une phrase.
 
@@ -515,22 +578,24 @@ fait une recherche.
 
 ### `scale_ingredients`
 
-Adapte n'importe quelle liste d'ingrédients, sans requête à l'un ou l'autre site.
+Adapte n'importe quelle liste d'ingrédients, sans requête à aucun site.
 
-| Argument        | Type                                | Requis        | Ce qu'il fait                             |
-| --------------- | ----------------------------------- | ------------- | ----------------------------------------- |
-| `ingredients`   | tableau de 1 à 200 lignes           | oui           | Les lignes à adapter.                     |
-| `factor`        | nombre, jusqu'à 1000                | l'un des deux | Le multiplicateur à appliquer.            |
-| `from_servings` | entier, 1 à 500                     | l'un des deux | Le nombre de parts de la liste d'origine. |
-| `to_servings`   | entier, 1 à 500                     | l'un des deux | Le nombre de parts voulu.                 |
-| `language`      | `auto`, `fr` ou `en`, défaut `auto` | non           | Comment chaque ligne est lue.             |
+| Argument        | Type                                      | Requis        | Ce qu'il fait                             |
+| --------------- | ----------------------------------------- | ------------- | ----------------------------------------- |
+| `ingredients`   | tableau de 1 à 200 lignes                 | oui           | Les lignes à adapter.                     |
+| `factor`        | nombre, jusqu'à 1000                      | l'un des deux | Le multiplicateur à appliquer.            |
+| `from_servings` | entier, 1 à 500                           | l'un des deux | Le nombre de parts de la liste d'origine. |
+| `to_servings`   | entier, 1 à 500                           | l'un des deux | Le nombre de parts voulu.                 |
+| `language`      | `auto`, `fr`, `en` ou `es`, défaut `auto` | non           | Comment chaque ligne est lue.             |
 
 Passez `factor`, ou le couple `from_servings` et `to_servings`. `auto` lit chaque
-ligne pour elle-même, ce dont a besoin une liste portant les deux langues ;
+ligne pour elle-même, ce dont a besoin une liste portant plusieurs langues ;
 nommer une langue lit toutes les lignes ainsi.
 
 **En retour :** les lignes adaptées dans la forme que rend `get_recipe`, chacune
-avec son `scaling`.
+avec son `scaling` et son `is_equipment`, vrai pour une ligne qui nomme un outil
+et qu'on laisse telle quelle. `scaled_count`, `rounded_count`, `unscaled_count`
+et `equipment_count` font le total des lignes envoyées.
 
 ## L'adaptation des quantités
 
@@ -554,22 +619,23 @@ Chaque réponse rend compte de chaque source séparément. Un site qui a échou
 que personne n'a interrogé et un qui a répondu vide sont trois choses
 différentes, et elles sont rapportées comme trois. Un total reste à côté de la
 source qui l'a publié, avec ce que cette source compte en le disant : l'un compte
-une catégorie entière et l'autre compte les lignes qu'il a servies.
+une catégorie entière, un autre compte les lignes qu'il a servies, et un
+troisième ne publie aucun total.
 
 ## Configuration
 
 Chaque variable est facultative. Elles se posent dans le bloc `env` de la
 configuration du client.
 
-| Variable                    | Défaut               | Ce qu'elle fait                                                                          |
-| --------------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
-| `RECIPES_USER_AGENT`        | l'identité du projet | Nomme votre application auprès des deux sites, avec une adresse où joindre une personne. |
-| `RECIPES_MIN_INTERVAL_MS`   | `1000`               | Écart entre deux requêtes vers un même site, de 500 à 60000.                             |
-| `RECIPES_TIMEOUT_MS`        | `20000`              | Délai d'une requête, de 1000 à 120000.                                                   |
-| `RECIPES_MAX_RETRIES`       | `3`                  | Tentatives après un échec passager, de 0 à 8.                                            |
-| `RECIPES_CACHE_TTL_MS`      | `900000`             | Durée pendant laquelle une réponse reste en mémoire, de 0 à 86400000.                    |
-| `RECIPES_CACHE_MAX_ENTRIES` | `200`                | Réponses gardées en mémoire à la fois, de 1 à 5000.                                      |
-| `RECIPES_LOG_LEVEL`         | `error`              | `silent`, `error`, `info` ou `debug`, écrit sur la sortie d'erreur.                      |
+| Variable                    | Défaut               | Ce qu'elle fait                                                                     |
+| --------------------------- | -------------------- | ----------------------------------------------------------------------------------- |
+| `RECIPES_USER_AGENT`        | l'identité du projet | Nomme votre application auprès des sites, avec une adresse où joindre une personne. |
+| `RECIPES_MIN_INTERVAL_MS`   | `1000`               | Écart entre deux requêtes vers un même site, de 500 à 60000.                        |
+| `RECIPES_TIMEOUT_MS`        | `20000`              | Délai d'une requête, de 1000 à 120000.                                              |
+| `RECIPES_MAX_RETRIES`       | `3`                  | Tentatives après un échec passager, de 0 à 8.                                       |
+| `RECIPES_CACHE_TTL_MS`      | `900000`             | Durée pendant laquelle une réponse reste en mémoire, de 0 à 86400000.               |
+| `RECIPES_CACHE_MAX_ENTRIES` | `200`                | Réponses gardées en mémoire à la fois, de 1 à 5000.                                 |
+| `RECIPES_LOG_LEVEL`         | `error`              | `silent`, `error`, `info` ou `debug`, écrit sur la sortie d'erreur.                 |
 
 Une valeur hors de sa plage retombe sur le défaut, et la raison est écrite sur la
 sortie d'erreur.
@@ -593,25 +659,47 @@ toute la réponse, donc un site silencieux n'en cache jamais un autre.
 
 ## Comme bibliothèque
 
-La couche qui lit les deux sites est publiée seule, avec son rythme, son cache et
+La couche qui lit les sites est publiée seule, avec son rythme, son cache et
 ses erreurs, sans protocole attaché.
 
 ```ts
 import { RecipesClient } from "mcp-recipes/client";
 
 const client = new RecipesClient();
-const read = await client.search({ query: "carbonara", limitPerSource: 3 });
-console.log(read.data.results.length);
+const { rows, reports } = await client.searchRecipes("carbonara", 3);
+console.log(
+  rows.length,
+  reports.map((report) => report.status),
+);
+
+const { recipe } = await client.getRecipe(rows[0].id);
+```
+
+`searchRecipes(query, limitPerSource, sources?, options?)` répond
+`{ rows, reports }` : un rapport par source, disant si elle a répondu et ce que
+son propre compte mesure, pour qu'une source en échec ne se lise jamais comme une
+source qui ne détient rien. `getRecipe(id)` répond `{ recipe, cached, read }`, et
+lève une erreur portant un des six codes. `client.profiles` énumère les sources
+que cette construction enregistre.
+
+La mise à l'échelle est publiée à part, sous `mcp-recipes/scale`, et travaille
+hors ligne sur n'importe quelle liste :
+
+```ts
+import { scaleIngredients } from "mcp-recipes/scale";
+
+scaleIngredients(["200 g de harina", "4 oeufs", "1 cup milk"], { factor: 2 });
 ```
 
-Chaque lecture répond `{ data, cached }`, et lève une erreur portant un des six
-codes. Chaque site garde son propre rythme, et le plancher tient également ici.
+Chaque site garde son propre rythme, et les planchers tiennent également ici.
 
 ## Rythme et attribution
 
 Chaque site est cadencé pour lui-même, une requête à la fois avec au moins une
 seconde entre deux, et le plancher d'une demi-seconde tient quelle que soit la
-configuration. Les interroger toutes à la fois coûte donc à chacune une requête,
+configuration. Deux des sites en demandent davantage, trois secondes entre deux
+requêtes, et ils l'obtiennent : un réglage posé pour toutes les sources peut
+élargir l'écart d'un site, jamais le réduire. Les interroger toutes à la fois coûte donc à chacune une requête,
 jamais deux. Le `User-Agent` se termine toujours par l'identité du projet et une
 adresse où joindre une personne.
 
@@ -619,7 +707,7 @@ Chaque ligne porte l'adresse de la page de la recette et le nom du site qui l'a
 publiée. Les pages du Cookbook sont publiées sous
 [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/deed.fr), qui
 demande que ce qu'on bâtit dessus soit partagé sous la même licence. Marmiton,
-Ptitchef, BBC Good Food et Supertoinette n'énoncent aucune condition sur une page
+Ptitchef, BBC Good Food, Supertoinette et Pequerecetas n'énoncent aucune condition sur une page
 de recette, et leurs recettes appartiennent à ces sites et aux cuisiniers qui les
 ont écrites. Le silence n'est pas une autorisation : créditez le site et liez la
 page d'où vient la recette.
@@ -641,7 +729,8 @@ lit.
 
 Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur
 votre machine, ne joint que `www.marmiton.org`, `api.wikimedia.org`,
-`www.ptitchef.com`, `www.bbcgoodfood.com` et `www.supertoinette.com`, garde ses réponses en mémoire le temps qu'il tourne, et
+`www.ptitchef.com`, `www.bbcgoodfood.com`, `www.supertoinette.com` et
+`www.pequerecetas.com`, garde ses réponses en mémoire le temps qu'il tourne, et
 n'écrit rien sur le disque. [PRIVACY.md](PRIVACY.md) dit ce qu'une requête
 emporte et quels réglages changent cela.