{"schemaVersion":"0.1.0","name":"UApiPro","description":"WebMCP discovery manifest for UApiPro. The /mcp URL also serves the MCP transport for `initialize`, `tools/list`, and `tools/call`.","serverUrl":"https://uapis.cn/mcp","serverCard":"https://uapis.cn/.well-known/mcp/server-card.json","protocolVersion":"2025-03-26","protocolVersions":["2025-06-18","2025-03-26","2024-11-05"],"serverInfo":{"name":"UApiPro","version":"3.1.0","title":"UApiPro public API"},"instructions":"UApiPro exposes 100+ free public REST endpoints (network, image, text,\ntranslation, social, search, etc.) as MCP tools.\n\nWorkflow:\n1. Call `tools/list` to discover capabilities.\n2. Each tool is one HTTP endpoint under https://uapis.cn/api/v1/. The\n tool name maps to the OpenAPI operationId.\n3. Free-tier tools work without authentication. Paid tools require an\n API key, supplied via the `_apiKey` argument or the `X-API-Key`\n request header on the MCP transport.\n4. Honour the X-RateLimit-* headers exposed in tool results.\n\nOpenAPI document: https://uapis.cn/openapi.json\nPricing: https://uapis.cn/pricing.md","transports":[{"type":"streamable-http","url":"https://uapis.cn/mcp","preferred":true,"description":"Streamable HTTP transport (MCP over HTTP via JSON-RPC 2.0). Send a single POST per request and accept either application/json or text/event-stream."},{"type":"streamable-http","url":"https://uapis.cn/api/mcp","description":"Alias of /mcp under /api so consumers behind path-restricted proxies can still reach the server."},{"type":"stdio","install":"npx -y @uapi/mcp-server","description":"Stdio transport for desktop AI clients (Claude Desktop, etc.)."}],"documentation":{"serverCard":"https://uapis.cn/.well-known/mcp/server-card.json","openapi":"https://uapis.cn/openapi.json","agentCard":"https://uapis.cn/.well-known/agent-card.json","aiPlugin":"https://uapis.cn/.well-known/ai-plugin.json","apiCatalog":"https://uapis.cn/.well-known/api-catalog","agents":"https://uapis.cn/AGENTS.md","llmsFull":"https://uapis.cn/llms-full.txt"},"capabilities":{"tools":{"listChanged":false},"prompts":false,"resources":false,"sampling":false,"completions":{}},"tools":[{"name":"post_convert_json","title":"JSON 格式化","description":"还在为一团乱麻的 JSON 字符串头疼吗？这个接口能瞬间让它变得井井有条，赏心悦目。 ## 功能概述 你只需要提供一个原始的、可能是压缩过的或者格式混乱的 JSON 字符串，这个 API 就会返回一个经过美化（带标准缩进和换行）的版本。这在调试 API 响应、或者需要在前端界面清晰展示 JSON 数据时非常有用。 ## 使用须知 > [!NOTE] > **请求格式** > 请注意，待格式化的 JSON 字符串需要被包裹在另一个 JSON 对象中，作为 content 字段的 Calls POST https://uapis.cn/api/v1/convert/json."},{"name":"get_convert_unixtime","title":"时间戳转换","description":"时间戳和日期字符串，哪个用着更顺手？别纠结了，这个接口让你轻松拥有两种格式！ ## 功能概述 这是一个非常智能的转换器。你给它一个 Unix 时间戳，它还你一个人类可读的日期时间；你给它一个日期时间字符串，它还你一个 Unix 时间戳。它会自动识别你输入的是哪种格式。 ## 使用须知 这个接口非常智能，能够自动识别输入格式： - **输入时间戳**：支持10位秒级（如 1672531200）和13位毫秒级（如 1672531200000）。 - **输入日期字符串**：为了确 Calls GET https://uapis.cn/api/v1/convert/unixtime."},{"name":"get_daily_news_image","title":"每日新闻图","description":"想用一张图快速了解天下大事？这个接口为你一键生成今日新闻摘要，非常适合用在早报、数字看板或应用首页等场景。 ## 功能概述 此接口会实时抓取各大平台的热点新闻，并动态地将它们渲染成一张清晰、美观的摘要图片。你调用接口，直接就能得到一张可以展示的图片。 ## 使用须知 调用此接口时，请务必注意以下两点： 1. **响应格式是图片**：接口成功时直接返回 image/jpeg 格式的二进制数据，而非 JSON。请确保你的客户端能正确处理二进制流，例如直接在 标签里播放，或者将其下载保存为本地音频文件。另外，“单词查询”接口中返回的 audio 字段，实际上也就是直接拼装好的本接口地址。 ## 使用须知 > [!NOTE] > 本接口成功调用时返回的是 audio/mpeg 格式的二进制音频流 Calls GET https://uapis.cn/api/v1/dictionary/audio."},{"name":"get_game_minecraft_historyid","title":"查询 MC 曾用名","description":"想知道某个大佬以前叫什么名字吗？这个接口可以帮你追溯一个 Minecraft 玩家的“黑历史”！ ## 功能概述 通过提供玩家的用户名或 UUID，你可以获取到该玩家所有曾用名及其变更时间的列表。这对于识别回归的老玩家或者社区管理非常有用。 ## 使用须知 > [!NOTE] > **参数说明** > - name 和 uuid 二选一 > - UUID 支持带连字符（如 ee9b4ed1-aac1-491e-b761-1471be374b80）或不带连字符格式 > [!IM Calls GET https://uapis.cn/api/v1/game/minecraft/historyid."},{"name":"get_game_minecraft_serverstatus","title":"查询 MC 服务器","description":"想在加入服务器前看看有多少人在线？或者检查一下服务器开没开？用这个接口就对了！ ## 功能概述 你可以通过提供服务器地址（域名或IP），来获取一个 Minecraft Java 版服务器的实时状态。返回信息包括服务器是否在线、当前玩家数、最大玩家数、服务器版本、MOTD（每日消息）以及服务器图标等。 如果服务器返回当前在线玩家列表，响应里还会带上 online_players 字段。这个字段可能省略，部分服务器返回的列表也可能不完整。 Calls GET https://uapis.cn/api/v1/game/minecraft/serverstatus."},{"name":"get_game_minecraft_userinfo","title":"查询 MC 玩家","description":"只需要一个玩家的用户名，就能快速获取到他的正版皮肤和独一无二的UUID！ ## 功能概述 这是一个基础但非常实用的接口。通过玩家当前的游戏内名称（Username），你可以查询到他对应的UUID（唯一标识符）和当前皮肤的URL地址。这是构建许多其他玩家相关服务的第一步。 Calls GET https://uapis.cn/api/v1/game/minecraft/userinfo."},{"name":"get_game_steam_summary","title":"查询 Steam 用户","description":"想在你的网站或应用中展示用户的 Steam 个人资料？这个接口就是为你准备的。 ## 功能概述 通过一个用户的 Steam 标识（支持多种格式），你可以获取到他公开的个人资料摘要，包括昵称、头像、在线状态、真实姓名（如果公开）和个人资料主页URL等信息。 ## 支持的参数格式 接口现在支持以下几种标识符格式： - **steamid**: 64位SteamID（如 76561197960287930） - **id**: 自定义URL名称（如 gabelogannewell） Calls GET https://uapis.cn/api/v1/game/steam/summary."},{"name":"get_game_epic_free","title":"Epic 免费游戏","description":"白嫖党的福音来了！想第一时间知道Epic商店本周送了哪些游戏大作吗？ ## 功能概述 这个接口帮你实时追踪Epic Games商店的每周免费游戏活动。无需任何参数，调用后即可获得当前所有免费游戏的完整信息，包括游戏封面、原价、剩余时间等，再也不用担心错过心仪的免费游戏了！ ## 使用场景 - 开发游戏资讯应用或网站 - 制作Epic免费游戏推送机器人 - 为用户提供游戏收藏建议 - 构建个人游戏库管理工具 > [!TIP] > **关于时间格式** > 为了方便不同场景的使用 Calls GET https://uapis.cn/api/v1/game/epic-free."},{"name":"get_game_minecraft_version","title":"Minecraft 最新版本","description":"需要在启动器、服务器面板或机器人里实时显示 Minecraft 的最新版本？这个接口帮你一键拿到当前的正式版和快照版。 ## 功能概述 无需任何参数，直接返回最新正式版（latest release）、最新快照版（latest snapshot）以及完整的版本列表。适合做版本提示、更新检测或服务端版本看板。 ## 使用须知 > [!NOTE] > 数据会随新版本发布而更新，建议在客户端适当缓存，无需高频轮询。 Calls GET https://uapis.cn/api/v1/game/minecraft/version."},{"name":"get_game_steam_servers","title":"查询 Steam 游戏服务器","description":"想在自己的面板或社区里展示某款游戏的在线服务器？这个接口支持查询使用 A2S/Steam 服务器列表的多人游戏，例如 SCUM、ARK、Rust、CS2 等。 ## 功能概述 传入游戏的 Steam AppID，即可获取当前在线的服务器列表，包含名称、IP、端口、当前/最大人数、地图等信息。你还可以用 name 做服务器名称模糊搜索，用 limit 控制返回数量。 ## 常见 AppID - SCUM：513710 - ARK：346110 - Rust：252490 - C Calls GET https://uapis.cn/api/v1/game/steam/servers."},{"name":"get_game_minecraft_mods","title":"搜索 MC Mod/插件","description":"想给你的启动器、服务器面板或资源推荐页加上 Mod/插件搜索？这个接口一次帮你检索 Modrinth 与 SpigotMC 上的资源。 ## 功能概述 传入关键词，即可拿到资源名称、简介、作者、下载量、评分、项目页和下载地址。可以用 source 指定只搜某个平台，用 type 过滤资源类型，用 limit 控制每个平台返回的数量。 ## 使用须知 > [!NOTE] > 默认会补全作者名与下载直链。如果只想要更快的基础搜索结果，设置 enrich=false 即可降低延迟。 Calls GET https://uapis.cn/api/v1/game/minecraft/mods."},{"name":"get_image_bing_daily","title":"获取必应每日壁纸","description":"这个接口可以获取最新或指定日期的必应壁纸。默认直接返回图片，也可以传 format=json 获取元数据，或者传 format=redirect 直接跳转到最终图片地址。 ## 功能概述 - 不传参数时，默认返回当天壁纸图片二进制 - 可以传 date 查询指定日期的壁纸 - 可以传 resolution 选择 4k 或 1080 - 可以传 format 控制返回图片、JSON 或 302 跳转 - 当传 format=json 时，返回的是扁平 JSON 对象，里面会包含 Calls GET https://uapis.cn/api/v1/image/bing-daily."},{"name":"get_image_bing_daily_history","title":"查询必应壁纸历史","description":"这个接口用于查询必应壁纸历史列表，也可以按日期精确查询某一天。默认按时间倒序返回 JSON。 ## 功能概述 - 可以传 date 精确查询某一天，命中后只返回 1 条数据 - 不传 date 时，按时间倒序分页返回历史列表 - 可以传 resolution 让 image_url 直接对应 4k 或 1080 - 可以传 page 和 page_size 控制分页 - 每条记录都是扁平 JSON 对象，里面会包含标题、副标题、说明文案、版权信息、问答信息和图片地址等字段 # Calls GET https://uapis.cn/api/v1/image/bing-daily/history."},{"name":"post_image_frombase64","title":"通过Base64编码上传图片","description":"当你需要在前端处理完图片（比如裁剪、加滤镜后），不通过传统表单，而是直接上传图片的场景，这个接口就派上用场了。 ## 功能概述 你只需要将图片的 Base64 编码字符串发送过来，我们就会把它解码、保存为图片文件，并返回一个可供访问的公开 URL。 ## 使用须知 > [!IMPORTANT] > **关于 imageData 格式** > 你发送的 imageData 字符串必须是完整的 Base64 Data URI 格式，它需要包含 MIME 类型信息，例如 data: Calls POST https://uapis.cn/api/v1/image/frombase64."},{"name":"get_image_motou","title":"生成摸摸头GIF (QQ号)","description":"想在线rua一下好友的头像吗？这个趣味接口可以满足你。 ## 功能概述 此接口通过GET方法，专门用于通过QQ号生成摸摸头GIF。你只需要提供一个QQ号码，我们就会自动获取其公开头像，并制作成一个可爱的动图。 ## 使用须知 - **响应格式**：接口成功时直接返回 image/gif 格式的二进制数据。 - **背景颜色**：你可以通过 bg_color 参数来控制GIF的背景。使用 transparent 选项可以让它更好地融入各种聊天背景中。 Calls GET https://uapis.cn/api/v1/image/motou."},{"name":"post_image_motou","title":"生成摸摸头GIF","description":"除了使用QQ头像，你还可以通过上传自己的图片或提供图片URL来制作独一无二的摸摸头GIF。 ## 功能概述 此接口通过POST方法，支持两种方式生成GIF： 1. **图片URL**：在表单中提供 image_url 字段。 2. **上传图片**：在表单中上传 file 文件。 ## 使用须知 - **响应格式**：接口成功时直接返回 image/gif 格式的二进制数据。 - **参数优先级**：如果同时提供了 image_url 和上传的 file 文件，系统将 **优 Calls POST https://uapis.cn/api/v1/image/motou."},{"name":"post_image_speechless","title":"生成你们怎么不说话了表情包","description":"你们怎么不说话了？是不是都在偷偷玩Uapi，求求你们不要玩Uapi了 ## 使用须知 - **响应格式**：接口成功时直接返回 image/png 格式的二进制数据。 - **文字内容**：至少需要提供 top_text（上方文字）或 bottom_text（下方文字）之一。 - **梗图逻辑**：上方描述某个行为，下方通常以「们」开头表示劝阻，形成戏谑的对比效果。 Calls POST https://uapis.cn/api/v1/image/speechless."},{"name":"get_image_qrcode","title":"生成二维码","description":"无论是网址、文本还是联系方式，通通可以变成一个二维码！这是一个非常灵活的二维码生成工具。 ## 功能概述 你提供一段文本内容，我们为你生成对应的二维码图片。你可以自定义尺寸、前景色、背景色，还支持透明背景，并选择不同的返回格式以适应不同场景。 Calls GET https://uapis.cn/api/v1/image/qrcode."},{"name":"get_image_tobase64","title":"图片转 Base64","description":"看到一张网上的图片，想把它转换成 Base64 编码以便嵌入到你的 HTML 或 CSS 中？用这个接口就对了。 ## 功能概述 你提供一个公开可访问的图片 URL，我们帮你把它下载下来，并转换成包含 MIME 类型的 Base64 Data URI 字符串返回给你。 Calls GET https://uapis.cn/api/v1/image/tobase64."},{"name":"post_image_decode","title":"解码并缩放图片","description":"在 RAM 和 Flash 极其有限的设备上解码图片是一项繁重的任务。这个接口专为 IoT 和嵌入式开发设计，将复杂的图像解码和缩放操作转移到云端，直接输出适用于单片机屏幕的二进制像素流。 ## 功能概述 此接口提供了灵活的云端图像预处理能力，帮助硬件开发者跳过繁琐的图像处理逻辑： - **直接推流渲染**：如果选择输出纯像素流（如 RGB565），单片机收到网络数据后无需解析文件头，可直接将其写入显存，实现极低内存占用的边下边播。 - **完美适配屏幕**：无需在设备端编写 Calls POST https://uapis.cn/api/v1/image/decode."},{"name":"post_image_svg","title":"SVG转图片","description":"需要将灵活的 SVG 矢量图形转换为常见的光栅图像格式吗？这个接口可以帮你轻松实现。 ## 功能概述 上传一个 SVG 文件，并指定目标格式（如 PNG、JPEG 等），接口将返回转换后的图像。你还可以调整输出图像的尺寸和（对于JPEG）压缩质量，以满足不同场景的需求。 Calls POST https://uapis.cn/api/v1/image/svg."},{"name":"post_image_compress","title":"无损压缩图片","description":"还在为图片体积和加载速度发愁吗？体验一下我们强大的**无损压缩服务**，它能在几乎不牺牲任何肉眼可感知的画质的前提下，将图片体积压缩到极致。 ## 功能概述 你只需要上传一张常见的图片（如 PNG, JPG），选择一个压缩等级，就能获得一个体积小到惊人的压缩文件。这对于需要大量展示高清图片的网站、App 或小程序来说，是优化用户体验、节省带宽和存储成本的利器。 ## 使用须知 > [!TIP] > 图片越大或压缩等级越高，处理时间可能越长，请您耐心等待。 > [!WARNIN Calls POST https://uapis.cn/api/v1/image/compress."},{"name":"get_avatar_gravatar","title":"获取Gravatar头像","description":"提供稳定、易用的头像获取能力，适合在网页或应用中直接展示头像。 Calls GET https://uapis.cn/api/v1/avatar/gravatar."},{"name":"post_image_ocr","title":"通用 OCR 文字识别","description":"无论您是需要实现票据的自动化录入，还是在网页前端对图片上的文字进行坐标框选，这个高精度的 OCR 接口都能为您提供强大的基础能力。 ## 功能概述 > [!IMPORTANT] > 如果您只关心图片上写了什么（例如截图取字或内容安全审核），强烈建议将 need_location 设置为 false。这会大幅精简返回的 JSON 数据体积，提升网络传输与系统解析效率。 除了常规的图片转文字，这个接口还针对实际开发场景做了一些实用设计： - **前端文字高亮与结构化分析**：默认 Calls POST https://uapis.cn/api/v1/image/ocr."},{"name":"post_image_nsfw","title":"图片敏感检测","description":"这是一个图片内容审核接口，自动识别图片中的违规内容并返回处理建议。 ## 功能概述 上传图片文件或提供图片URL，接口会自动分析图片内容，返回是否违规、风险等级和处理建议。适合对接到用户上传流程中，实现自动化内容审核。 ## 返回字段说明 - **is_nsfw**: 是否判定为违规内容，true 表示违规，false 表示正常 - **nsfw_score**: 违规内容置信度，0-1 之间，越高表示越可能违规 - **normal_score**: 正常内容置信度，0-1 Calls POST https://uapis.cn/api/v1/image/nsfw."},{"name":"post_watermark_embed","title":"添加图片隐水印","description":"想给自己的原创图片打上专属烙印，又不想破坏画面美感？或者是为了 AIGC 生成的图片做后续溯源追踪？这个接口能帮您把自定义标识悄悄藏进图片里。 ## 功能概述 您可以上传图片并指定一段标识文本，接口会利用算法将这段文本隐形嵌入到图片的像素之中。嵌入后的图片在肉眼看来毫无变化，但能够有效抵抗常见的缩放、裁剪、社交平台压缩与二次转发。适合用于标记图片来源、追踪分发渠道或进行隐蔽的版权确权。 ## 使用须知 **容量限制**：受限于隐形水印的算法特性，图片能嵌入的字符长度有限（通常 Calls POST https://uapis.cn/api/v1/watermark/embed."},{"name":"post_watermark_decode","title":"提取图片隐水印","description":"遇到一张疑似被盗用或 AI 生成的图片，想查查它有没有被打过“思想钢印”？直接把图片扔给这个接口，它能把藏在里面的标识完完整整地提取出来。 ## 功能概述 此接口用于检测图片中是否包含隐形水印，若存在则还原出写入的原始标识内容。即使图片经历过压缩、截取或多次网络转发，也具备较高的成功提取率。接口具备防误判机制，若图片确实未经过处理，会明确返回未检测到结果，而不会强制拼接无效内容。 ## 使用须知 如果您在嵌入水印时修改过进阶参数（如 ecc 或 model_type），在提取 Calls POST https://uapis.cn/api/v1/watermark/decode."},{"name":"post_watermark_label","title":"添加 AI 生成内容标识","description":"AI 生成的图片上线前需要满足国标合规要求？别头疼，调用一次这个接口，就能自动给图片打上符合《GB 45438-2025》标准的三层标识。 ## 三层标识说明 此接口一次性支持注入以下三种符合国标规范的标识： - **元数据隐式标识**（默认开启）：在图片文件的 EXIF/XMP 元数据中记录此内容的“AI 生成”属性及服务提供者信息，不影响视觉呈现。 - **可见角标标识**（可选）：在图片指定角落叠加醒目的“AI 生成”文字，字号会自动计算以符合国标关于“字符高度不小于画 Calls POST https://uapis.cn/api/v1/watermark/label."},{"name":"post_watermark_producer_code","title":"生成 AIGC 服务提供者编码","description":"还在发愁怎么拼出符合《GB 45438-2025》要求的 27 位 AIGC 服务提供者编码？无论是想一键生成自己的专属合规编码，还是想校验已有编码对不对，这个接口都能帮您轻松搞定。 ## 功能概述 此接口具备“生成”与“校验”双重能力： - **生成模式**：填入组织或个人的主体身份信息与证件号，接口会自动处理复杂的拼位规则，输出标准的 27 位编码。 - **校验模式**：仅需填入现成的 code，接口将逐段拆解、验证其合法性，并解析出各个组成部分的实际含义。 ## 使用 Calls POST https://uapis.cn/api/v1/watermark/producer-code."},{"name":"get_misc_hotboard","title":"查询热榜","description":"想快速跟上网络热点？这个接口让你一网打尽各大主流平台的实时热榜/热搜！ ## 功能概述 你只需要指定一个平台类型，就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。 ## 三种使用模式 ### 默认模式 只传 type 参数，返回该平台当前的实时热榜。 ### 时光机模式 传 type + time 参数，返回指定时间附近最近可展示的历史热榜快照。 ### 搜索模式 传 type + keyword + tim Calls GET https://uapis.cn/api/v1/misc/hotboard."},{"name":"get_misc_movie_box_office","title":"查询电影票房","description":"正在做影视类应用，想直观展示今天哪部电影最卖座？大盘总票房突破了多少？这个接口能帮你实时获取院线大盘和影片票房排名。 ## 功能概述 调用此接口，无需任何参数，即可获取当前实时的电影市场大盘数据（包含总票房、总场次、总人次），以及每一部上映影片的具体表现（包括票房明细、排片占比、上座率、场均人次和累计票房等）。 Calls GET https://uapis.cn/api/v1/misc/movie-box-office."},{"name":"get_misc_phoneinfo","title":"查询手机归属地","description":"想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。 ## 功能概述 提供一个国内的手机号码，我们会查询并返回它的归属地（省份和城市）以及所属的运营商信息。 Calls GET https://uapis.cn/api/v1/misc/phoneinfo."},{"name":"get_misc_randomnumber","title":"随机数生成","description":"需要一个简单的随机数，还是需要一串不重复的、带小数的随机数？这个接口都能满足你！ ## 功能概述 这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。 ## 使用须知 > [!WARNING] > **不重复生成的逻辑限制** > 当设置 allow_repeat=false 时，请确保取值范围 (max - min + 1) 大于或等于你请求的数量 count。否则，系统将无法生成足够的不重复数字，请求会 Calls GET https://uapis.cn/api/v1/misc/randomnumber."},{"name":"get_misc_timestamp","title":"转换时间戳 (旧版，推荐使用/convert/unixtime)","description":"转换时间戳 (旧版，推荐使用/convert/unixtime) Calls GET https://uapis.cn/api/v1/misc/timestamp."},{"name":"get_misc_weather","title":"查询天气","description":"出门前，查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据，支持国内和国际城市。 ## 功能概述 这个接口支持三种查询方式： - 可以传 adcode，按行政区编码查询（优先级最高） - 可以传 city，按城市名称查询，支持中文（北京）和英文（Tokyo） - 两个都不传时，按客户端 IP 自动定位查询 支持 lang 参数，可选 zh（默认）和 en，城市名翻译覆盖 7000+ 城市。 ## 可选功能模块 - extended=true：扩展气象字段（体感温度、 Calls GET https://uapis.cn/api/v1/misc/weather."},{"name":"get_misc_worldtime","title":"查询世界时间","description":"需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。 ## 功能概述 根据标准的时区名称（例如 'Asia/Shanghai' 或 'Europe/London'），获取该时区的当前准确时间、UTC偏移量、星期等信息。 Calls GET https://uapis.cn/api/v1/misc/worldtime."},{"name":"get_misc_lunartime","title":"查询农历时间","description":"需要在指定时区下查看某个时间点的农历信息？这个接口可以直接返回完整结果。 ## 功能概述 支持传入 Unix 时间戳（秒或毫秒）和 IANA 时区名，返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 ts 时默认使用当前时间，不传 timezone 时默认 Asia/Shanghai。 ## 时区说明 - 支持标准 IANA 时区，例如 Asia/Shanghai、Asia/Tokyo - 也支持别名：Shanghai、Beijing - 时区非法时返回 40 Calls GET https://uapis.cn/api/v1/misc/lunartime."},{"name":"get_misc_holiday_calendar","title":"查询节假日与万年历","description":"查询指定日期、月份或年份的万年历与节假日信息。 ## 功能概述 这个接口支持三种查询方式：按天（date）、按月（month）和按年（year）。调用时三者选一个传入即可。 如果你只关心某一类事件，可以通过 holiday_type 进行筛选，例如只看法定休假/调休、公历节日、农历节日或节气。 在 date 模式下，传 include_nearby=true 可以额外返回该日期前后最近的节日；返回数量由 nearby_limit 控制，默认 7，最大 30。 如果你只想保留今 Calls GET https://uapis.cn/api/v1/misc/holiday-calendar."},{"name":"get_history_programmer_today","title":"程序员历史上的今天","description":"想知道程序员历史上的今天发生了什么大事吗？这个接口告诉你答案！ ## 功能概述 我们使用AI智能筛选从海量历史事件中挑选出与程序员、计算机科学相关的重要事件。每个事件都经过重要性评分和相关性评分，确保内容质量。 Calls GET https://uapis.cn/api/v1/history/programmer/today."},{"name":"get_history_programmer","title":"程序员历史事件","description":"想查看程序员历史上某个特定日期发生的大事件？指定月份和日期，我们就能告诉你！ ## 功能概述 通过指定月份和日期，获取该日发生的程序员相关历史事件。同样使用AI智能筛选，确保事件的相关性和重要性。 Calls GET https://uapis.cn/api/v1/history/programmer."},{"name":"get_misc_tracking_query","title":"查询快递物流信息","description":"买了东西想知道快递到哪儿了？这个接口帮你实时追踪物流状态。 ## 功能概述 提供一个快递单号，系统会自动识别快递公司并返回完整的物流轨迹信息。这个接口目前可以查询中通、圆通、韵达、申通、极兔、顺丰、京东、EMS、德邦等主流快递公司的物流信息。 ## 使用须知 - **自动识别**：不知道是哪家快递？系统会根据单号规则自动识别快递公司（推荐使用） - **手动指定**：如果已知快递公司，可以传递 carrier_code 参数，查询速度会更快 - **手机尾号验证**：顺丰等部 Calls GET https://uapis.cn/api/v1/misc/tracking/query."},{"name":"get_misc_tracking_detect","title":"识别快递公司","description":"不确定手里的快递单号属于哪家快递公司？这个接口专门做识别，不查物流。 ## 功能概述 输入快递单号，系统会根据单号规则快速识别出最可能的快递公司。如果存在多个可能的匹配结果，还会在 alternatives 字段中返回备选项，供你参考选择。 ## 使用须知 - **识别速度快**：只做规则匹配，不查询物流信息，响应速度通常在100ms内 - **准确率高**：基于各快递公司的单号规则进行智能识别，准确率超过95% - **备选方案**：当单号规则可能匹配多家快递公司时，会提供 Calls GET https://uapis.cn/api/v1/misc/tracking/detect."},{"name":"get_misc_tracking_carriers","title":"获取支持的快递公司列表","description":"不确定系统支持哪些快递公司？这个接口返回完整的支持列表。 ## 功能概述 获取系统当前支持的所有快递公司列表，包括每家公司的标准编码（code）和中文名称（name）。 ## 使用建议 - **推荐缓存**：这个列表基本不会频繁变动，建议在应用启动时调用一次并缓存到本地 - **应用场景**：适合用于构建快递公司选择器、下拉菜单等UI组件 - **缓存时长**：建议缓存24小时或更久 Calls GET https://uapis.cn/api/v1/misc/tracking/carriers."},{"name":"post_misc_date_diff","title":"计算两个日期之间的时间差值","description":"想知道两个日期之间相差多久？这个接口帮你精确计算时间差值。 ## 功能概述 输入开始日期和结束日期，返回它们之间的时间差，包括总天数、总小时数、总分钟数、总秒数、总周数，以及人性化显示格式（如\"1年2月3天\"）。 ## 日期格式 接口支持自动识别常见日期格式，包括：YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601（带时区）等。也可以通过format参数显式指定格式（如DD-MM-YYYY）。 > [!NOTE] > 当结束日期早于开始日期时， Calls POST https://uapis.cn/api/v1/misc/date-diff."},{"name":"get_misc_district","title":"Adcode 国内外行政区域查询","description":"一个接口，覆盖全球 243 个国家、中国省/市/区/街道四级行政区划，支持关键词搜索、行政编码查询、坐标反查三种查询模式（必须至少传入一种查询参数）。 ## 功能概述 根据用户输入的搜索条件快速查找行政区域信息。例如：中国 > 山东省 > 济南市 > 历下区 > 舜华路街道。 无需注册、无需密钥，直接调用即可获取结构化的行政区域数据。支持三种查询方式： - 传 adcode，按行政编码精确查询，同时返回下级区划列表 - 传 lat + lng，坐标反查附近地点 - 传 key Calls GET https://uapis.cn/api/v1/misc/district."},{"name":"get_misc_weather_history","title":"查询历史天气","description":"想知道某个城市过去一段时间有没有下雨、降雨量是多少？这个接口用于查询过去最多 366 天的城市每日历史天气。 ## 功能概述 支持按 city、adcode 或客户端 IP 自动定位查询。你可以传 start_date + end_date 指定日期范围，也可以只传 days 回看最近若干天。返回结果重点包含 rained 与 rain，适合做出行复盘、农业记录、气象看板和数据分析。 ## 使用须知 > [!NOTE] > 定位优先级：adcode > city > IP 自 Calls GET https://uapis.cn/api/v1/misc/weather/history."},{"name":"get_misc_movie_rating_rank","title":"电影收视排行查询","description":"想做影视榜单页或选题分析？这个接口提供影视的收视、热度和评分排行，既能查实时榜，也能按日、周、月回看历史快照。 ## 功能概述 用 channel 切换全网、卫视、网络平台或院线榜单，用 period + date 查询历史日榜、周榜和月榜。适合影视资讯页、数据看板、自媒体选题和内容运营分析。 Calls GET https://uapis.cn/api/v1/misc/movie-rating-rank."},{"name":"get_network_dns","title":"执行DNS解析查询","description":"想知道一个域名指向了哪个IP？或者它的邮件服务器是谁？这个接口就像一个在线的 dig 或 nslookup 工具。 ## 功能概述 你可以查询指定域名的各种DNS记录，包括 A (IPv4), AAAA (IPv6), CNAME (别名), MX (邮件交换), NS (域名服务器) 和 TXT (文本记录)。 Calls GET https://uapis.cn/api/v1/network/dns."},{"name":"get_network_icp","title":"查询域名ICP备案信息","description":"想知道一个网站的背后运营主体是谁吗？如果它是在中国大陆运营的，ICP备案信息可以告诉你答案。 ## 功能概述 提供一个域名，查询其在中国工信部的ICP（Internet Content Provider）备案信息。这对于商业合作前的背景调查、验证网站合法性等场景很有帮助。 > [!NOTE] > **查询范围** > 此查询仅对在中国大陆工信部进行过备案的域名有效。对于国外域名或未备案的域名，将查询不到结果。 Calls GET https://uapis.cn/api/v1/network/icp."},{"name":"get_network_ipinfo","title":"查询 IP","description":"想知道一个IP地址或域名来自哪里？这个接口可以帮你定位它。默认返回标准结果；如果传 source=commercial，可以返回更完整的位置信息。 ## 功能概述 提供一个公网IPv4、IPv6地址或域名，我们会查询并返回它的地理位置（国家、省份、城市）、经纬度、以及所属的运营商（ISP）和自治系统（ASN）信息。这在网络安全分析、访问来源统计等领域非常有用。 当传 source=commercial 时，响应中会补充更完整的市、区、运营商、时区、海拔等信息，响应时间可能会稍 Calls GET https://uapis.cn/api/v1/network/ipinfo."},{"name":"get_network_myip","title":"查询我的 IP","description":"想知道你自己的出口公网IP是多少吗？这个接口就是你的“网络身份证”。默认返回标准结果；如果传 source=commercial，可以返回更完整的位置信息。 ## 功能概述 调用此接口，它会返回你（即发起请求的客户端）的公网IP地址，并附带与 /network/ipinfo 接口相同的地理位置和网络归属信息。非常适合用于在网页上向用户展示他们自己的IP和地理位置。 当传 source=commercial 时，响应中会补充更完整的市、区、运营商、时区、海拔等信息，响应时间可能 Calls GET https://uapis.cn/api/v1/network/myip."},{"name":"get_network_ping","title":"Ping 主机","description":"想知道从我们的服务器到你的服务器网络延迟高不高？这个工具可以帮你测试网络连通性。 ## 功能概述 这个接口会从我们的服务器节点对你指定的主机（域名或IP地址）执行 ICMP Ping 操作。它会返回最小、最大、平均延迟以及丢包率等关键指标，是诊断网络问题的得力助手。 Calls GET https://uapis.cn/api/v1/network/ping."},{"name":"get_network_pingmyip","title":"Ping 我的 IP","description":"这是一个非常方便的快捷接口，想知道你的网络到我们服务器的回程延迟吗？点一下就行！ ## 功能概述 这个接口是 /network/myip 和 /network/ping 的结合体。它会自动获取你客户端的公网IP，然后从我们的服务器Ping这个IP，并返回延迟数据。这对于快速判断你本地网络到服务器的连接质量非常有用。 Calls GET https://uapis.cn/api/v1/network/pingmyip."},{"name":"get_network_portscan","title":"端口扫描","description":"想检查一下你的服务器上某个端口（比如SSH的22端口或者Web的80端口）是否对外开放？这个工具可以帮你快速确认。 ## 功能概述 你可以指定一个主机和端口号，我们的服务器会尝试连接该端口，并告诉你它是开放的（open）、关闭的（closed）还是超时了（timeout）。这对于网络服务配置检查和基本的安全扫描很有用。 Calls GET https://uapis.cn/api/v1/network/portscan."},{"name":"get_network_urlstatus","title":"检查URL的可访问性状态","description":"你的网站或API还好吗？用这个接口给它做个快速“体检”吧。 ## 功能概述 提供一个URL，我们会向它发起一个请求，并返回其HTTP响应状态码。这是一种简单而有效的服务可用性监控方法。 Calls GET https://uapis.cn/api/v1/network/urlstatus."},{"name":"get_network_whois","title":"查询域名的WHOIS注册信息","description":"想知道一个域名是什么时候注册的、注册商是谁、什么时候到期？WHOIS信息可以告诉你这一切。 ## 功能概述 这是一个在线的WHOIS查询工具。你可以通过如下两种方式获取WHOIS信息： - **默认行为**（不带参数）：GET /api/v1/network/whois?domain=google.com - 返回一个JSON对象，whois 字段为原始、未处理的WHOIS文本字符串。 - **JSON格式化**：GET /api/v1/network/whois?domai Calls GET https://uapis.cn/api/v1/network/whois."},{"name":"get_network_wxdomain","title":"检查域名在微信中的访问状态","description":"准备在微信里推广你的网站？最好先检查一下域名是否被“拉黑”了。 ## 功能概述 这个接口可以帮你查询一个域名在微信内置浏览器中的访问状态，即是否被微信封禁。这对于做微信生态推广和营销的开发者来说至关重要。 Calls GET https://uapis.cn/api/v1/network/wxdomain."},{"name":"get_saying_random","title":"一言（随机/每日/场景/此刻）","description":"一言接口，返回一条随机语录。通过 mode 参数切换四种返回方式，并支持按来源、分类、标签过滤。 ## 四种模式（mode） - **random（默认）**：每次调用随机返回一条语录。 - **daily**：同一天内返回固定的同一条，适合每日打卡、签到等场景。 - **recommend**：配合 scene 参数，返回指定场景（如 night、morning）的语录。 - **moment**：根据请求时所处时段，自动返回应景语录。 ## 语言控制 语料分中英文两类，可 Calls GET https://uapis.cn/api/v1/saying/random."},{"name":"get_saying","title":"一言","description":"想在你的应用里每天展示一句不一样的话，给用户一点小小的惊喜吗？这个“一言”接口就是为此而生。 ## 功能概述 每次调用，它都会从我们精心收集的、包含数千条诗词、动漫台词、名人名言的语料库中，随机返回一条。你可以用它来做网站首页的Slogan、应用的启动语，或者任何需要灵感点缀的地方。 Calls GET https://uapis.cn/api/v1/saying."},{"name":"get_random_image","title":"随机图片","description":"需要一张随机图片作为占位符或者背景吗？这个接口是你的不二之选。 ## 功能概述 这是一个非常简单的接口，它会从我们庞大的图库和精选外部图床中随机挑选一张图片，然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的