MC Mod/插件搜索

GETPOST 我的世界

搜索Minecraft Mod和服务器插件，同时检索Modrinth（Fabric/Forge/NeoForge Mod、光影包、资源包、整合包）和SpigotMC（Bukkit/Spigot/Paper插件）

GET https://api.tinyaii.cn/v1/mc/mod-search

请求参数

参数名类型必填说明示例
keywordstring必填搜索关键词—
sourcestring可选平台筛选：modrinth（Mod/光影/资源包/整合包）/ spigot（服务端插件），不填则搜全部—
typestring可选Modrinth资源类型：mod / shader（光影包）/ resourcepack（资源包）/ modpack（整合包），不填则搜全部类型—
limitinteger可选每个平台返回数量（1-20，默认5）—

返回字段

字段类型说明
data.keywordstring搜索关键词
data.modrinth_totalintegerModrinth匹配总数
data.modrinth[].titlestring项目名称
data.modrinth[].descriptionstring项目简介
data.modrinth[].authorstring作者
data.modrinth[].project_typestring项目类型（Mod/光影包/资源包/整合包）
data.modrinth[].downloadsinteger下载量
data.modrinth[].categoriesarray分类标签（fabric/forge/neoforge等）
data.modrinth[].versionsarray支持的MC版本
data.modrinth[].icon_urlstring项目图标URL
data.modrinth[].project_urlstring项目主页URL
data.spigot[].namestring插件名称
data.spigot[].descriptionstring插件简介
data.spigot[].authorstring作者
data.spigot[].downloadsinteger下载量
data.spigot[].ratingnumber评分（1-5）
data.spigot[].tested_versionsarray测试通过的MC版本
data.spigot[].project_urlstring插件主页URL

返回示例

{
  "code": 200,
  "data": {
    "keyword": "essentials",
    "modrinth_total": 438,
    "modrinth_count": 3,
    "modrinth": [
      {
        "title": "Inventory Essentials",
        "description": "...",
        "author": "BlayTheNinth",
        "project_type": "Mod",
        "downloads": 1783170,
        "categories": [
          "fabric",
          "forge"
        ],
        "versions": [
          "1.20.4"
        ],
        "project_url": "https://modrinth.com/mod/inventory-essentials"
      }
    ],
    "spigot_count": 3,
    "spigot": [
      {
        "name": "EssentialsX",
        "description": "The modern Essentials suite",
        "author": "EssentialsX",
        "downloads": 5859656,
        "rating": 4.5,
        "tested_versions": [
          "1.20",
          "1.21"
        ],
        "project_url": "https://www.spigotmc.org/resources/..."
      }
    ]
  },
  "message": "success"
}

调用示例

curl "https://api.tinyaii.cn/v1/mc/mod-search?keyword=<keyword>" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/mc/mod-search?keyword=<keyword>", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/mc/mod-search",
    params={"keyword": "<keyword>"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。