工具 API 文档（14 模块 30+ 接口）

基础URL: https://tools.wktyl.com
维护: Xianyan 团队 | 更新时间: 2026-08-15
跳转: 查重 API · 全量搜索 · Feed 信息流

职责：汉字/成语/诗词工具（查询/转换/生成），站长工具（IP/SEO/合规），查重（21 种数据源）。

1. 通用约定

• 大多数接口无需登录
• 频率限制：单接口 30/60s，搜索类 30/60s
• 响应 {code, msg, time, data}

2. 接口清单

2.1 汉语工具

• POST /api/tool/pinyin — 转拼音（带声调/无声调）
• POST /api/tool/wubi — 转五笔编码
• POST /api/tool/stroke — 查笔画
• POST /api/tool/cangjie — 转仓颉编码
• POST /api/tool/zhuyin — 转注音

2.2 网站工具

• GET /api/tool/whois — 域名 Whois
• GET /api/tool/dns — DNS 解析
• GET /api/tool/icp — ICP 备案查询
• GET /api/tool/screenshot?url=... — 网页截图（需 worker）

2.3 热搜

• GET /api/tool/hotSearch — 当前热搜词
• GET /api/tool/hotWord/{platform} — 按平台热搜（weibo / zhihu / baidu / douyin…）
• GET /api/tool/trend/{keyword} — 趋势分析

2.4 站长工具

• GET /api/tool/qrcode?text=...&size=... — 生成二维码
• POST /api/tool/shorturl — 生成短链
• GET /api/tool/seoCheck?url=... — SEO 检查（meta/heading/tags）
• GET /api/tool/speedTest?url=... — 速度测试（首字节 / 加载时长）

2.5 统计（已在 STATISTICS_DOC 详述）

2.6 站内全文搜索

• GET /api/tool/fullSearch?q=... — 全站内容搜索（31 种数据源）
• GET /api/tool/fullSearch/suggest?q=... — 搜索建议

2.7 酒方大全

• GET /api/tool/jiufang/list?type=药酒|滋补|养生&page=...
• GET /api/tool/jiufang/{id} — 详情

2.8 图片水印

• POST /api/tool/imageWatermark — 给图片加水印（文字/图片水印）

2.9 纠错

• POST /api/tool/correction — 用户上报错误

2.10 查重（详见 CHECK_API）

• 21 种数据源精确/模糊/相似度查重

2.11 浏览次数

• 所有列表接口响应都带 views 字段，详情接口访问自动 +1

3. 核心示例

POST /api/tool/pinyin
Content-Type: application/json

{ "text": "床前明月光", "tone": true }

# 响应
{
  "code": 1,
  "data": {
    "pinyin_tone": "chuáng qián míng yuè guāng",
    "pinyin_no_tone": "chuang qian ming yue guang",
    "chars": [
      { "char": "床", "pinyin": "chuáng" },
      { "char": "前", "pinyin": "qián" }
    ]
  }
}

4. 设计要点

• 工具类接口无需登录：纯查询工具，加频率限制防滥用即可
• 拼音/五笔/笔画复用一套：底层字典表 + 转换逻辑，前端按需调用
• 查重独立成 controller：21 种数据源，统一接口在 CHECK_API
• 访问次数自动累加：阅读习惯与热度排序的核心指标

5. 关联文档

• 查重 API
• 全量搜索
• Feed 信息流
• IP 查询
• 天气查询