@webmcp-auto-ui/agent 2.5.8 → 2.5.10

package/src/recipes/afficher-oeuvres-art-collection-musee.md

@@ -1,48 +1,48 @@
 ---
 id: afficher-oeuvres-art-collection-musee
-name: Afficher les oeuvres d'art d'une collection de musee en galerie visuelle
+name: Display artworks from a museum collection in a visual gallery
 components_used: [gallery, cards, kv, stat-card]
-when: l'utilisateur demande des oeuvres d'art, des collections de musee, des tableaux, sculptures ou objets d'art du Metropolitan Museum of Art
+when: the user asks for artworks, museum collections, paintings, sculptures, or art objects from the Metropolitan Museum of Art
 servers: [metmuseum]
 layout:
   type: grid
   columns: 2
-  arrangement: stats en haut, galerie pleine largeur au centre, details en bas
+  arrangement: stats at top, full-width gallery in the center, details at the bottom
 ---
 
-## Quand utiliser
+## When to use
 
-L'utilisateur s'interesse a des oeuvres d'art ou des collections de musee :
-- "Montre-moi des tableaux impressionnistes du Met Museum"
-- "Les sculptures grecques du Metropolitan"
-- "Quelles oeuvres de Van Gogh sont au Met ?"
-- "Les oeuvres d'art egyptien du musee"
-- "Cherche des estampes japonaises"
+The user is interested in artworks or museum collections:
+- "Show me Impressionist paintings from the Met Museum"
+- "Greek sculptures at the Metropolitan"
+- "What Van Gogh works are at the Met?"
+- "Egyptian art objects from the museum"
+- "Search for Japanese woodblock prints"
 
-Le serveur Met Museum donne acces a la collection du Metropolitan Museum of Art de New York (plus de 470 000 oeuvres, dont beaucoup avec images en domaine public).
+The Met Museum server provides access to the Metropolitan Museum of Art collection in New York (more than 470,000 objects, many with public domain images).
 
-## Comment
+## How to use
 
-1. **Rechercher les oeuvres** par theme, artiste ou departement :
+1. **Search for artworks** by theme, artist, or department:
    ```
    search_objects({query: "impressionism sunflower", hasImages: true})
    ```
-   Retourne une liste d'`objectID`s.
+   Returns a list of `objectID`s.
 
-2. **Recuperer les details** de chaque oeuvre (limiter a 5-10 pour la performance) :
+2. **Fetch the details** of each artwork (limit to 5-10 for performance):
    ```
    get_object({objectID: 436524})
    ```
-   Retourne : `title`, `artistDisplayName`, `primaryImage`, `objectDate`, `medium`, `department`, `culture`, etc.
+   Returns: `title`, `artistDisplayName`, `primaryImage`, `objectDate`, `medium`, `department`, `culture`, etc.
 
-3. **Afficher les statistiques** de la recherche :
+3. **Display search statistics**:
    ```
-   component("stat-card", {label: "Resultats", value: total, icon: "image"})
-   component("stat-card", {label: "Avec image", value: withImage, icon: "camera"})
-   component("stat-card", {label: "Domaine public", value: publicDomain, icon: "unlock"})
+   component("stat-card", {label: "Results", value: total, icon: "image"})
+   component("stat-card", {label: "With image", value: withImage, icon: "camera"})
+   component("stat-card", {label: "Public domain", value: publicDomain, icon: "unlock"})
    ```
 
-4. **Galerie des oeuvres** avec images haute definition :
+4. **Artwork gallery** with high-resolution images:
    ```
    component("gallery", {
      images: objects
@@ -55,64 +55,64 @@ Le serveur Met Museum donne acces a la collection du Metropolitan Museum of Art
    })
    ```
 
-5. **Fiches detaillees** en cards pour les oeuvres principales :
+5. **Detailed cards** for the main artworks:
    ```
    component("cards", {
      items: objects.map(o => ({
        title: o.title,
-       subtitle: o.artistDisplayName || "Artiste inconnu",
+       subtitle: o.artistDisplayName || "Unknown artist",
        image: o.primaryImageSmall,
        body: [o.objectDate, o.medium, o.department].filter(Boolean).join(" — ")
      }))
    })
    ```
 
