wield-mcp 0.0.0-stage → 0.1.2

package/dist/extension/sample-recipe.json

@@ -0,0 +1,218 @@
+{
+  "schema": "https://wield.run/schema/recipe/v1.json",
+  "id": "chefkoch.de/search-recipes",
+  "version": 2,
+  "site": {
+    "id": "chefkoch.de",
+    "name": "Chefkoch",
+    "origin": "https://www.chefkoch.de",
+    "origins": [
+      "https://api.chefkoch.de"
+    ],
+    "country": "DE",
+    "language": "de",
+    "login_url": "https://www.chefkoch.de/benutzer/einloggen"
+  },
+  "task": "Search cooking recipes with rating, difficulty and preparation time",
+  "description": "Searches Chefkoch, Germany's largest recipe site, like the site's own search: title, short description, star rating and number of votes, difficulty, preparation time, video flag, whether it is paywalled (Chefkoch Plus), image and link. Sponsored brand recipes are dropped by default.",
+  "keywords": [
+    "chefkoch",
+    "rezept",
+    "rezepte",
+    "kochen",
+    "backen",
+    "abendessen",
+    "vegetarisch",
+    "lasagne",
+    "recipe",
+    "recipes",
+    "cooking",
+    "what to cook",
+    "dinner ideas"
+  ],
+  "effect": "read",
+  "requires_login": false,
+  "params": {
+    "type": "object",
+    "properties": {
+      "query": {
+        "type": "string",
+        "minLength": 2,
+        "maxLength": 100,
+        "description": "Dish or ingredients, e.g. 'lasagne', 'kürbissuppe', 'vegan schnell'"
+      },
+      "limit": {
+        "type": "integer",
+        "enum": [
+          10,
+          20,
+          50
+        ],
+        "default": 20
+      },
+      "page": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 20,
+        "default": 1
+      },
+      "include_sponsored": {
+        "type": "boolean",
+        "default": false,
+        "description": "Keep brand-campaign recipes (marked sponsored)"
+      }
+    },
+    "required": [
+      "query"
+    ],
+    "additionalProperties": false
+  },
+  "steps": [
+    {
+      "id": "search",
+      "description": "Chefkoch's public search gateway, cross-origin from www.chefkoch.de (CORS allows it). The one-item foreach only computes the offset.",
+      "foreach": {
+        "in": "[{offset: (params.page - `1`) * params.limit}]",
+        "as": "pg",
+        "max": 1
+      },
+      "request": {
+        "method": "GET",
+        "url": "https://api.chefkoch.de/v2/search-gateway/recipes",
+        "query": {
+          "query": "{{params.query}}",
+          "limit": "{{params.limit}}",
+          "offset": "{{pg.offset}}"
+        },
+        "headers": {
+          "Accept": "application/json"
+        },
+        "credentials": "omit"
+      },
+      "expect": {
+        "status": [
+          200
+        ],
+        "content_type": "json",
+        "assert": "body.results != null"
+      },
+      "extract": {
+        "json": {
+          "total": "count",
+          "recipes": "results[].recipe.{id: id, title: title, subtitle: subtitle || `null`, rating: rating.rating || `null`, votes: rating.numVotes || `0`, difficulty: difficulty == `1` && 'simple' || (difficulty == `2` && 'normal' || (difficulty == `3` && 'advanced' || `null`)), prep_time_min: preparationTime || `null`, has_video: hasVideo == `true`, plus_only: isPlus == `true`, sponsored: campaign != `null`, image_url: previewImageUrlTemplate && replace(previewImageUrlTemplate, '<format>', 'crop-480x360') || `null`, url: siteUrl}"
+        }
+      }
+    }
+  ],
+  "output": {
+    "schema": {
+      "type": "object",
+      "required": [
+        "query",
+        "total",
+        "recipes"
+      ],
+      "properties": {
+        "query": {
+          "type": "string"
+        },
+        "total": {
+          "type": "integer"
+        },
+        "page": {
+          "type": "integer"
+        },
+        "recipes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              },
+              "subtitle": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "rating": {
+                "type": [
+                  "number",
+                  "null"
+                ],
+                "description": "0-5 stars"
+              },
+              "votes": {
+                "type": "integer"
+              },
+              "difficulty": {
+                "enum": [
+                  "simple",
+                  "normal",
+                  "advanced",
+                  null
+                ]
+              },
+              "prep_time_min": {
+                "type": [
+                  "integer",
+                  "null"
+                ],
+                "description": "Active preparation time in minutes"
+              },
+              "has_video": {
+                "type": "boolean"
+              },
+              "plus_only": {
+                "type": "boolean",
+                "description": "Full recipe needs a Chefkoch Plus subscription"
+              },
+              "sponsored": {
+                "type": "boolean"
+              },
+              "image_url": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "url": {
+                "type": "string",
+                "format": "uri"
+              }
+            }
+          }
+        }
+      }
+    },
+    "value": "let $sp = params.include_sponsored in {query: params.query, total: steps.search[0].total, page: params.page, recipes: steps.search[0].recipes[?$sp || !sponsored]}"
+  },
+  "verify": {
+    "example_params": {
+      "query": "lasagne",
+      "limit": 10
+    },
+    "checks": [
+      "length(output.recipes) > `5`",
+      "output.total > `100`",
+      "output.recipes[0].rating > `0`",
+      "starts_with(output.recipes[0].url, 'https://www.chefkoch.de/rezepte/')",
+      "length(output.recipes[?sponsored]) == `0`"
+    ],
+    "max_ms": 3000
+  },
+  "provenance": {
+    "method": "browser-inspect",
+    "recorded_at": "2026-11-07T12:27:00+01:00",
+    "recorded_by": "C4",
+    "notes": "spikes/chefkoch.md. Public JSON search gateway used by chefkoch.de; CORS allows https://www.chefkoch.de (with credentials) and no cookies or tokens are needed, so credentials omit. Non-null campaign = brand-sponsored recipe; isPlus = paywalled. difficulty 1/2/3 = simpel/normal/pfiffig. v2 (2026-11-07 22:38): tos.notes only; requests and output unchanged."
+  },
+  "tos": {
+    "reviewed": false,
+    "notes": "Chefkoch's robots.txt disallows AI training crawlers (ClaudeBot, anthropic-ai, Claude-Web). Chefkoch's terms restrict automated use of its content. One user-initiated search at a time from the user's browser (1 request); recipe texts stay on chefkoch.de via the link."
+  }
+}