Search MDN web docs.

Searches MDN Web Docs (English) through the same search API the MDN search page uses: page title, summary, popularity and link. First page of up to 20 results, in relevance order.

No reports yetRead-only, no login

Site: MDN Web Docs, United States
Version: v1
Runs, last 7 days: No reports yet
sha256: 97e5cf61db85…

Run it with your agent

after installing Wield

Ask in plain words. Your agent finds this recipe and calls it:

“Search MDN web docs.”

Read-only: it changes nothing on the site. No login needed.

{
  "tool": "run",
  "arguments": {
    "recipe_id": "developer.mozilla.org/search-articles",
    "params": {
      "query": "fetch"
    }
  }
}

Requests

sent from your browser, in order

1GET/api/v1/search?locale&q&sizeMDN's public search API, read-only GET /api/v1/search?q=...; no key needed.

Parameters

from your agent

querystringrequiredSearch term, e.g. 'fetch', 'flexbox', 'array.map', 'grid template areas'

Returns

to your agent

articlesobject[]popularity, summary, title, url

querystring

Where it can send

developer.mozilla.org

Anything else is blocked by the extension.

Reads from your session

Nothing. Your browser attaches the site's cookies by itself.

Used only in requests to the addresses on the left. Never sent to wield.run or your agent.

Checks

a run passes when

length(output.articles) > `0`
length(output.articles[?title != `null`]) == length(output.articles)
length(output.articles[?starts_with(url, 'https://developer.mozilla.org/en-US/docs/')]) == length(output.articles)

Raw recipe

Served as canonical JSON from /api/v1/recipes/developer.mozilla.org/search-articles, so its sha256 matches the ETag and the index.

Check it yourself

curl -s https://wield.run/api/v1/recipes/developer.mozilla.org/search-articles | shasum -a 256
# 97e5cf61db851edf54d1d6b0c6ddeaa567f7c868713b9da1d81f8c06df592837

developer.mozilla.org/search-articles.json, v1

{
  "description": "Searches MDN Web Docs (English) through the same search API the MDN search page uses: page title, summary, popularity and link. First page of up to 20 results, in relevance order.",
  "effect": "read",
  "id": "developer.mozilla.org/search-articles",
  "keywords": [
    "mdn",
    "mdn web docs",
    "developer.mozilla.org",
    "mozilla",
    "web docs",
    "javascript",
    "css",
    "html",
    "web api",
    "documentation",
    "reference",
    "dokumentation",
    "webentwicklung",
    "search"
  ],
  "output": {
    "schema": {
      "properties": {
        "articles": {
          "items": {
            "properties": {
              "popularity": {
                "description": "MDN's page popularity, 0 to 1",
                "type": [
                  "number",
                  "null"
                ]
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "type": "string"
        }
      },
      "required": [
        "query",
        "articles"
      ],
      "type": "object"
    },
    "value": "{query: params.query, articles: steps.search.documents[?title != `null` && mdn_url != `null`].{title: title, summary: summary || `null`, url: join('', ['https://developer.mozilla.org', mdn_url]), popularity: popularity || `null`}}"
  },
  "params": {
    "additionalProperties": false,
    "properties": {
      "query": {
        "description": "Search term, e.g. 'fetch', 'flexbox', 'array.map', 'grid template areas'",
        "maxLength": 100,
        "minLength": 2,
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "provenance": {
    "method": "har",
    "notes": "GET /api/v1/search?q=...&locale=en-US returns JSON with a documents array (mdn_url, title, summary, popularity). It is the public API the MDN search page reads; no key or cookie. Highlight markup is not returned.",
    "recorded_at": "2026-11-08T12:10:00.000Z",
    "recorded_by": "wield-forge (claude-haiku agent)"
  },
  "requires_login": false,
  "schema": "https://wield.run/schema/recipe/v1.json",
  "site": {
    "country": "US",
    "id": "developer.mozilla.org",
    "language": "en",
    "name": "MDN Web Docs",
    "origin": "https://developer.mozilla.org",
    "origins": [
      "https://developer.mozilla.org"
    ]
  },
  "steps": [
    {
      "description": "MDN's public search API, read-only GET /api/v1/search?q=...; no key needed.",
      "expect": {
        "content_type": "json",
        "status": [
          200
        ]
      },
      "extract": {
        "json": {
          "documents": "documents"
        }
      },
      "id": "search",
      "request": {
        "headers": {
          "Accept": "application/json"
        },
        "method": "GET",
        "query": {
          "locale": "en-US",
          "q": "{{params.query}}",
          "size": 20
        },
        "url": "/api/v1/search"
      }
    }
  ],
  "task": "Search MDN web docs",
  "tos": {
    "notes": "Not reviewed. One search page per call, the same page a visitor loads. The site's terms on automated access were not checked.",
    "reviewed": false
  },
  "verify": {
    "checks": [
      "length(output.articles) > `0`",
      "length(output.articles[?title != `null`]) == length(output.articles)",
      "length(output.articles[?starts_with(url, 'https://developer.mozilla.org/en-US/docs/')]) == length(output.articles)"
    ],
    "example_params": {
      "query": "fetch"
    },
    "max_ms": 5000
  },
  "version": 1
}