-6. **Details d'une oeuvre specifique** en kv :
+6. **Details of a specific artwork** in kv:
    ```
    component("kv", {pairs: [
-     ["Titre", obj.title],
-     ["Artiste", obj.artistDisplayName],
+     ["Title", obj.title],
+     ["Artist", obj.artistDisplayName],
      ["Date", obj.objectDate],
      ["Medium", obj.medium],
      ["Dimensions", obj.dimensions],
-     ["Departement", obj.department],
+     ["Department", obj.department],
      ["Culture", obj.culture],
      ["Credit", obj.creditLine],
-     ["Domaine public", obj.isPublicDomain ? "Oui" : "Non"]
+     ["Public domain", obj.isPublicDomain ? "Yes" : "No"]
    ]})
    ```
 
-## Exemples
+## Examples
 
-### Tableaux de Van Gogh
+### Van Gogh paintings
 ```
-// 1. Recherche
+// 1. Search
 search_objects({query: "van gogh", hasImages: true})  // → [436532, 436529, ...]
 
-// 2. Details (premiers 8 resultats)
+// 2. Details (first 8 results)
 objectIDs.slice(0, 8).forEach(id => get_object({objectID: id}))
 
-// 3. Rendu
-component("stat-card", {label: "Oeuvres de Van Gogh", value: "8", icon: "palette"})
+// 3. Render
+component("stat-card", {label: "Van Gogh works", value: "8", icon: "palette"})
 component("gallery", {images: vanGoghWorks.map(w => ({src: w.primaryImageSmall, alt: w.title, caption: w.objectDate}))})
 component("cards", {items: vanGoghWorks.map(w => ({title: w.title, subtitle: w.objectDate, image: w.primaryImageSmall, body: w.medium}))})
 ```
 
-### Art egyptien
+### Egyptian art
 ```
-// 1. Recherche par departement
+// 1. Search by department
 search_objects({query: "egypt pharaoh", departmentId: 10, hasImages: true})
 
-// 2. Rendu avec metadonnees culturelles
+// 2. Render with cultural metadata
 component("gallery", {images: egyptWorks.map(w => ({src: w.primaryImageSmall, alt: w.title}))})
-component("table", {columns: ["Titre", "Periode", "Culture", "Medium"], rows: egyptDetails})
-component("kv", {pairs: [["Departement", "Egyptian Art"], ["Source", "Met Museum — Open Access"]]})
+component("table", {columns: ["Title", "Period", "Culture", "Medium"], rows: egyptDetails})
+component("kv", {pairs: [["Department", "Egyptian Art"], ["Source", "Met Museum — Open Access"]]})
 ```
 
-## Erreurs courantes
+## Common mistakes
 
-- **Trop d'appels `get_object`** : la recherche retourne parfois des centaines d'IDs — limiter a 5-10 appels detail pour la performance
-- **Oeuvres sans image** : beaucoup d'objets Met n'ont pas de `primaryImage` — toujours filtrer avec `hasImages: true` dans la recherche ou verifier le champ
-- **Images haute resolution cassees** : utiliser `primaryImageSmall` (web-large) pour la galerie et les cards — les URLs `primaryImage` (original) retournent souvent des 404
-- **Oublier la licence** : les oeuvres en domaine public (`isPublicDomain: true`) peuvent etre affichees librement, les autres ont un champ `rights` a respecter
-- **Artiste inconnu** : beaucoup d'oeuvres anciennes n'ont pas d'`artistDisplayName` — afficher "Artiste inconnu" ou la culture/periode a la place
+- **Too many `get_object` calls**: a search sometimes returns hundreds of IDs — limit to 5-10 detail calls for performance
+- **Artworks without images**: many Met objects have no `primaryImage` — always filter with `hasImages: true` in the search or check the field
+- **Broken high-resolution images**: use `primaryImageSmall` (web-large) for the gallery and cards — `primaryImage` (original) URLs often return 404s
+- **Forgetting the license**: works in the public domain (`isPublicDomain: true`) can be displayed freely; others have a `rights` field to respect
+- **Unknown artist**: many ancient works have no `artistDisplayName` — display "Unknown artist" or the culture/period instead

