开放服务通过 /openservice 前缀访问,收录查询通过 /api 前缀访问
所有返回 JSON 的接口均使用同一结构,建议以 success 判断成败。
| 字段 | 类型 | 说明 |
|---|---|---|
| success | bool | 请求是否成功。true 成功,false 失败;请以此为唯一判断依据,不要依赖 HTTP 状态码 |
| message | str | 结果描述信息。失败时为具体错误原因(如「请输入待查询的 URL」),可直接展示给用户 |
| data可选 | dict / list / str | 业务数据,成功时返回,具体字段见各接口文档。注意:内容为空时该字段会被整体省略(不是 null),取用前需判空 |
| 其他可选 | any | 附加信息,如请求参数回显,仅部分接口返回 |
// 成功
{
"success": true,
"message": "",
"data": { /* 各接口不同 */ }
}
// 失败(data 无内容时被省略)
{
"success": false,
"message": "invalid expression"
}
多数错误(参数非法、上游异常等)返回 HTTP 200 + success: false;
400(参数错误)、403(无权限/命中黑名单)、429(请求过于频繁)、
502(上游服务不可用)等状态码仅用于部分场景。
涵盖 12 大主题、100+ 分类、100+ 古籍来源的经典名句,可按作者、主题、分类灵活查询。
| 参数 | 说明 |
|---|---|
| rule | 查询规则:author.catalog.suffix,如 libai.shuqing.svg |
| has-url | SVG 输出时是否包含原文链接 |
| font-family | SVG 字体,如 KaiTi |
| fill | SVG 文字颜色,如 #333 |
获取 Bing 每日精选壁纸,支持 720p/1080p/4K 及移动端分辨率,每日 0:30 自动刷新缓存。
| 参数 | 说明 |
|---|---|
| d | 日期(yyyymmdd),默认今天;random 随机 |
| p | 分辨率:720p / 1080p / 4k |
| mobile | 存在则返回移动端分辨率图片 |
| json | 存在则以 JSON 格式返回(否则 302 跳转) |
代理 konachan 官方 API 获取随机动漫壁纸(上游请求经代理访问),图片经 sapic 图床上传保存(国内可直接访问),随机返回桌面版尺寸(1080p/2K,宽≥1920、高≥1080)图片;结果缓存 3 小时,同参数重复请求直接返回缓存。
| 参数 | 说明 |
|---|---|
| random | 存在则从历史缓存记录中随机返回一张(默认读最新缓存) |
| json | 存在则以 JSON 格式返回(否则 302 跳转) |
基于 ip2region 数据库的 IP 定位服务,精确到城市级,支持国家、省份、城市、运营商查询。
| 子模块 | 说明 |
|---|---|
| myip | 返回客户端真实 IP(纯文本) |
| addr | 返回地址详情(文本,如"中国 广东 深圳 电信") |
| rest | 返回完整 JSON(含国家代码等) |
| ?ip= | 子模块的查询参数(可选),指定查询的目标 IP,默认是当前客户端IP |
短域名快捷链接(跳转域名 https://satic.cn 下的保留路径):
基于 croniter 的 Cron 表达式计算工具,可推算接下来或将来的执行时间点。
| 参数 | 说明 |
|---|---|
| expression | Cron 表达式,如 */5 * * * * |
| query_times | 查询次数(1-32,默认 1) |
| query_type | next(之后)/ prev(之前) |
| format_time | 时间格式,默认 %Y-%m-%d %H:%M:%S |
以服务器当前时间为基准推算。
自动拉取并过滤高质量 IPTV 直播源,筛选规则:响应时间 ≤ 100ms 且分辨率为 1080p 或 1920。
| 参数 | 说明 |
|---|---|
| 无 | 直接返回过滤后的 .m3u8 直播源列表 |
| 过滤条件:响应时间 ≤ 100ms,分辨率 1080p+ | |
为家庭影音场景准备的弹幕服务:将上面的地址填入播放器即可自动匹配弹幕,不用再手动找字幕、对时间轴。基于开源项目 misaka_danmu_server 自托管,兼容 弹弹play API 规范,支持弹幕库管理、搜索导入与任务追踪。
| 参数 | 说明 |
|---|---|
| token | 弹幕 Token,在 控制台 创建获取 |
| 弹幕合并输出,支持后备搜索,支持关键词搜索和自动导入 | |
检测指定 URL 是否被百度、必应收录,常用于新站上线后确认收录进度、排查内容未被索引的问题。结果默认缓存,可用 force 强制实时查询。
| 参数 | 说明 |
|---|---|
| url | 必需,待查询的完整 URL(需带 http/https) |
| method | 百度支持 json/html,必应支持 rss/html;留空按默认方式 |
| force | 传 1/true/yes 强制实时查询(忽略缓存) |
| 限速:登录 20 次/天(按 uid),匿名 5 次/天(按 IP) | |
分享自托管、直接通过域名访问的在线工具与加速服务。
基于开源项目 down2local 自托管的中转下载服务:在服务器上替您下载网络资源(GitHub Release、直链文件等)再本地取回,解决本地直接下载缓慢或受限的问题。
自建 Docker Registry Mirror,国内加速拉取 Docker Hub 官方镜像,仅需在 Docker / containerd 中配置镜像加速地址。
Docker Engine(Linux):
sudo tee /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": ["https://registry.tcw.im"]
}
EOF
sudo systemctl restart docker
Docker Desktop(macOS / Windows):打开 Settings → Docker Engine,在 JSON 中加入 "registry-mirrors": ["https://registry.tcw.im"] 后 Apply & Restart。
临时拉取(无需改配置):
docker pull registry.tcw.im/library/nginx:latest
docker tag registry.tcw.im/library/nginx:latest nginx:latest
containerd(Kubernetes 节点,追加到 /etc/containerd/config.toml):
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
endpoint = ["https://registry.tcw.im"]
验证:docker info | grep -i mirrors
选择您常用的方式接入 OpenHub API
curl -s "https://hub.saintic.com/openservice/sentence/" | python -m json.tool
curl -s "https://hub.saintic.com/openservice/ip/rest"
curl -s "https://hub.saintic.com/openservice/bingpic?p=1080p&json=1"
curl -s "https://hub.saintic.com/openservice/konachanpic?json=1"
curl -s "https://hub.saintic.com/openservice/crontab?expression=0%209%20*%20*%201-5&query_times=3"
curl -s "https://hub.saintic.com/openservice/iptv.m3u8" | head -20
curl -s "https://danmu.satic.cn/api/v1/YOUR_TOKEN"
在线调试