{"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}