package/src/recipes/analyser-actualites-hacker-news.md

@@ -1,59 +1,59 @@
 ---
 id: analyser-actualites-hacker-news
-name: Analyser les actualites et tendances Hacker News en tableau et graphiques
+name: Analyze Hacker News news and trends with tables and charts
 components_used: [table, chart, stat-card, cards]
-when: l'utilisateur demande les actualites tech, les tendances Hacker News, les top stories, ou une analyse des discussions et commentaires HN
+when: the user asks for tech news, Hacker News trends, top stories, or an analysis of HN discussions and comments
 servers: [hackernews]
 layout:
   type: grid
   columns: 2
-  arrangement: stats en ligne, table pleine largeur, chart en bas
+  arrangement: stats in a row, full-width table, chart at the bottom
 ---
 
-## Quand utiliser
+## When to use
 
-L'utilisateur s'interesse aux actualites technologiques ou aux tendances de la communaute Hacker News :
-- "Quelles sont les top stories Hacker News ?"
-- "Montre-moi les posts les plus commentes aujourd'hui"
-- "Les tendances tech de la semaine sur HN"
-- "Analyse les Ask HN recents"
-- "Quels sujets dominent Hacker News en ce moment ?"
+The user is interested in technology news or Hacker News community trends:
+- "What are the top Hacker News stories?"
+- "Show me the most commented posts today"
+- "This week's tech trends on HN"
+- "Analyze recent Ask HN posts"
+- "What topics are dominating Hacker News right now?"
 
-Le serveur Hacker News donne acces aux stories, commentaires, classements et metadonnees de posts.
+The Hacker News server provides access to stories, comments, rankings, and post metadata.
 
-## Comment
+## How to use
 
-1. **Recuperer les top stories** :
+1. **Fetch the top stories**:
    ```
    get_top_stories({limit: 30})
    ```
-   Retourne les IDs des stories les plus populaires.
+   Returns the IDs of the most popular stories.
 
-2. **Recuperer les details** de chaque story :
+2. **Fetch the details** of each story:
    ```
    get_item({id: storyId})
    ```
-   Retourne : `title`, `url`, `score`, `by` (auteur), `descendants` (nb commentaires), `time`, `type`.
+   Returns: `title`, `url`, `score`, `by` (author), `descendants` (comment count), `time`, `type`.
 
-3. **Afficher les KPIs** en stat-cards :
+3. **Display KPIs** in stat-cards:
    ```
    component("stat-card", {label: "Top Stories", value: "30", icon: "newspaper"})
-   component("stat-card", {label: "Score moyen", value: Math.round(avgScore), icon: "trending-up"})
-   component("stat-card", {label: "Commentaires moyen", value: Math.round(avgComments), icon: "message-circle"})
-   component("stat-card", {label: "Score max", value: maxScore + " pts", icon: "award"})
+   component("stat-card", {label: "Average score", value: Math.round(avgScore), icon: "trending-up"})
+   component("stat-card", {label: "Average comments", value: Math.round(avgComments), icon: "message-circle"})
+   component("stat-card", {label: "Max score", value: maxScore + " pts", icon: "award"})
    ```
 
-4. **Tableau des stories** trie par score :
+4. **Stories table** sorted by score:
    ```
    component("table", {
-     columns: ["#", "Titre", "Score", "Commentaires", "Auteur"],
+     columns: ["#", "Title", "Score", "Comments", "Author"],
      rows: stories.sort((a, b) => b.score - a.score).map((s, i) => [
        i + 1, s.title, s.score, s.descendants, s.by
      ])
    })
    ```
 
-5. **Graphique de distribution** des scores :
+5. **Score distribution chart**:
    ```
    component("chart", {
      type: "bar",
@@ -62,66 +62,66 @@ Le serveur Hacker News donne acces aux stories, commentaires, classements et met
    })
    ```
 
