MDN Web API 参考获取器

这个技能解决什么问题

当你需要批量整理 Web API 文档时，直接抓 MDN 网页会遇到两个麻烦：页面是渲染好的 HTML，字段散落在标签里，用正则解析迟早会崩；不同 API 的兼容性表格格式也不统一，想比较 fetch 和 XMLHttpRequest 在各浏览器的支持情况，只能逐个页面人工抄录。MDN Web API 参考获取器针对的正是这个场景——把「读文档」变成一次结构化的数据获取。

它如何工作

该技能通过 MDN Yari 内容 API 拉取文档。Yari 是 MDN 站点后端的内容接口，返回的本身就是机器可读的 JSON，因此不需要 HTML 解析环节。核心能力包括三块：

• 结构化 API 签名：直接给出函数、接口、属性的名称与参数定义，省去从正文里抠签名的步骤。
• 浏览器兼容性数据：兼容性表来自 BCD（Browser Compat Data），可以按浏览器版本过滤，不必去读表格里的文字描述。
• 代码示例：页面中的示例代码一并返回，可直接入库或渲染。

典型流程是：指定目标 API 或页面 → 调用 Yari API 获取 JSON → 索引签名、BCD 数据与示例 → 存入你自己的知识库。

适用边界

需要注意几点：它只覆盖 MDN 文档范围内的 Web 标准 API，Node.js 专有模块、各浏览器独有的非标准接口不在数据源里；文档的时效性取决于 MDN 本身的更新频率，拿到的兼容性数据反映的是抓取时点的快照；另外 Yari API 没有公开的速率承诺，做大规模批量索引时要自行控制请求节奏。