{
"author": {
"name": "UAPI"
},
"description": "Uapi Mcp 是 uapis.cn 的官方MCP。它把 UAPI 的搜索、翻译、图像、文本处理和网页解析能力整理成统一的 MCP Server，让你的ai拥有无限的能力~",
"display_name": "Uapi Mcp",
"keywords": [
"uapi",
"mcp"
],
"long_description": "Uapi Mcp 是 uapis.cn 的官方MCP。它把 UAPI 的搜索、翻译、图像、文本处理和网页解析能力整理成统一的 MCP Server，让你的ai拥有无限的能力~",
"manifest_version": "0.3",
"name": "uapi-mcp",
"prompts": [],
"server": {
"type": "node",
"entry_point": "./bin/mcp-server.js",
"mcp_config": {
"command": "node",
"args": [
"${__dirname}/bin/mcp-server.js",
"start",
"--mode",
"dynamic"
],
"env": {
"UAPI_MCP_UAPIKEY": "${user_config.uapikey}"
}
}
},
"user_config": {
"uapikey": {
"type": "string",
"title": "UAPI Key",
"description": "填写后会自动用于所有上游请求。",
"default": "",
"sensitive": true
}
},
"version": "0.1.0",
"tools": [
{
"name": "convert-post-convert-json",
"description": "JSON 格式化\n\n还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。\n\n## 功能概述\n你只需要提供一个原始的、可能是压缩过的或者格式混乱的 JSON 字符串，这个 API 就会返回一个经过美化（带标准缩进和换行）的版本。这在调试 API 响应、或者需要在前端界面清晰展示 JSON 数据时非常有用。\n\n## 使用须知\n> [!NOTE]\n> **请求格式**\n> 请注意，待格式化的 JSON 字符串需要被包裹在另一个 JSON 对象中，作为 `content` 字段的值提交。具体格式请参考请求体示例。\n\n## 错误处理指南\n- **400 Bad Request**: 最常见的原因是你提供的 `content` 字符串本身不是一个有效的 JSON。请仔细检查括号、引号是否正确闭合，或者有没有多余的逗号等语法错误。"
},
{
"name": "convert-get-convert-unixtime",
"description": "时间戳转换\n\n时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！\n\n## 功能概述\n这是一个非常智能的转换器。你给它一个 Unix 时间戳，它还你一个人类可读的日期时间；你给它一个日期时间字符串，它还你一个 Unix 时间戳。它会自动识别你输入的是哪种格式。\n\n## 使用须知\n这个接口非常智能，能够自动识别输入格式：\n\n- **输入时间戳**：支持10位秒级（如 `1672531200`）和13位毫秒级（如 `1672531200000`）。\n- **输入日期字符串**：为了确保准确性，推荐使用 `YYYY-MM-DD HH:mm:ss` 标准格式（如 `2023-01-01 08:00:00`）。\n\n> [!TIP]\n> 无论你输入哪种格式，响应中都会同时包含标准日期字符串和秒级Unix时间戳，方便你按需取用。\n\n## 错误处理指南\n- **400 Bad Request**: 如果你提供的 `time` 参数既不是有效的时间戳，也不是我们支持的日期格式，就会收到这个错误。请检查你的输入值。"
},
{
"name": "daily-get-daily-news-image",
"description": "每日新闻图\n\n想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。\n\n## 功能概述\n此接口会实时抓取各大平台的热点新闻，并动态地将它们渲染成一张清晰、美观的摘要图片。你调用接口，直接就能得到一张可以展示的图片。\n\n## 使用须知\n调用此接口时，请务必注意以下两点：\n\n1. **响应格式是图片**：接口成功时直接返回 `image/jpeg` 格式的二进制数据，而非 JSON。请确保你的客户端能正确处理二进制流，例如直接在 `![]()
` 标签中显示，或保存为 `.jpg` 文件。\n\n2. **设置合理超时**：由于涉及实时新闻抓取和图片渲染，处理过程可能耗时数秒。建议将客户端请求超时时间设置为至少10秒，以防止因等待过久而失败。\n\n> [!IMPORTANT]\n> 未能正确处理图片响应或超时设置过短，是导致调用失败的最常见原因。"
},
{
"name": "game-get-game-minecraft-historyid",
"description": "查询 MC 曾用名\n\n想知道某个大佬以前叫什么名字吗？这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”！\n\n## 功能概述\n通过提供玩家的用户名或 UUID，你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。\n\n## 使用须知\n> [!NOTE]\n> **参数说明**\n> - `name` 和 `uuid` 二选一\n> - UUID 支持带连字符（如 `ee9b4ed1-aac1-491e-b761-1471be374b80`）或不带连字符格式\n\n> [!IMPORTANT]\n> **响应结构差异**\n> - 使用 `uuid` 查询：返回单个用户的历史记录\n> - 使用 `name` 查询：返回所有匹配用户的列表（包括当前用户名或曾用名匹配的玩家），需判断响应中是否有 `results` 字段来区分两种模式"
},
{
"name": "game-get-game-minecraft-serverstatus",
"description": "查询 MC 服务器\n\n想在加入服务器前看看有多少人在线？或者检查一下服务器开没开？用这个接口就对了！\n\n## 功能概述\n你可以通过提供服务器地址（域名或IP），来获取一个 Minecraft Java 版服务器的实时状态。返回信息非常丰富，包括服务器是否在线、当前玩家数、最大玩家数、服务器版本、MOTD（每日消息）以及服务器图标等。"
},
{
"name": "game-get-game-minecraft-userinfo",
"description": "查询 MC 玩家\n\n只需要一个玩家的用户名，就能快速获取到他的正版皮肤和独一无二的UUID！\n\n## 功能概述\n这是一个基础但非常实用的接口。通过玩家当前的游戏内名称（Username），你可以查询到他对应的UUID（唯一标识符）和当前皮肤的URL地址。这是构建许多其他玩家相关服务的第一步。"
},
{
"name": "game-get-game-steam-summary",
"description": "查询 Steam 用户\n\n想在你的网站或应用中展示用户的 Steam 个人资料？这个接口就是为你准备的。\n\n## 功能概述\n通过一个用户的 Steam 标识（支持多种格式），你可以获取到他公开的个人资料摘要，包括昵称、头像、在线状态、真实姓名（如果公开）和个人资料主页URL等信息。\n\n## 支持的参数格式\n接口现在支持以下几种标识符格式：\n- **`steamid`**: 64位SteamID（如 `76561197960287930`）\n- **`id`**: 自定义URL名称（如 `gabelogannewell`）\n- **`id3`**: Steam ID3格式（如 `STEAM_0:0:22202`）\n- 完整的个人资料链接\n- 好友代码\n\n## 使用须知\n\n> [!IMPORTANT]\n> **API Key 安全**\n> 此接口需要一个 Steam Web API Key。我们强烈建议由后端统一配置和调用，以避免在客户端泄露。当然，你也可以通过 `key` 查询参数临时提供一个Key来覆盖后端配置。\n\n在处理响应时，请注意以下数字代码的含义：\n- **`personastate` (用户状态)**: 0-离线, 1-在线, 2-忙碌, 3-离开, 4-打盹, 5-想交易, 6-想玩。\n- **`communityvisibilitystate` (社区可见性)**: 1-私密, 3-公开 (API通常只能查到这两种状态)。"
},
{
"name": "game-get-game-epic-free",
"description": "Epic 免费游戏\n\n白嫖党的福音来了！想第一时间知道Epic商店本周送了哪些游戏大作吗？\n\n## 功能概述\n这个接口帮你实时追踪Epic Games商店的每周免费游戏活动。无需任何参数，调用后即可获得当前所有免费游戏的完整信息，包括游戏封面、原价、剩余时间等，再也不用担心错过心仪的免费游戏了！\n\n## 使用场景\n- 开发游戏资讯应用或网站\n- 制作Epic免费游戏推送机器人\n- 为用户提供游戏收藏建议\n- 构建个人游戏库管理工具\n\n> [!TIP]\n> **关于时间格式**\n> 为了方便不同场景的使用，我们同时提供了可读的时间字符串（如 `2025/01/10 00:00:00`）和13位毫秒时间戳。前端显示用字符串，程序逻辑用时间戳"
},
{
"name": "image-get-image-bing-daily",
"description": "必应壁纸\n\n每天都想换张新壁纸？让必应的美图点亮你的一天吧！\n\n## 功能概述\n这个接口会获取 Bing 搜索引擎当天全球同步的每日壁纸，并直接以图片形式返回。你可以用它来做应用的启动页、网站背景，或者任何需要每日更新精美图片的地方。\n\n## 使用须知\n\n> [!NOTE]\n> **响应格式是图片**\n> 请注意，此接口成功时直接返回图片二进制数据（通常为 `image/jpeg`），而非 JSON 格式。请确保客户端能够正确处理。\n\n我们内置了备用方案：如果从必应官方获取图片失败，系统会尝试返回一张预存的高质量风景图，以保证服务的稳定性。"
},
{
"name": "image-post-image-frombase64",
"description": "通过Base64编码上传图片\n\n当你需要在前端处理完图片（比如裁剪、加滤镜后），不通过传统表单，而是直接上传图片的场景，这个接口就派上用场了。\n\n## 功能概述\n你只需要将图片的 Base64 编码字符串发送过来，我们就会把它解码、保存为图片文件，并返回一个可供访问的公开 URL。\n\n## 使用须知\n\n> [!IMPORTANT]\n> **关于 `imageData` 格式**\n> 你发送的 `imageData` 字符串必须是完整的 Base64 Data URI 格式，它需要包含 MIME 类型信息，例如 `data:image/png;base64,iVBORw0KGgo...`。缺少 `data:image/...;base64,` 前缀将导致解码失败。"
},
{
"name": "image-get-image-motou",
"description": "生成摸摸头GIF (QQ号)\n\n想在线rua一下好友的头像吗？这个趣味接口可以满足你。\n\n## 功能概述\n此接口通过GET方法，专门用于通过QQ号生成摸摸头GIF。你只需要提供一个QQ号码，我们就会自动获取其公开头像，并制作成一个可爱的动图。\n\n## 使用须知\n- **响应格式**：接口成功时直接返回 `image/gif` 格式的二进制数据。\n- **背景颜色**：你可以通过 `bg_color` 参数来控制GIF的背景。使用 `transparent` 选项可以让它更好地融入各种聊天背景中。"
},
{
"name": "image-post-image-motou",
"description": "生成摸摸头GIF\n\n除了使用QQ头像，你还可以通过上传自己的图片或提供图片URL来制作独一无二的摸摸头GIF。\n\n## 功能概述\n此接口通过POST方法，支持两种方式生成GIF：\n1. **图片URL**：在表单中提供 `image_url` 字段。\n2. **上传图片**：在表单中上传 `file` 文件。\n\n## 使用须知\n- **响应格式**：接口成功时直接返回 `image/gif` 格式的二进制数据。\n- **参数优先级**：如果同时提供了 `image_url` 和上传的 `file` 文件，系统将 **优先使用 `image_url`**。\n- **背景颜色**：同样支持 `bg_color` 表单字段来控制GIF背景。"
},
{
"name": "image-post-image-speechless",
"description": "生成你们怎么不说话了表情包\n\n你们怎么不说话了？是不是都在偷偷玩Uapi，求求你们不要玩Uapi了\n\n## 使用须知\n- **响应格式**：接口成功时直接返回 `image/png` 格式的二进制数据。\n- **文字内容**：至少需要提供 `top_text`（上方文字）或 `bottom_text`（下方文字）之一。\n- **梗图逻辑**：上方描述某个行为，下方通常以「们」开头表示劝阻，形成戏谑的对比效果。"
},
{
"name": "image-get-image-qrcode",
"description": "生成二维码\n\n无论是网址、文本还是联系方式，通通可以变成一个二维码！这是一个非常灵活的二维码生成工具。\n\n## 功能概述\n你提供一段文本内容，我们为你生成对应的二维码图片。你可以自定义尺寸、前景色、背景色，还支持透明背景，并选择不同的返回格式以适应不同场景。\n\n## 使用须知\n\n> [!IMPORTANT]\n> **关键参数 `format`**\n> 此参数决定了成功响应的内容类型和结构，请务必根据你的需求选择并正确处理响应：\n> - **`image`** (默认): 直接返回 `image/png` 格式的图片二进制数据，适合在 `![]()
` 标签中直接使用。\n> - **`json`**: 返回一个包含 Base64 Data URI 的 JSON 对象，适合需要在前端直接嵌入CSS或HTML的场景。\n> - **`json_url`**: 返回一个包含图片临时URL的JSON对象，适合需要图片链接的场景。\n\n> [!TIP]\n> **颜色参数说明**\n> - 颜色参数使用十六进制格式（如 `#FF0000`）\n> - URL 中需要对 `#` 进行编码，即 `%23`（例如：`fgcolor=%23FF0000`）\n> - 当 `transparent=true` 时，`bgcolor` 参数会被忽略"
},
{
"name": "image-get-image-tobase64",
"description": "图片转 Base64\n\n看到一张网上的图片，想把它转换成 Base64 编码以便嵌入到你的 HTML 或 CSS 中？用这个接口就对了。\n\n## 功能概述\n你提供一个公开可访问的图片 URL，我们帮你把它下载下来，并转换成包含 MIME 类型的 Base64 Data URI 字符串返回给你。"
},
{
"name": "image-post-image-svg",
"description": "SVG转图片\n\n需要将灵活的 SVG 矢量图形转换为常见的光栅图像格式吗？这个接口可以帮你轻松实现。\n\n## 功能概述\n上传一个 SVG 文件，并指定目标格式（如 PNG、JPEG 等），接口将返回转换后的图像。你还可以调整输出图像的尺寸和（对于JPEG）压缩质量，以满足不同场景的需求。"
},
{
"name": "image-post-image-compress",
"description": "无损压缩图片\n\n还在为图片体积和加载速度发愁吗？体验一下我们强大的**无损压缩服务**，它能在几乎不牺牲任何肉眼可感知的画质的前提下，将图片体积压缩到极致。\n\n## 功能概述\n你只需要上传一张常见的图片（如 PNG, JPG），选择一个压缩等级，就能获得一个体积小到惊人的压缩文件。这对于需要大量展示高清图片的网站、App 或小程序来说，是优化用户体验、节省带宽和存储成本的利器。\n\n## 使用须知\n> [!TIP]\n> 为了给您最好的压缩效果，我们的算法需要进行复杂计算，处理时间可能会稍长一些，请耐心等待。\n\n> [!WARNING]\n> **服务排队提醒**\n> 这是一个计算密集型服务。在高并发时，您的请求可能会被排队等待处理。如果您需要将其集成到对延迟敏感的生产服务中，请注意这一点。\n\n### 请求与响应格式\n- 请求必须使用 `multipart/form-data` 格式上传文件。\n- 成功响应将直接返回压缩后的文件二进制流 (`image/*`)，并附带 `Content-Disposition` 头，建议客户端根据此头信息保存文件。\n\n## 参数详解\n### `level` (压缩等级)\n这是一个从 `1` 到 `5` 的整数，它决定了压缩的强度和策略，数字越小，压缩率越高。所有等级都经过精心调校，以在最大化压缩率的同时保证出色的视觉质量。\n- `1`: **极限压缩** (推荐，体积最小，画质优异)\n- `2`: **高效压缩**\n- `3`: **智能均衡** (默认选项)\n- `4`: **画质优先**\n- `5`: **专业保真** (压缩率稍低，保留最多图像信息)\n\n## 错误处理指南\n- **400 Bad Request**: 通常因为没有上传文件，或者 `level` 参数不在 1-5 的范围内。\n- **500 Internal Server Error**: 如果在压缩过程中服务器发生内部错误，会返回此状态码。"
},
{
"name": "image-get-avatar-gravatar",
"description": "获取Gravatar头像\n\n提供一个超高速、高可用的Gravatar头像代理服务。内置了强大的ETag条件缓存，确保用户在更新Gravatar头像后能几乎立刻看到变化，同时最大化地利用缓存。"
},
{
"name": "image-post-image-nsfw",
"description": "图片敏感检测\n\n这是一个图片内容审核接口，自动识别图片中的违规内容并返回处理建议。\n\n> [!VIP]\n> 此接口限时免费开放，无需企业认证即可使用。\n\n## 功能概述\n上传图片文件或提供图片URL，接口会自动分析图片内容，返回是否违规、风险等级和处理建议。适合对接到用户上传流程中，实现自动化内容审核。\n\n## 返回字段说明\n- **is_nsfw**: 是否判定为违规内容，`true` 表示违规，`false` 表示正常\n- **nsfw_score**: 违规内容置信度，0-1 之间，越高表示越可能违规\n- **normal_score**: 正常内容置信度，0-1 之间，与 nsfw_score 互补\n- **suggestion**: 处理建议\n - `pass`: 内容正常，可以直接放行\n - `review`: 存在风险，建议转人工复核\n - `block`: 高风险内容，建议直接拦截\n- **risk_level**: 风险等级\n - `low`: 低风险\n - `medium`: 中风险\n - `high`: 高风险\n- **label**: 内容标签，`nsfw` 或 `normal`\n- **confidence**: 模型对当前判断的整体置信度\n- **inference_time_ms**: 模型推理耗时，单位毫秒"
},
{
"name": "misc-get-misc-hotboard",
"description": "查询热榜\n\n想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！\n\n## 功能概述\n你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。\n\n## 三种使用模式\n\n### 默认模式\n只传 `type` 参数，返回该平台当前的实时热榜。\n\n### 时光机模式\n传 `type` + `time` 参数，返回最接近指定时间的热榜快照。如果不可用或无数据，会返回空。\n\n### 搜索模式\n传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。\n\n### 数据源列表\n传 `sources=true`，返回所有支持历史数据的平台列表。\n\n## 可选值\n`type` 参数接受多种不同的值，每种值对应一个不同的热榜来源。以下是目前支持的所有值：\n\n| 分类 | 支持的 type 值 |\n|------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| 视频/社区 | bilibili（哔哩哔哩弹幕网）, acfun（A站弹幕视频网站）, weibo（新浪微博热搜）, zhihu（知乎热榜）, zhihu-daily（知乎日报热榜）, douyin（抖音热榜）, kuaishou（快手热榜）, douban-movie（豆瓣电影榜单）, douban-group（豆瓣小组话题）, tieba（百度贴吧热帖）, hupu（虎扑热帖）, ngabbs（NGA游戏论坛热帖）, v2ex（V2EX技术社区热帖）, 52pojie（吾爱破解热帖）, hostloc（全球主机交流论坛）, coolapk（酷安热榜） |\n| 新闻/资讯 | baidu（百度热搜）, thepaper（澎湃新闻热榜）, toutiao（今日头条热榜）, qq-news（腾讯新闻热榜）, sina（新浪热搜）, sina-news（新浪新闻热榜）, netease-news（网易新闻热榜）, huxiu（虎嗅网热榜）, ifanr（爱范儿热榜） |\n| 技术/IT | sspai（少数派热榜）, ithome（IT之家热榜）, ithome-xijiayi（IT之家·喜加一栏目）, juejin（掘金社区热榜）, jianshu（简书热榜）, guokr（果壳热榜）, 36kr（36氪热榜）, 51cto（51CTO热榜）, csdn（CSDN博客热榜）, nodeseek（NodeSeek 技术社区）, hellogithub（HelloGitHub 项目推荐） |\n| 游戏 | lol（英雄联盟热帖）, genshin（原神热榜）, honkai（崩坏3热榜）, starrail（星穹铁道热榜） |\n| 音乐 | netease-music（网易云音乐热歌榜）, qq-music（QQ音乐热歌榜） |\n| 其他 | weread（微信读书热门书籍）, weatheralarm（天气预警信息）, earthquake（地震速报）, history（历史上的今天） |\n"
},
{
"name": "misc-get-misc-phoneinfo",
"description": "查询手机归属地\n\n想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。\n\n## 功能概述\n提供一个国内的手机号码，我们会查询并返回它的归属地（省份和城市）以及所属的运营商信息。"
},
{
"name": "misc-get-misc-randomnumber",
"description": "随机数生成\n\n需要一个简单的随机数，还是需要一串不重复的、带小数的随机数？这个接口都能满足你！\n\n## 功能概述\n这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。\n\n## 流程图\n```mermaid\ngraph TD\n\n\n A[开始] --> B{参数校验};\n B --> |通过| C{是否允许小数?};\n C --> |是| D[生成随机小数];\n C --> |否| E[生成随机整数];\n D --> F{是否允许重复?};\n E --> F;\n F --> |是| G[直接生成指定数量];\n F --> |否| H[生成不重复的数字];\n G --> I[返回结果];\n H --> I;\n B --> |失败| J[返回 400 错误];\n```\n## 使用须知\n> [!WARNING]\n> **不重复生成的逻辑限制**\n> 当设置 `allow_repeat=false` 时，请确保取值范围 `(max - min + 1)` 大于或等于你请求的数量 `count`。否则，系统将无法生成足够的不重复数字，请求会失败并返回 400 错误。"
},
{
"name": "misc-get-misc-timestamp",
"description": "转换时间戳 (旧版，推荐使用/convert/unixtime)\n\n这是一个用于将Unix时间戳转换为人类可读日期时间的旧版接口。\n\n## 功能概述\n输入一个秒级或毫秒级的时间戳，返回其对应的本地时间和UTC时间。\n\n> [!WARNING]\n> **接口已过时**：这个接口已被新的 `/convert/unixtime` 取代。新接口功能更强大，支持双向转换。我们建议你迁移到新接口。\n\n[➡️ 前往新版接口文档](/docs/api-reference/get-convert-unixtime)"
},
{
"name": "misc-get-misc-weather",
"description": "查询天气\n\n出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据，支持国内和国际城市。\n\n## 功能概述\n这个接口支持三种查询方式：\n- 可以传 `adcode`，按行政区编码查询（优先级最高）\n- 可以传 `city`，按城市名称查询，支持中文（`北京`）和英文（`Tokyo`）\n- 两个都不传时，按客户端 IP 自动定位查询\n\n支持 `lang` 参数，可选 `zh`（默认）和 `en`，城市名翻译覆盖 7000+ 城市。\n\n## 可选功能模块\n- `extended=true`：扩展气象字段（体感温度、能见度、气压、紫外线、空气质量及污染物分项数据）\n- `forecast=true`：多天预报（最多7天，含日出日落、风速等详细数据）\n- `hourly=true`：逐小时预报（24小时）\n- `minutely=true`：分钟级降水预报（仅国内城市）\n- `indices=true`：18项生活指数（穿衣、紫外线、洗车、运动、花粉等）\n\n## 天气字段说明\n`weather` 是天气现象文本，不是固定枚举。\n\n常见值包括：晴、多云、阴、小雨、中雨、大雨、雷阵雨、小雪、中雪、大雪、雨夹雪、雾、霾、沙尘。\n\n如果你的业务需要稳定分类，建议结合 `weather_code` 做自己的映射归类。"
},
{
"name": "misc-get-misc-worldtime",
"description": "查询世界时间\n\n需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。\n\n## 功能概述\n根据标准的时区名称（例如 'Asia/Shanghai' 或 'Europe/London'），获取该时区的当前准确时间、UTC偏移量、星期等信息。"
},
{
"name": "misc-get-misc-lunartime",
"description": "查询农历时间\n\n需要在指定时区下查看某个时间点的农历信息？这个接口可以直接返回完整结果。\n\n## 功能概述\n支持传入 Unix 时间戳（秒或毫秒）和 IANA 时区名，返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 `ts` 时默认使用当前时间，不传 `timezone` 时默认 `Asia/Shanghai`。\n\n## 时区说明\n- 支持标准 IANA 时区，例如 `Asia/Shanghai`、`Asia/Tokyo`\n- 也支持别名：`Shanghai`、`Beijing`\n- 时区非法时返回 400 并提示 `invalid timezone: xxx`"
},
{
"name": "misc-get-misc-holiday-calendar",
"description": "查询节假日与万年历\n\n查询指定日期、月份或年份的万年历与节假日信息。\n\n## 功能概述\n这个接口支持三种查询方式：按天（`date`）、按月（`month`）和按年（`year`）。调用时三者选一个传入即可。\n\n如果你只关心某一类事件，可以通过 `holiday_type` 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。\n\n在 `date` 模式下，传 `include_nearby=true` 可以额外返回该日期前后最近的节日；返回数量由 `nearby_limit` 控制，默认 7，最大 30。"
},
{
"name": "misc-get-history-programmer-today",
"description": "程序员历史上的今天\n\n想知道程序员历史上的今天发生了什么大事吗？这个接口告诉你答案！\n\n## 功能概述\n我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分，确保内容质量。"
},
{
"name": "misc-get-history-programmer",
"description": "程序员历史事件\n\n想查看程序员历史上某个特定日期发生的大事件？指定月份和日期，我们就能告诉你！\n\n## 功能概述\n通过指定月份和日期，获取该日发生的程序员相关历史事件。同样使用AI智能筛选，确保事件的相关性和重要性。"
},
{
"name": "misc-get-misc-tracking-query",
"description": "查询快递物流信息\n\n买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。\n\n## 功能概述\n提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。支持中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等60+国内外主流快递公司。\n\n## 使用须知\n- **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用）\n- **手动指定**：如果已知快递公司，可以传递 `carrier_code` 参数，查询速度会更快\n- **手机尾号验证**：部分快递公司需要验证收件人手机尾号才能查询详细物流，如果返回「暂无物流信息」，建议尝试传入 `phone` 参数\n- **查询时效**：物流信息实时查询，响应时间通常在1-2秒内"
},
{
"name": "misc-get-misc-tracking-detect",
"description": "识别快递公司\n\n不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。\n\n## 功能概述\n输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 `alternatives` 字段中返回备选项，供你参考选择。\n\n## 使用须知\n- **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内\n- **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95%\n- **备选方案**：当单号规则可能匹配多家快递公司时，会提供所有可能的选项"
},
{
"name": "misc-get-misc-tracking-carriers",
"description": "获取支持的快递公司列表\n\n不确定系统支持哪些快递公司？这个接口返回完整的支持列表。\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。\n\n## 功能概述\n获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。\n\n## 使用建议\n- **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地\n- **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件\n- **缓存时长**：建议缓存24小时或更久"
},
{
"name": "misc-post-misc-date-diff",
"description": "计算两个日期之间的时间差值\n\n想知道两个日期之间相差多久？这个接口帮你精确计算时间差值。\n\n## 功能概述\n输入开始日期和结束日期，返回它们之间的时间差，包括总天数、总小时数、总分钟数、总秒数、总周数，以及人性化显示格式（如\"1年2月3天\"）。\n\n## 日期格式\n接口支持自动识别常见日期格式，包括：YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601（带时区）等。也可以通过`format`参数显式指定格式（如DD-MM-YYYY）。\n\n> [!NOTE]\n> 当结束日期早于开始日期时，返回的数值为负数。"
},
{
"name": "misc-get-misc-district",
"description": "Adcode 国内外行政区域查询\n\n一个接口，覆盖全球 243 个国家、中国省/市/区/街道四级行政区划，支持关键词搜索、行政编码查询、坐标反查三种查询模式（必须至少传入一种查询参数）。\n\n## 功能概述\n根据用户输入的搜索条件快速查找行政区域信息。例如：中国 > 山东省 > 济南市 > 历下区 > 舜华路街道。\n\n无需注册、无需密钥，直接调用即可获取结构化的行政区域数据。支持三种查询方式：\n- 传 `adcode`，按行政编码精确查询，同时返回下级区划列表\n- 传 `lat` + `lng`，坐标反查附近地点\n- 传 `keywords`，按关键词搜索，支持中英文\n\n## 中国与国际数据差异\n中国数据包含 `adcode`、`citycode` 等字段，支持省/市/区/街道四级逐级查询；国际城市数据不含这些字段，但额外提供 `population`（人口）和 `timezone`（时区）。\n\n> [!NOTE]\n> 部分城市（如东莞、文昌）没有区县层级，市级下方直接显示街道。街道级别的 `adcode` 返回的是所属区县的 `adcode`。"
},
{
"name": "network-get-network-dns",
"description": "执行DNS解析查询\n\n想知道一个域名指向了哪个IP？或者它的邮件服务器是谁？这个接口就像一个在线的 `dig` 或 `nslookup` 工具。\n\n## 功能概述\n你可以查询指定域名的各种DNS记录，包括 `A` (IPv4), `AAAA` (IPv6), `CNAME` (别名), `MX` (邮件交换), `NS` (域名服务器) 和 `TXT` (文本记录)。"
},
{
"name": "network-get-network-icp",
"description": "查询域名ICP备案信息\n\n想知道一个网站的背后运营主体是谁吗？如果它是在中国大陆运营的，ICP备案信息可以告诉你答案。\n\n## 功能概述\n提供一个域名，查询其在中国工信部的ICP（Internet Content Provider）备案信息。这对于商业合作前的背景调查、验证网站合法性等场景很有帮助。\n\n> [!NOTE]\n> **查询范围**\n> 此查询仅对在中国大陆工信部进行过备案的域名有效。对于国外域名或未备案的域名，将查询不到结果。"
},
{
"name": "network-get-network-ipinfo",
"description": "查询 IP\n\n想知道一个IP地址或域名来自地球的哪个角落？这个接口可以帮你定位它。你可以使用默认数据源，也可以指定 `source=commercial` 参数来查询更详细的商业级IP归属信息。\n\n## 功能概述\n提供一个公网IPv4、IPv6地址或域名，我们会查询并返回它的地理位置（国家、省份、城市）、经纬度、以及所属的运营商（ISP）和自治系统（ASN）信息。这在网络安全分析、访问来源统计等领域非常有用。\n\n当使用 `source=commercial` 参数时，接口将调用高性能商业API，提供更精确的市、区、运营商、时区、海拔等信息。请注意，商业查询的响应时间可能会稍长。"
},
{
"name": "network-get-network-myip",
"description": "查询我的 IP\n\n想知道你自己的出口公网IP是多少吗？这个接口就是你的“网络身份证”。你可以使用默认数据源，也可以指定 `source=commercial` 参数来查询更详细的商业级IP归属信息。\n\n## 功能概述\n调用此接口，它会返回你（即发起请求的客户端）的公网IP地址，并附带与 `/network/ipinfo` 接口相同的地理位置和网络归属信息。非常适合用于在网页上向用户展示他们自己的IP和地理位置。\n\n当使用 `source=commercial` 参数时，接口将调用高性能商业API，提供更精确的市、区、运营商、时区、海拔等信息。请注意，商业查询的响应时间可能会稍长。"
},
{
"name": "network-get-network-ping",
"description": "Ping 主机\n\n想知道从我们的服务器到你的服务器网络延迟高不高？这个工具可以帮你测试网络连通性。\n\n## 功能概述\n这个接口会从我们的服务器节点对你指定的主机（域名或IP地址）执行 ICMP Ping 操作。它会返回最小、最大、平均延迟以及丢包率等关键指标，是诊断网络问题的得力助手。"
},
{
"name": "network-get-network-pingmyip",
"description": "Ping 我的 IP\n\n这是一个非常方便的快捷接口，想知道你的网络到我们服务器的回程延迟吗？点一下就行！\n\n## 功能概述\n这个接口是 `/network/myip` 和 `/network/ping` 的结合体。它会自动获取你客户端的公网IP，然后从我们的服务器Ping这个IP，并返回延迟数据。这对于快速判断你本地网络到服务器的连接质量非常有用。"
},
{
"name": "network-get-network-portscan",
"description": "端口扫描\n\n想检查一下你的服务器上某个端口（比如SSH的22端口或者Web的80端口）是否对外开放？这个工具可以帮你快速确认。\n\n## 功能概述\n你可以指定一个主机和端口号，我们的服务器会尝试连接该端口，并告诉你它是开放的（open）、关闭的（closed）还是超时了（timeout）。这对于网络服务配置检查和基本的安全扫描很有用。"
},
{
"name": "network-get-network-urlstatus",
"description": "检查URL的可访问性状态\n\n你的网站或API还好吗？用这个接口给它做个快速“体检”吧。\n\n## 功能概述\n提供一个URL，我们会向它发起一个请求，并返回其HTTP响应状态码。这是一种简单而有效的服务可用性监控方法。"
},
{
"name": "network-get-network-whois",
"description": "查询域名的WHOIS注册信息\n\n想知道一个域名是什么时候注册的、注册商是谁、什么时候到期？WHOIS信息可以告诉你这一切。\n\n## 功能概述\n这是一个在线的WHOIS查询工具。你可以通过如下两种方式获取WHOIS信息：\n\n- **默认行为**（不带参数）：`GET /api/v1/network/whois?domain=google.com`\n - 返回一个JSON对象，`whois` 字段为原始、未处理的WHOIS文本字符串。\n- **JSON格式化**：`GET /api/v1/network/whois?domain=google.com&format=json`\n - 返回一个JSON对象，`whois` 字段为解析后的JSON对象，包含WHOIS信息中的键值对。\n\n这样你既可以获得最全的原始信息，也可以方便地处理结构化数据。"
},
{
"name": "network-get-network-wxdomain",
"description": "检查域名在微信中的访问状态\n\n准备在微信里推广你的网站？最好先检查一下域名是否被“拉黑”了。\n\n## 功能概述\n这个接口可以帮你查询一个域名在微信内置浏览器中的访问状态，即是否被微信封禁。这对于做微信生态推广和营销的开发者来说至关重要。"
},
{
"name": "poem-get-saying",
"description": "一言\n\n想在你的应用里每天展示一句不一样的话，给用户一点小小的惊喜吗？这个“一言”接口就是为此而生。\n\n## 功能概述\n每次调用，它都会从我们精心收集的、包含数千条诗词、动漫台词、名人名言的语料库中，随机返回一条。你可以用它来做网站首页的Slogan、应用的启动语，或者任何需要灵感点缀的地方。"
},
{
"name": "random-get-random-image",
"description": "随机图片\n\n需要一张随机图片作为占位符或者背景吗？这个接口是你的不二之选。\n\n## 功能概述\n这是一个非常简单的接口，它会从我们庞大的图库和精选外部图床中随机挑选一张图片，然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的 `![]()
` 标签中。\n\n你可以通过 `/api/v1/random/image?category=acg&type=4k` 这样的请求获取由UapiPro服务器提供的图片，也可以通过 `/api/v1/random/image?category=ai_drawing` 获取由外部图床精选的图片。\n\n如果你不提供任何 category 参数，程序会从所有图片（包括本地的和URL的）中随机抽取一张（**全局随机图片不包含ikun和AI绘画**）。\n\n> [!TIP]\n> 如果你需要更精确地控制图片类型，请使用 `/image/random/{category}/{type}` 接口。\n\n### 支持的主类别与子类别\n- **acg**（二次元动漫）\n\n\n - pc\n - mb\n- **外部图床精选/混合动漫**\n\n\n - **landscape**: 风景图。\n - **anime**: 混合了UapiPro服务器的acg和外部图床的general_anime分类下的图片。\n - **pc_wallpaper**: 电脑壁纸。\n - **mobile_wallpaper**: 手机壁纸。\n - **general_anime**: 动漫图。\n - **ai_drawing**: AI绘画。\n- **其他分类**\n\n\n - **bq**（表情包/趣图）\n - eciyuan\n - ikun\n - xiongmao\n - waiguoren\n - maomao\n - **furry**（福瑞）\n - z4k\n - szs8k\n - s4k\n - 4k\n\n> [!NOTE]\n> 默认全局随机（未指定category参数）时，不会包含ikun和AI绘画（ai_drawing）类别的图片。\n"
},
{
"name": "random-get-random-string",
"description": "随机字符串\n\n无论是需要生成一个安全的随机密码、一个唯一的Token，还是一个简单的随机ID，这个接口都能满足你。\n\n## 功能概述\n你可以精确地控制生成字符串的长度和字符集类型，非常灵活。\n\n## 使用须知\n\n> [!TIP]\n> **字符集类型 `type` 详解**\n> 你可以通过 `type` 参数精确控制生成的字符集：\n> - **`numeric`**: 纯数字 (0-9)\n> - **`lower`**: 纯小写字母 (a-z)\n> - **`upper`**: 纯大写字母 (A-Z)\n> - **`alpha`**: 大小写字母 (a-zA-Z)\n> - **`alphanumeric`** (默认): 数字和大小写字母 (0-9a-zA-Z)\n> - **`hex`**: 十六进制字符 (0-9a-f)"
},
{
"name": "random-get-answerbook-ask",
"description": "答案之书\n\n想要获得人生问题的神秘答案吗？答案之书API提供了一个神奇8球风格的问答服务，你可以提问并获得随机的神秘答案。\n\n## 功能概述\n通过向答案之书提问，你将获得一个充满智慧（或许）的随机答案。这个API支持通过查询参数或POST请求体两种方式提问。\n\n## 使用须知\n\n> [!TIP]\n> **提问技巧**\n> - 提出明确的问题会获得更好的体验\n> - 问题不能为空\n> - 支持中文问题\n> - 答案具有随机性，仅供娱乐参考"
},
{
"name": "random-post-answerbook-ask",
"description": "答案之书 (POST)\n\n通过POST请求向答案之书提问并获得神秘答案。\n\n## 功能概述\n与GET方式相同，但通过JSON请求体发送问题，适合在需要发送较长问题或希望避免URL编码问题的场景中使用。\n\n## 请求体格式\n请求体必须是有效的JSON格式，包含question字段。"
},
{
"name": "social-get-social-bilibili-userinfo",
"description": "查询 B站用户\n\n想在你的应用里集成B站用户资料展示？这个接口可以轻松获取用户的公开信息。\n\n## 功能概述\n通过一个用户的UID（那一串纯数字ID），你可以查询到该用户的昵称、性别、头像、等级、签名等一系列公开的基本信息。"
},
{
"name": "social-get-social-qq-userinfo",
"description": "查询 QQ 信息\n\n这是一个功能丰富的QQ用户信息查询接口，能够获取QQ用户的详细公开信息。\n\n> [!VIP]\n> 我们在近日优化了此接口，速度应该会更加快了。 \n\n## 功能概述\n通过QQ号查询用户的详细信息，包括基础资料、等级信息、VIP状态等。返回的信息丰富全面，适合用于用户画像分析、社交应用集成等场景。\n\n## 数据字段说明\n- **基础信息**: 昵称、个性签名、头像、年龄、性别\n- **联系信息**: QQ邮箱、个性域名(QID)\n- **等级信息**: QQ等级、VIP状态和等级\n- **时间信息**: 注册时间、最后更新时间"
},
{
"name": "social-get-social-bilibili-archives",
"description": "查询 B站投稿\n\n想要获取UP主的所有投稿视频？或者想在你的应用里展示创作者的作品集？这个接口能帮你轻松实现。\n\n## 功能概述\n通过用户的 `mid`（用户ID），你可以获取该UP主的投稿视频列表。接口支持关键词搜索、分页加载和多种排序方式，让你能够灵活地展示和分析创作者的内容。\n\n## 参数说明\n- **`mid` (用户ID)**: B站用户的mid，必填参数。\n- **`keywords` (搜索关键词)**: 可选，用于在该UP主的投稿中搜索特定关键词。\n- **`orderby` (排序方式)**: \n - `pubdate`: 按最新发布排序（默认）\n - `views`: 按最多播放排序\n- **`ps` (每页条数)**: 默认20条。\n- **`pn` (页码)**: 默认1，用于分页。\n\n## 响应体字段说明\n- **`total` (总稿件数)**: UP主的投稿总数。\n- **`page` (当前页码)**: 当前返回的页码。\n- **`size` (每页数量)**: 每页返回的视频数量。\n- **`videos` (视频列表)**: 包含当前页的所有视频信息：\n - `aid`: 视频的AV号\n - `bvid`: 视频的BV号\n - `title`: 视频标题\n - `cover`: 封面URL\n - `duration`: 时长（秒）\n - `play_count`: 播放量\n - `publish_time`: 发布时间戳\n - `create_time`: 创建时间戳\n - `state`: 视频状态\n - `is_ugc_pay`: 是否付费视频（0=免费，1=付费）\n - `is_interactive`: 是否为互动视频"
},
{
"name": "social-get-social-bilibili-videoinfo",
"description": "查询 B站视频\n\n想在你的应用里展示B站视频的详细信息吗？无论是封面、标题，还是播放量、UP主信息，这个接口都能一网打尽。\n\n## 功能概述\n通过提供视频的 `aid` 或 `bvid`，你可以获取到该视频的完整元数据，包括多P信息、UP主资料、数据统计等。\n\n## 响应体字段说明\n- **`copyright` (视频类型)**: `1` 代表原创，`2` 代表转载。\n- **`owner` (UP主信息)**: 包含 `mid`, `name`, `face` 等UP主的基本资料。\n- **`stat` (数据统计)**: 包含了播放、弹幕、评论、点赞、投币、收藏、分享等核心数据。\n- **`pages` (分P列表)**: 这是一个数组，包含了视频的每一个分P的信息，即使是单P视频也会有一个元素。"
},
{
"name": "social-get-social-bilibili-replies",
"description": "查询 B站评论\n\n想要分析B站视频的评论区？这个接口可以帮你轻松获取评论数据，包括热门评论和最新评论，还支持分页加载。\n\n## 功能概述\n通过视频的 `oid`（通常就是视频的`aid`），你可以分页获取该视频的评论区内容。你可以指定排序方式和分页参数，来精确地获取你需要的数据。\n\n## 参数说明\n- **`sort` (排序方式)**\n - `0` 或 `time`：按时间排序\n - `1` 或 `like`：按点赞排序\n - `2` 或 `reply`：按回复数排序\n - `3` 或 `hot`（也支持 `hottest`、`最热`）：按最热排序\n\n## 响应体字段说明\n- **`hots` (热门评论)**: 仅在请求第一页时，可能会返回热门评论列表。其结构与 `replies` 中的对象一致。\n- **`replies` (评论列表)**: 这是一个数组，包含了当前页的评论。其中：\n - `root`: 指向根评论的ID。如果评论本身就是根评论，则为 `0`。\n - `parent`: 指向该条回复所回复的上一级评论ID。如果评论是根评论，则为 `0`。"
},
{
"name": "social-get-social-bilibili-liveroom",
"description": "查询 B站直播间\n\n想知道你喜欢的主播开播了吗？或者想在你的应用里集成B站直播间状态？这个接口能满足你。\n\n## 功能概述\n这是一个智能接口，你可以用主播的 `mid` (用户ID) 或者直播间的 `room_id` (长号或短号)来查询。它会返回直播间的详细信息，包括是否在直播、标题、封面、人气、分区等。\n\n## 响应体字段说明\n- **`live_status` (直播状态)**: `0` 代表未开播，`1` 代表直播中，`2` 代表轮播中。"
},
{
"name": "social-get-social-qq-groupinfo",
"description": "查询 QQ 群信息\n\n想在你的应用里展示QQ群信息？这个接口让你轻松获取群名称、群头像、群简介、成员数量等详细公开信息。它能帮你快速构建社群导航站、群聊推荐系统，或是为你的数据分析工具提供可靠的数据源。\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。\n\n## 功能概述\n你只需要提供一个QQ群号（5-12位纯数字），接口就会返回该群的完整公开信息。我们会先验证群号的有效性，确保返回的数据准确可靠。接口响应速度快，数据结构清晰，非常适合集成到各类应用场景中。\n\n## 返回数据说明\n接口会返回以下QQ群的关键信息：\n\n### 基础字段（所有群都有）\n- **群基础信息**: 包括群号、群名称，让你能够准确识别和展示群聊\n- **视觉素材**: 提供群头像URL（支持多种尺寸），可直接用于在你的界面中展示群聊图标\n- **群介绍资料**: 包含群描述/简介和群标签，帮助用户了解群聊的主题和特色\n- **便捷入口**: 返回加群链接（二维码URL），方便用户一键加入感兴趣的群聊\n- **成员统计**: 当前成员数和最大成员数，直观了解群规模\n- **数据时效**: 提供最后更新时间戳，让你了解数据的新鲜度\n\n### 扩展字段（部分群有）\n- **活跃度**: 活跃成员数量（可选）\n- **群主信息**: 群主QQ号和UID（可选）\n- **时间信息**: 建群时间戳和格式化时间（可选）\n- **群等级**: 群等级数值（可选）\n- **群公告**: 群公告/简介内容（可选）\n- **认证信息**: 官方认证类型和说明（可选）\n\n所有返回的数据都遵循标准的JSON格式，字段命名清晰，便于解析和使用。扩展字段仅在数据可用时返回，保持响应体精简。"
},
{
"name": "social-get-github-repo",
"description": "查询 GitHub 仓库\n\n需要快速获取一个GitHub仓库的核心信息？这个接口为你聚合了最有价值的数据，避免了多次调用GitHub官方API的麻烦，并且内置了缓存优化，速度更快、更稳定。\n\n### 聚合高价值数据\n一次请求，即可获得以下信息：\n- **核心指标**: `star`, `fork`, `open_issues` 等关键统计数据。\n- **项目详情**: 描述、主页、分支、语言、话题标签、开源协议。\n- **参与者信息**: 获取协作者(`collaborators`)和推断的维护者(`maintainers`)列表，包括他们的公开邮箱（如果可用）。\n\n> [!NOTE]\n> `collaborators` 字段在私有仓库或权限受限时可能为空。`maintainers` 是根据最新提交记录推断的，仅供参考。\n\n### 性能与稳定性\n我们内置了多级缓存，有效避免触发GitHub的API速率限制。对于需要更高请求额度的用户，可以联系我们定制接口。"
},
{
"name": "status-get-status-ratelimit",
"description": "限流状态\n\n想了解我们API的当前负载情况吗？这个接口为你提供了服务的“心电图”。\n\n## 功能概述\n此接口返回我们后端自适应限流器的实时状态。你可以看到当前并发请求数、并发上限、系统负载、请求接受/拒绝数等核心指标。这对于监控API健康状况和性能表现至关重要。\n\n> [!IMPORTANT]\n> 此接口为管理接口，需要提供有效的管理员级别API密钥才能访问。\n\n### 认证方式\n请在请求头中添加 `Authorization: Bearer <你的API密钥>`。"
},
{
"name": "status-get-status-usage",
"description": "获取API端点使用统计\n\n想知道哪个API接口最受欢迎吗？这个接口提供了详细的“账单”。\n\n## 功能概述\n此接口用于获取每个API端点（Endpoint）的使用情况统计。你可以查询所有端点的列表，也可以通过 `path` 参数指定查询某一个特定端点。返回信息包括调用次数和平均处理时长"
},
{
"name": "text-post-text-aes-decrypt",
"description": "AES 解密\n\n收到了用AES加密的密文？把它、密钥和随机数（nonce）交给我们，就能还原出原始内容。\n\n## 功能概述\n这是一个标准的AES解密接口。你需要提供经过Base64编码的密文、加密时使用的密钥和nonce（随机数，通常为16字节字符串）。\n\n> [!IMPORTANT]\n> **关于密钥 `key`**\n> 我们支持 AES-128, AES-192, 和 AES-256。请确保你提供的密钥 `key` 的长度（字节数）正好是 **16**、**24** 或 **32**，以分别对应这三种加密强度。\n> \n> **关于随机数 `nonce`**\n> 通常为16字节字符串，需与加密时一致。"
},
{
"name": "text-post-text-aes-encrypt",
"description": "AES 加密\n\n需要安全地传输或存储一些文本信息？AES加密是一个可靠的选择。\n\n## 功能概述\n这是一个标准的AES加密接口。你提供需要加密的明文和密钥，我们返回经过Base64编码的密文。\n\n> [!IMPORTANT]\n> **关于密钥 `key`**\n> 我们支持 AES-128, AES-192, 和 AES-256。请确保你提供的密钥 `key` 的长度（字节数）正好是 **16**、**24** 或 **32**，以分别对应这三种加密强度。"
},
{
"name": "text-post-text-analyze",
"description": "文本分析\n\n想知道一篇文章有多少字、多少个词、或者多少行？这个接口可以帮你快速统计。\n\n## 功能概述\n你提供一段文本，我们会从多个维度进行分析，并返回其字符数、词数、句子数、段落数和行数。这对于文本编辑、内容管理等场景非常有用。"
},
{
"name": "text-post-text-base64-decode",
"description": "Base64 解码\n\n这是一个简单实用的 Base64 解码工具。\n\n## 功能概述\n你提供一个 Base64 编码的字符串，我们帮你解码成原始的 UTF-8 文本。"
},
{
"name": "text-post-text-base64-encode",
"description": "Base64 编码\n\n这是一个简单实用的 Base64 编码工具。\n\n## 功能概述\n你提供一段原始文本，我们帮你转换成 Base64 编码的字符串。"
},
{
"name": "text-get-text-md5",
"description": "MD5 哈希\n\n一个快速计算文本 MD5 哈希值的工具，适用于短文本且不关心参数暴露的场景。\n\n## 功能概述\n通过GET请求的查询参数传入文本，返回其32位小写的MD5哈希值。\n\n> [!NOTE]\n> 对于较长或敏感的文本，我们推荐使用本接口的 POST 版本，以避免URL长度限制和参数暴露问题。"
},
{
"name": "text-post-text-md5",
"description": "MD5 哈希 (POST)\n\n一个用于计算文本 MD5 哈希值的标准工具，推荐使用此版本。\n\n## 功能概述\n通过POST请求的表单体传入文本，返回其32位小写的MD5哈希值。相比GET版本，此方法更适合处理较长或包含敏感信息的文本。"
},
{
"name": "text-post-text-md5-verify",
"description": "MD5 校验\n\n下载了一个文件，想确认它在传输过程中有没有损坏？校验MD5值是最常用的方法。\n\n## 功能概述\n你提供原始文本和一个MD5哈希值，我们帮你计算文本的哈希，并与你提供的哈希进行比对，告诉你它们是否匹配。这在文件完整性校验等场景下非常有用。"
},
{
"name": "text-post-text-aes-encrypt-advanced",
"description": "AES高级加密\n\n需要更灵活的AES加密方案？这个高级接口支持6种加密模式和3种填充方式，让你根据具体场景选择最合适的加密配置。\n\n> [!IMPORTANT]\n> **推荐使用GCM模式**\n> GCM模式提供认证加密(AEAD)，不仅能加密数据，还能验证数据完整性，防止密文被篡改。这是目前最推荐的加密模式。\n\n## 功能概述\n这是一个功能全面的AES加密接口，支持多种加密模式和填充方式。你可以根据不同的安全需求和性能要求，灵活选择合适的加密配置。\n\n### 支持的加密模式\n- **GCM模式**（推荐）：认证加密模式，提供完整性保护\n- **CBC模式**：经典块加密模式，需要IV和填充，适用于文件加密\n- **CTR模式**：流密码模式，无需填充，适用于实时数据加密\n- **OFB/CFB模式**：流密码模式，无需填充，适用于流数据加密\n- **ECB模式**（不推荐）：仅用于兼容性需求\n\n### 支持的填充方式\n- **PKCS7填充**（推荐）：标准填充方式\n- **Zero填充**：使用0x00字节填充\n- **None填充**：无填充，用于流密码模式\n\n### 输出格式支持\n- **base64**（默认）：标准Base64编码输出，适合传输和存储\n- **hex**：十六进制编码输出，方便与在线加密工具对比验证\n\n通过 `output_format` 参数可以直接获取HEX格式的密文，无需额外调用转换接口。\n\n## 参数说明\n- **`text`**: 待加密的明文文本\n- **`key`**: 加密密钥（支持任意长度）\n- **`mode`**: 加密模式（可选，默认GCM）\n- **`padding`**: 填充方式（可选，默认PKCS7）\n- **`iv`**: 自定义IV（可选，Base64编码，16字节）\n- **`output_format`**: 输出格式（可选，默认base64）\n\n## 使用示例\n\n**示例1：HEX格式输出**\n```json\n{\n \"text\": \"测试文本123\",\n \"key\": \"1234567890123456\",\n \"mode\": \"ECB\",\n \"padding\": \"PKCS7\",\n \"output_format\": \"hex\"\n}\n```\n返回示例：\n```json\n{\n \"ciphertext\": \"aaaca6027da10918bb5d23d81939552c\",\n \"mode\": \"ECB\",\n \"padding\": \"PKCS7\"\n}\n```\n\n**示例2：Base64格式输出（默认）**\n```json\n{\n \"text\": \"测试文本123\",\n \"key\": \"1234567890123456\",\n \"mode\": \"ECB\",\n \"padding\": \"PKCS7\"\n}\n```\n返回示例：\n```json\n{\n \"ciphertext\": \"qqymAn2hCRi7XSPYGTlVLA==\",\n \"mode\": \"ECB\",\n \"padding\": \"PKCS7\"\n}\n```\n\n## 技术规格\n- **加密算法**: AES-256\n- **编码格式**: Base64/HEX（输入/输出）\n- **IV长度**: 16字节（128位）\n- **版本标注**: v3.4.8+\n\n> [!NOTE]\n> **关于IV（初始化向量）**\n> - GCM模式无需提供IV\n> - CBC/CTR/OFB/CFB模式可选提供IV\n> - ECB模式不使用IV\n> - 建议每次加密使用不同的IV以确保安全性\n\n> [!TIP]\n> **关于输出格式**\n> - 如需与在线加密工具（如 toolhelper.cn）对比结果，建议使用 `output_format: \"hex\"` \n> - Base64格式更适合网络传输和API调用\n> - 两种格式可以相互转换，数据完全一致"
},
{
"name": "text-post-text-aes-decrypt-advanced",
"description": "AES高级解密\n\n需要解密通过高级加密接口加密的数据？这个接口提供与加密接口完全配对的解密功能，支持相同的6种加密模式和3种填充方式。\n\n> [!IMPORTANT]\n> **解密参数必须与加密时一致**\n> 解密时，必须提供与加密时相同的密钥、模式和填充方式。对于非GCM模式，还需要提供加密时返回的IV。\n\n## 功能概述\n这是一个功能完整的AES解密接口，能够解密通过高级加密接口加密的所有密文。支持所有6种加密模式和3种填充方式，与加密接口完全配对。\n\n### 解密流程\n1. 获取加密时返回的密文和配置参数\n2. 使用相同的密钥、模式、填充方式和IV（如需要）\n3. 调用本接口进行解密\n4. 获取原始明文\n\n### 支持的解密模式\n- **GCM模式**（推荐）：自动验证数据完整性，如果密文被篡改会解密失败\n- **CBC模式**：经典块解密模式，需要提供加密时的IV\n- **CTR/OFB/CFB模式**：流密码解密，需要提供加密时的IV\n- **ECB模式**：不需要IV，但安全性较低\n\n### 填充方式处理\n- **PKCS7填充**：解密后自动移除填充\n- **Zero填充**：解密后自动移除0x00填充\n- **None填充**：无填充处理\n\n## 参数说明\n- **`text`**: 待解密的密文（Base64编码，来自加密接口返回的ciphertext字段）\n- **`key`**: 解密密钥（必须与加密时相同）\n- **`mode`**: 加密模式（必须与加密时相同）\n- **`padding`**: 填充方式（可选，默认PKCS7，必须与加密时相同）\n- **`iv`**: 初始化向量（非GCM模式必须提供，Base64编码）\n\n## 常见错误处理\n如果解密失败，请检查以下几点：\n- 密钥是否与加密时完全相同\n- 模式和填充方式是否匹配\n- 非GCM模式下是否提供了正确的IV\n- 密文是否完整且未被修改\n- GCM模式下密文是否被篡改"
},
{
"name": "text-post-text-convert",
"description": "格式转换\n\n需要在不同文本格式之间转换？这个接口支持Base64、Hex、URL、HTML、Unicode等多种格式互转，还能生成MD5、SHA256等哈希值。\n\n## 功能概述\n你提供待转换的文本、源格式和目标格式，接口会自动完成转换。支持7种双向格式（plain、base64、hex、url、html、unicode、binary）和4种单向哈希（md5、sha1、sha256、sha512）。\n\n## 格式说明\n**双向转换格式**：plain（纯文本）、base64、hex（十六进制）、url、html（HTML实体）、unicode（\\uXXXX转义）、binary（二进制字符串）\n\n**单向哈希格式**：md5、sha1、sha256、sha512（仅可作为目标格式，不可逆）\n\n## 链式转换\n支持多次调用实现复杂转换，如先将文本转为base64，再将base64转为hex。"
},
{
"name": "translate-post-translate-text",
"description": "翻译\n\n需要跨越语言的鸿沟进行交流？这个翻译接口是你可靠的'同声传译'。\n\n## 功能概述\n你可以将一段源语言文本（我们能自动检测源语言）翻译成你指定的任何目标语言。无论是中译英、日译法，都不在话下。\n\n## 支持的语言\n我们支持超过100种语言的互译，包括但不限于：中文（简体/繁体）、英语、日语、韩语、法语、德语、西班牙语、俄语、阿拉伯语等主流语言，以及各种小语种。详见下方参数列表。"
},
{
"name": "translate-post-ai-translate",
"description": "AI智能翻译\n\n这是一个商业级的AI智能翻译服务，采用最新的神经网络翻译技术和大语言模型，提供远超传统机器翻译的质量。\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者深度集成和测试。未来，它将转为付费API，为用户提供更稳定、更智能的翻译服务。\n\n## 功能概述\n\n- **智能双模式**: 支持单个文本翻译和批量文本翻译的统一接口设计，自动识别请求类型并提供相应的翻译服务。系统会根据输入自动判断是处理单条文本还是批量文本，无需使用不同的接口。\n- **多风格适配**: 提供随意口语化、专业商务、学术正式、文学艺术四种翻译风格，能够根据不同场景需求调整翻译的语言风格和表达方式。\n- **上下文感知**: 支持通用、商务、技术、医疗、法律、市场营销、娱乐、教育、新闻等九种专业领域的上下文翻译，确保术语准确性和表达地道性。\n- **高质量保证**: 内置质量评估系统，对每次翻译结果进行流畅度、准确度、完整性评分，并提供置信度分数和替代翻译建议。\n- **智能解释**: 提供关键词组翻译注释、文化背景说明和语法结构分析，帮助用户理解翻译逻辑和文化差异。\n- **高效批量**: 批量翻译支持最多50条文本，总计10万字符，配备智能并发控制（1-10并发）和失败重试机制。\n- **快速模式**: 提供快速模式选项，在保证95%+准确率的前提下，响应时间缩短至800ms内，适合实时翻译和聊天应用。\n- **格式保留**: 智能识别并保持原文的格式结构，包括换行、缩进、特殊符号等，确保翻译后的文本保持良好的可读性。"
},
{
"name": "translate-get-ai-translate-languages",
"description": "AI翻译配置\n\n获取AI智能翻译服务支持的完整语言列表、翻译风格选项、上下文场景选项以及性能指标信息。"
},
{
"name": "translate-post-translate-stream",
"description": "流式翻译（中英互译）\n\n想让翻译结果像打字机一样逐字显示出来？这个流式翻译接口能实现这种效果。\n\n## 功能概述\n不同于传统翻译API一次性返回完整结果，这个接口会实时地、一个字一个字地把翻译内容推给你（就像ChatGPT回复消息那样），非常适合用在聊天应用、直播字幕等需要即时反馈的场景。\n\n## 它能做什么\n- **中英互译**：支持中文和英文之间的双向翻译\n- **自动识别**：不确定源语言？设置为 `auto` 让我们自动检测\n- **逐字返回**：翻译结果会像打字机一样逐字流式返回，用户体验更流畅\n- **音频朗读**：部分翻译结果会附带音频链接，方便朗读\n\n## 支持的语言\n目前专注于中英互译，支持以下选项：\n- `中文`（简体/繁体）\n- `英文`\n- `auto`（自动检测）"
},
{
"name": "web-parse-get-webparse-extractimages",
"description": "提取网页图片\n\n想批量获取一个网页上的所有图片链接？这个接口帮你搞定。\n\n## 功能概述\n提供一个网页 URL，返回该页面中所有图片的链接列表。适合用于图片采集、素材下载等场景。"
},
{
"name": "web-parse-get-webparse-metadata",
"description": "提取网页元数据\n\n想在应用里做链接预览卡片？这个接口帮你一键获取网页的标题、描述、图标等信息。\n\n## 功能概述\n提供一个网页 URL，返回该页面的元数据，包括标题、描述、关键词、Favicon、Open Graph 信息等。非常适合用于生成链接预览卡片或做 SEO 分析。"
},
{
"name": "web-parse-post-web-tomarkdown-async",
"description": "网页转 Markdown\n\n想把一个网页的内容转成干净的 Markdown 文本？这个异步接口可以帮你搞定，特别适合处理大型或复杂的网页。\n\n## 功能概述\n\n> [!VIP]\n> 本 API 目前处于**限时免费**阶段，未来将转为付费服务。\n\n提交一个网页 URL，我们会自动抓取主体内容，剔除广告、导航栏等干扰元素，并转换为 Markdown 格式。同时会提取标题、作者、发布日期等元数据，生成 YAML Front Matter。\n\n任务提交后会立即返回任务 ID，你可以用它来查询处理进度和结果。单个任务最长处理 60 秒，结果缓存 30 分钟。"
},
{
"name": "web-parse-get-web-tomarkdown-async-status",
"description": "转换任务状态\n\n提交了网页转 Markdown 任务后，想知道处理进度和结果？用这个接口来查询。\n\n## 功能概述\n通过任务 ID 查询转换任务的当前状态、处理进度和最终结果。任务结果缓存 30 分钟，期间可重复查询。\n\n## 任务状态\n\n| 状态 | 说明 |\n|------|------|\n| `pending` | 等待处理 |\n| `processing` | 处理中 |\n| `completed` | 已完成，可获取结果 |\n| `failed` | 失败 |\n| `timeout` | 超时（超过 60 秒） |\n\n> [!NOTE]\n> 建议每 2-5 秒轮询一次，当状态为 `completed`、`failed` 或 `timeout` 时停止轮询。"
},
{
"name": "clipzy--post-clipzy-store",
"description": "步骤1：上传加密数据\n\n这是所有流程的第一步。您的客户端应用需要先在本地准备好 **加密后的数据**，然后调用此接口进行上传。成功后，您会得到一个用于后续操作的唯一ID。\n\n> [!NOTE]\n> 您发送给此接口的应该是**密文**，而不是原始文本。请参考文档首页的JavaScript示例来了解如何在客户端进行加密。"
},
{
"name": "clipzy--get-clipzy-get",
"description": "步骤2 (方法一): 获取加密数据\n\n**此接口用于“最高安全等级”方法。**\n\n您提供第一步中获得的ID，它会返回存储在服务器上的**加密数据**。您需要在自己的客户端中，使用您自己保管的密钥来解密它。"
},
{
"name": "clipzy--get-clipzy-raw",
"description": "步骤2 (方法二): 获取原始文本\n\n**此接口用于“方便自动化”方法。**\n\n您提供第一步获得的ID，并附上您自己保管的**解密密钥**作为 `key` 参数。服务器会直接为您解密，并返回纯文本内容。\n\n> [!IMPORTANT]\n> 查看文档首页的 **cURL 示例**，了解此接口最典型的用法。"
},
{
"name": "search-post-search-aggregate",
"description": "智能搜索\n\n想在你的应用中集成搜索功能？我们提供了一个强大的搜索引擎API，让你可以轻松实现实时网页搜索。\n\n## 功能概述\n\nUAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索结果进行智能排序，确保最相关的内容排在前面。你可以用它搜索任何关键词，也可以限定在特定网站或特定文件类型中搜索。\n\n- **实时网页搜索**: 毫秒级响应，快速返回搜索结果\n- **智能排序**: 采用机器学习回归排序算法，结果更精准\n- **时间排序**: 支持按发布时间排序，获取最新内容\n- **时间范围过滤**: 支持按天/周/月/年过滤结果\n- **站内搜索**: 支持 `site:` 操作符，在指定网站内搜索\n- **文件类型过滤**: 支持 `filetype:` 操作符，快速找到 PDF、Word 等特定格式文件\n\n> [!VIP]\n> 本API目前处于**限时免费**阶段，我们鼓励开发者集成和测试。未来，它将转为付费API，为用户提供更稳定和强大的服务。\n "
},
{
"name": "search-get-search-engines",
"description": "搜索引擎配置\n\n获取 UAPI Pro Search 引擎的详细信息，包括支持的功能特性、参数限制和使用说明。\n\n## 功能概述\n\n此接口返回搜索引擎的完整配置信息，你可以用它来：\n- 了解搜索引擎支持哪些功能（如站内搜索、文件类型过滤等）\n- 获取参数的默认值和限制范围\n- 查看当前引擎版本和可用状态\n\n适合在应用初始化时调用，或用于动态配置搜索界面。\n "
},
{
"name": "text-post-sensitive-word-analyze",
"description": "分析敏感词\n\n分析单个或多个关键词的敏感程度，返回标准化风险标签与置信度结果。\n\n> [!VIP]\n> 本API基于先进的分析模型，提供三级缓存策略和并发处理能力。\n\n## 功能概述\n\n- **模型驱动**: 使用先进的分析模型进行语义分析。\n- **高性能**: 采用三级缓存策略（持久化存储 → 统一缓存 → 模型分析），确保高频请求的响应速度。\n- **并发支持**: 支持批量并发处理，单次最多可分析100个关键词。\n- **标准标签**: 返回 `label` 字段，明确区分 `sensitive` 与 `normal`。\n- **分类清晰**: 返回 `category` 字段，用于标识具体风险类别。\n- **置信度输出**: 返回 `confidence` 字段，范围为0.0到1.0。\n\n## 响应字段说明\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `results` | array | 分析结果对象的数组。 |\n| `results[].k` | string | 您在请求中提供的原始关键词。 |\n| `results[].label` | string | 核心判断字段：`sensitive`(敏感)、`normal`(正常)。 |\n| `results[].category` | string | 风险分类：`safe`(安全)、`threat`(威胁)、`porn`(色情)、`fraud`(欺诈)、`insult`(辱骂)。 |\n| `results[].confidence` | number | 当前分类的置信度，范围0.0到1.0。 |\n| `total` | integer | 本次请求成功分析的关键词总数。 |\n "
},
{
"name": "text-get-sensitive-word-analyze-query",
"description": "敏感词分析 (GET)\n\n通过URL查询参数分析单个关键词，便于GET请求调用。"
},
{
"name": "text-post-sensitive-word-quick-check",
"description": "敏感词检测（快速）\n\n在你的社区或应用中，需要来过滤掉不和谐的声音吗？这个接口可以助你一臂之力。\n\n## 功能概述\n\n我们对敏感词检测接口进行了大幅升级，现在采用高效的 **Aho-Corasick 算法**，实现了多模式字符串匹配。这意味着你不再需要手动编写复杂的正则表达式，系统会自动高效地检测出文本中的所有敏感词。\n\n### 主要特性\n\n- **高性能算法**：基于 Aho-Corasick 算法，单次扫描即可检测多个敏感词模式\n- **简繁体支持**：自动识别和处理简体中文、繁体中文内容\n- **多模匹配**：无需编写正则表达式，系统内置智能匹配逻辑\n- **快速响应**：相比传统方法，检测速度显著提升\n\n无论是论坛、社交平台还是评论系统，这个接口都能帮你快速构建内容审核功能。"
}
]
}