-6. **Cards pour les stories vedettes** (top 5) :
+6. **Cards for featured stories** (top 5):
    ```
    component("cards", {
      items: top5.map(s => ({
        title: s.title,
        subtitle: s.by + " — " + s.score + " points",
-       body: s.descendants + " commentaires | " + new Date(s.time * 1000).toLocaleDateString(),
+       body: s.descendants + " comments | " + new Date(s.time * 1000).toLocaleDateString(),
        url: s.url
      }))
    })
    ```
 
-## Exemples
+## Examples
 
-### Top 10 stories du moment
+### Top 10 stories right now
 ```
-// 1. Recuperer
+// 1. Fetch
 get_top_stories({limit: 10})
-// Pour chaque ID: get_item({id})
+// For each ID: get_item({id})
 
-// 2. Rendu
-component("stat-card", {label: "Score total", value: totalScore, icon: "zap"})
-component("stat-card", {label: "Commentaires total", value: totalComments, icon: "message-circle"})
+// 2. Render
+component("stat-card", {label: "Total score", value: totalScore, icon: "zap"})
+component("stat-card", {label: "Total comments", value: totalComments, icon: "message-circle"})
 component("table", {
-  columns: ["Rang", "Titre", "Score", "Commentaires", "Auteur", "Age"],
+  columns: ["Rank", "Title", "Score", "Comments", "Author", "Age"],
   rows: rankedStories
 })
 component("cards", {items: top3Stories})
 ```
 
-### Analyse Ask HN
+### Ask HN analysis
 ```
-// 1. Rechercher les Ask HN recents
+// 1. Fetch recent Ask HN posts
 get_ask_stories({limit: 20})
 
-// 2. Rendu
-component("stat-card", {label: "Ask HN recents", value: "20", icon: "help-circle"})
-component("stat-card", {label: "Reponses moyennes", value: avgReplies, icon: "message-circle"})
-component("table", {columns: ["Titre", "Reponses", "Score", "Auteur"], rows: askStories})
-component("chart", {type: "bar", labels: titles, datasets: [{label: "Reponses", data: replyCounts}]})
+// 2. Render
+component("stat-card", {label: "Recent Ask HN", value: "20", icon: "help-circle"})
+component("stat-card", {label: "Average replies", value: avgReplies, icon: "message-circle"})
+component("table", {columns: ["Title", "Replies", "Score", "Author"], rows: askStories})
+component("chart", {type: "bar", labels: titles, datasets: [{label: "Replies", data: replyCounts}]})
 ```
 
-### Tendances par domaine
+### Trends by domain
 ```
-// 1. Recuperer top stories et extraire les domaines des URLs
+// 1. Fetch top stories and extract domains from URLs
 get_top_stories({limit: 50})
 
-// 2. Grouper par domaine
+// 2. Group by domain
 const domains = groupBy(stories, s => new URL(s.url).hostname)
 
-// 3. Rendu
-component("stat-card", {label: "Domaines uniques", value: Object.keys(domains).length, icon: "globe"})
+// 3. Render
+component("stat-card", {label: "Unique domains", value: Object.keys(domains).length, icon: "globe"})
 component("chart", {type: "bar", labels: topDomains.map(d => d.name), datasets: [{label: "Stories", data: topDomains.map(d => d.count)}]})
-component("table", {columns: ["Domaine", "Stories", "Score total"], rows: domainStats})
+component("table", {columns: ["Domain", "Stories", "Total score"], rows: domainStats})
 ```
 
-## Erreurs courantes
+## Common mistakes
 
-- **Trop d'appels `get_item`** : chaque story necessite un appel individuel — limiter a 20-30 pour eviter la lenteur
-- **Timestamps non convertis** : HN retourne des timestamps Unix — convertir en dates lisibles
-- **Titres tronques dans les graphiques** : les titres HN sont longs — tronquer a 30-40 caracteres pour les labels de graphiques
-- **Oublier les stories sans URL** : les "Ask HN", "Show HN" et "Tell HN" n'ont pas toujours d'URL externe — gerer ce cas
-- **Ne pas distinguer les types** : HN a des stories, jobs, polls — filtrer par type si l'utilisateur demande un type specifique
+- **Too many `get_item` calls**: each story requires an individual call — limit to 20-30 to avoid slowness
+- **Unconverted timestamps**: HN returns Unix timestamps — convert them to human-readable dates
+- **Truncated titles in charts**: HN titles are long — truncate to 30-40 characters for chart labels
+- **Forgetting stories without a URL**: "Ask HN", "Show HN", and "Tell HN" posts don't always have an external URL — handle this case
+- **Not distinguishing types**: HN has stories, jobs, and polls — filter by type if the user asks for a specific type

