跳转到主要内容
DXRating.net
v1.7.127 (10小时前)

用 DXRating 开发

maimai DX 的歌曲、谱面与定数,供 AI 助手和你自己的程序使用。

MCP 服务器

连接 Claude、ChatGPT、Cursor 或任意 MCP 客户端。搜索歌曲、查询谱面、计算 Rating,无需写代码。

服务器 URL
https://mcp.dxrating.net/mcp
配置 MCP

REST API

从 dxdata 开始:所有歌曲、谱面、定数、标签和别名都在一个可缓存的 JSON 文档里。不需要账号,也不需要 API key。

从这里开始
https://miruku.dxrating.net/api/v1/dxdata
API 文档OpenAPI更新日志llms.txt

使用条款

数据
可自由使用,包括商用;欢迎注明来源。歌曲、曲绘与谱面的权利属于 SEGA 及各权利人,DXRating 不主张著作权。
署名示例
Data from DXRating (dxrating.net)
速率限制
MCP:每个客户端每分钟约 300 次请求。REST API:没有硬性限制,但请缓存响应,并用 If-None-Match 重新验证。dxdata、标签、别名和机厅列表都会返回 ETag。

API 稳定性

API v1 已是稳定版。在它上面做工具、bot 或网站时,可以依赖下面这些承诺。

兼容性
v1 内只做增量变更:新端点、可选参数、响应字段和枚举值。不认识的字段和值请忽略。删除或重命名、改变类型或含义,都算破坏性变更;修正数据(定数、曲名、日期、收录服务器)不算。
弃用
要下线的东西至少提前 6 个月通知。会在更新日志里公告,下线前响应会带上 Deprecation(RFC 9745)和 Sunset(RFC 8594)头。
新版本
破坏性变更放进新版本 /api/v2。v2 稳定后,v1 至少继续运行 12 个月。
稳定 ID
歌曲 ID(dsng_…)和谱面 ID(dsht_…)永久有效,不会复用。游戏里删除的歌曲和谱面会留在目录里,serverIds 变为空。如果两个条目其实是同一首歌,保留其中一个 ID,另一个不再复用;拆分时保留原 ID,并新增一个 ID。两种情况都会在更新日志里公告。
范围
覆盖无需登录的 dxdata、标签、别名和机厅。热门谱面和谱面图片尽力提供。需要 DXRating 账号的端点(评论、打标签、提交别名、导入成绩)只供 DXRating 自己的应用使用,随时可能变化。
接收通知
在 GitHub 上订阅更新日志 issue,每次新增字段、端点或弃用都会收到邮件。 更新日志
支持
问题、bug 和需求请提到 GitHub issue。 github.com/gekichumai/dxrating