package/src/recipes/cartographier-observations-biodiversite.md

@@ -1,38 +1,38 @@
 ---
-id: cartographier-observations-biodiversite
-name: Cartographier les observations de biodiversite sur une zone geographique
+id: map-biodiversity-observations
+name: Map biodiversity observations on a geographic area
 components_used: [map, gallery, table, stat-card]
-when: l'utilisateur demande une carte des observations naturalistes, la biodiversite d'une zone, les especes presentes dans un lieu, ou les observations iNaturalist d'une region
+when: the user asks for a map of naturalist observations, the biodiversity of an area, the species present in a location, or iNaturalist observations in a region
 servers: [inaturalist]
 layout:
   type: grid
   columns: 2
-  arrangement: carte pleine largeur en haut, galerie + stats en dessous
+  arrangement: full-width map at top, gallery + stats below
 ---
 
-## Quand utiliser
+## When to use
 
-L'utilisateur pose une question sur la biodiversite d'un lieu ou demande une carte des observations :
-- "Quelles especes d'oiseaux observe-t-on a Paris ?"
-- "Montre-moi une carte des observations de papillons dans les Alpes"
-- "Quelle est la biodiversite autour du lac d'Annecy ?"
-- "Les especes menacees observees en Ile-de-France"
+The user asks a question about the biodiversity of a location or requests a map of observations:
+- "What bird species are observed in Paris?"
+- "Show me a map of butterfly observations in the Alps"
+- "What is the biodiversity around Lake Annecy?"
+- "Endangered species observed in Ile-de-France"
 
-Le serveur iNaturalist fournit des observations georeferencees avec photos, taxons, dates et observateurs.
+The iNaturalist server provides georeferenced observations with photos, taxa, dates, and observers.
 
-## Comment
+## How to use
 
-1. **Rechercher les observations** dans la zone cible :
+1. **Search for observations** in the target area:
    ```
    search_observations({lat: 48.85, lng: 2.35, radius: 10, taxon_name: "Aves", per_page: 50})
    ```
-   Parametres utiles :
-   - `lat`, `lng`, `radius` : centre et rayon de la zone en km
-   - `taxon_name` : filtre taxonomique ("Aves", "Lepidoptera", "Mammalia", etc.)
-   - `quality_grade` : "research" pour les observations verifiees
-   - `per_page` : nombre de resultats (max 200)
+   Useful parameters:
+   - `lat`, `lng`, `radius`: center and radius of the area in km
+   - `taxon_name`: taxonomic filter ("Aves", "Lepidoptera", "Mammalia", etc.)
+   - `quality_grade`: "research" for verified observations
+   - `per_page`: number of results (max 200)
 
-2. **Afficher la carte** avec les marqueurs d'observation :
+2. **Display the map** with observation markers:
    ```
    component("map", {
      center: [48.85, 2.35],
@@ -46,15 +46,15 @@ Le serveur iNaturalist fournit des observations georeferencees avec photos, taxo
    })
    ```
 
-3. **Statistiques de la zone** en stat-cards :
+3. **Area statistics** in stat-cards:
    ```
    component("stat-card", {label: "Observations", value: total_results, icon: "eye"})
-   component("stat-card", {label: "Especes uniques", value: uniqueSpecies.length, icon: "leaf"})
-   component("stat-card", {label: "Observateurs", value: uniqueObservers.length, icon: "users"})
-   component("stat-card", {label: "Grade recherche", value: researchGradeCount, icon: "check-circle"})
+   component("stat-card", {label: "Unique species", value: uniqueSpecies.length, icon: "leaf"})
+   component("stat-card", {label: "Observers", value: uniqueObservers.length, icon: "users"})
+   component("stat-card", {label: "Research grade", value: researchGradeCount, icon: "check-circle"})
    ```
 
-4. **Galerie des especes avec photos** :
+4. **Species gallery with photos**:
    ```
    component("gallery", {
      images: observations
@@ -67,45 +67,45 @@ Le serveur iNaturalist fournit des observations georeferencees avec photos, taxo
    })
    ```
 
-5. **Tableau recapitulatif** des especes :
+5. **Summary table** of species:
    ```
    component("table", {
-     columns: ["Espece", "Nom scientifique", "Observations", "Derniere obs."],
+     columns: ["Species", "Scientific name", "Observations", "Last obs."],
      rows: speciesSummary
    })
    ```
 
-## Exemples
+## Examples
 
-### Oiseaux de Paris
+### Birds of Paris
 ```
-// 1. Recherche
+// 1. Search
 search_observations({lat: 48.8566, lng: 2.3522, radius: 10, taxon_name: "Aves", quality_grade: "research", per_page: 100})
 
-// 2. Rendu
+// 2. Render
 component("map", {center: [48.8566, 2.3522], zoom: 12, markers: birdMarkers})
-component("stat-card", {label: "Especes d'oiseaux", value: "47", icon: "bird"})
-component("stat-card", {label: "Observations verifiees", value: "312", icon: "check"})
+component("stat-card", {label: "Bird species", value: "47", icon: "bird"})
+component("stat-card", {label: "Verified observations", value: "312", icon: "check"})
 component("gallery", {images: birdPhotos})
-component("table", {columns: ["Espece", "Observations", "Derniere"], rows: birdSummary})
+component("table", {columns: ["Species", "Observations", "Last"], rows: birdSummary})
 ```
 
-### Papillons des Alpes
+### Butterflies in the Alps
 ```
-// 1. Zone large autour de Chamonix
+// 1. Wide area around Chamonix
 search_observations({lat: 45.9237, lng: 6.8694, radius: 30, taxon_name: "Lepidoptera", per_page: 100})
 
-// 2. Rendu avec clustering sur la carte
+// 2. Render with clustering on the map
 component("map", {center: [45.9237, 6.8694], zoom: 10, markers: butterflyMarkers, cluster: true})
-component("stat-card", {label: "Especes de papillons", value: uniqueSpecies.length})
+component("stat-card", {label: "Butterfly species", value: uniqueSpecies.length})
 component("gallery", {images: butterflyPhotos})
-component("table", {columns: ["Espece", "Altitude", "Mois", "Observateur"], rows: enrichedData})
+component("table", {columns: ["Species", "Altitude", "Month", "Observer"], rows: enrichedData})
 ```
 
-## Erreurs courantes
+## Common mistakes
 
-- **Rayon trop large** : un rayon de 100 km retourne trop de resultats et noie l'information — preferer 5-20 km et augmenter si peu de resultats
-- **Thumbnails iNaturalist** : les URLs par defaut sont en format "square" (75x75) — remplacer "square" par "medium" (200px) ou "large" (500px)
-- **Pas de filtre taxonomique** : sans filtre, iNaturalist retourne plantes + animaux + champignons ensemble — toujours filtrer par groupe si l'utilisateur en mentionne un
-- **Oublier le grade de qualite** : les observations "casual" peuvent etre mal identifiees — preferer `quality_grade: "research"` pour des donnees fiables
-- **Carte sans zoom adapte** : ajuster le zoom en fonction du rayon de recherche (5 km → zoom 13, 20 km → zoom 11, 50 km → zoom 9)
+- **Radius too large**: a 100 km radius returns too many results and buries the information — prefer 5-20 km and increase if few results are found
+- **iNaturalist thumbnails**: default URLs are in "square" format (75x75) — replace "square" with "medium" (200px) or "large" (500px)
+- **No taxonomic filter**: without a filter, iNaturalist returns plants + animals + fungi together — always filter by group if the user mentions one
+- **Forgetting the quality grade**: "casual" observations may be misidentified — prefer `quality_grade: "research"` for reliable data
+- **Map with wrong zoom level**: adjust zoom based on the search radius (5 km → zoom 13, 20 km → zoom 11, 50 km → zoom 9)