开放 API
五个免费端点，无需注册和密钥，任意来源直接调用。数据口径与全站一致：16,777,216 色空间、32,258 个命名色、17,756 档标准色卡、659 个中国传统色。
接口一览
全部端点已开启 CORS，浏览器与 Node.js 都能直接 fetch。
GET/api/search?q=crimson&limit=8搜索颜色：颜色名、标准色号、传统色名与 HEX 模糊匹配GET/api/color/e63946颜色档案：10 种格式转换 + 最近命名色 + 8 体系标准对位 + 传统色对位 + 六种调和 + 对比度GET/api/scheme?hex=e63946&mode=triadic调和配色：六种规则围绕主色生成方案GET/api/contrast?fg=ffffff&bg=e63946对比度检查：WCAG 比值 + AA/AAA 判定 + 最佳文字色GET/api/random?count=5随机一色：从精选命名色池抽取，最多 10 个
GET/api/search?q=crimson&limit=8
搜索颜色：颜色名、标准色号、传统色名与 HEX 模糊匹配
请求参数
| q | 搜索关键词：支持 HEX 色值（ff0000）、颜色名称（crimson）、标准色号（RAL 3020） |
| limit | 返回条数上限，默认 12，最大 50 |
调用示例
curl "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/search?q=crimson&limit=8"
浏览器直接 fetch 即可，已开启 CORS。
响应示例
{
"query": "crimson",
"results": [
{ "name": "BM 1299 Crimson", "hex": "b1625b", "source": "standard", "system": "benjamin_moore", "code": "BM 1299" },
{ "name": "crimson", "hex": "dc143c", "source": "standard", "system": "css_named", "code": "crimson" }
]
}GET/api/color/e63946
颜色档案：10 种格式转换 + 最近命名色 + 8 体系标准对位 + 传统色对位 + 六种调和 + 对比度
请求参数
| hex | 颜色值：3 或 6 位 HEX（e63946 或 e63） |
调用示例
curl "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/color/e63946"
响应示例
{
"hex": "e63946",
"formats": {
"rgb": { "r": 230, "g": 57, "b": 70 },
"hsl": { "h": 355.5, "s": 77.6, "l": 56.3 },
"hsv": { "h": 355.5, "s": 75.2, "v": 90.2 },
"cmyk": { "c": 0, "m": 75.2, "y": 69.6, "k": 9.8 },
"xyz": { "x": 0.352, "y": 0.2019, "z": 0.0784 },
"lab": { "L": 52.06, "a": 65.72, "b": 34.14 },
"oklch": { "L": 0.612, "c": 0.208, "h": 22.2 },
"webSafe": "ff3333",
"css": { "rgb": "rgb(230, 57, 70)", "hsl": "hsl(355.5, 77.6%, 56.3%)" }
},
"named": {
"closest": { "name": "Paint the Town Red", "hex": "e63045", "deltaE": 1.34, "exact": false },
"nearest": [ { "name": "Red Radish", "hex": "ee3344", "deltaE": 1.36, "exact": false } ]
},
"standards": [
{ "system": "ncs", "systemName": "NCS (Natural Color System)", "code": "NCS S 0570-Y90R", "name": "NCS S 0570-Y90R", "hex": "e6373f", "deltaE": 1.69, "exact": false },
{ "system": "munsell", "systemName": "Munsell (Re-renotation)", "code": "7.5R 6/16", "name": "7.5R 6/16", "hex": "dd3743", "deltaE": 2.02, "exact": false }
],
"traditional": [
{ "name": "火红", "hex": "ff2d51", "cat": "红", "deltaE": 4.88, "exact": false },
{ "name": "银红", "hex": "f05654", "cat": "红", "deltaE": 5.89, "exact": false }
],
"harmony": [
{ "type": "complementary", "colors": ["e63946", "39e6d9"] },
{ "type": "split-complementary", "colors": ["e63946", "39e683", "399de6"] }
],
"contrast": {
"onWhite": { "ratio": 4.17, "levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false } },
"onBlack": { "ratio": 5.04, "levels": { "aaNormal": true, "aaLarge": true, "aaaNormal": false, "aaaLarge": true } },
"bestText": "#000000"
}
}GET/api/scheme?hex=e63946&mode=triadic
调和配色：六种规则围绕主色生成方案
请求参数
| hex | 颜色值：3 或 6 位 HEX（e63946 或 e63） |
| mode | 调和规则，默认 complementary。可选：complementary / split-complementary / triadic / tetradic / analogous / monochromatic |
调用示例
curl "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/scheme?hex=e63946&mode=triadic"
响应示例
{
"hex": "e63946",
"mode": "triadic",
"count": 3,
"colors": ["e63946", "46e639", "3946e6"]
}GET/api/contrast?fg=ffffff&bg=e63946
对比度检查：WCAG 比值 + AA/AAA 判定 + 最佳文字色
请求参数
| fg | 前景色 HEX，如 ffffff |
| bg | 背景色 HEX，如 e63946 |
调用示例
curl "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/contrast?fg=ffffff&bg=e63946"
响应示例
{
"fg": "ffffff",
"bg": "e63946",
"ratio": 4.17,
"label": "AA Large",
"levels": { "aaNormal": false, "aaLarge": true, "aaaNormal": false, "aaaLarge": false },
"bestText": "#000000"
}GET/api/random?count=5
随机一色：从精选命名色池抽取，最多 10 个
请求参数
| count | 随机个数，1–10，默认 1 |
调用示例
curl "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/random?count=5"
响应示例
{
"count": 3,
"colors": [
{ "name": "Sea Foam Green", "hex": "c2e4d0" },
{ "name": "Deep Koamaru", "hex": "333366" },
{ "name": "Laser Lemon", "hex": "ffff66" }
]
}开放数据下载
不止接口——整库数据直接拿走。CSV 格式（UTF-8，首行表头），适用于数据分析、机器学习与设计系统研究。字段说明见表头，数据持续随构建更新。
color-names.csv32,258 行下载 CSVstandards.csv18,998 行下载 CSVbrands.csv3,290 行下载 CSVtraditional-colors.csv659 行下载 CSVjapanese-colors.csv184 行下载 CSVdesign-systems.csv2,041 行下载 CSVtheme-palettes.csv320 行下载 CSVclassic-palettes.csv508 行下载 CSVwide-gamut.csv4,444 行下载 CSVcrayola.csv133 行下载 CSVcolorbrewer.csv1,689 行下载 CSVart-palettes.csv674 行下载 CSVlego.csv111 行下载 CSVflags.csv690 行下载 CSVcolormaps.csv752 行下载 CSVdunhuang.csv39 行下载 CSVskin-tones.csv18 行下载 CSV
命名色数据基于 meodai/color-names（MIT）与 xkcd Color Survey；品牌色基于 simple-icons 开放数据；中国传统色基于 zerosoul/chinese-colors 与中国色站数据；标准色卡色值为计算机模拟转换，生产环境请以实物色卡为准。使用请遵循对应上游许可。
开源代码库
整站引擎与数据已打包为开源库，可离线运行、可嵌入生产环境。npm 三件套覆盖色彩引擎、数据集与 MCP Server，另有 Python 移植与 HuggingFace 数据集。
@yanseku/color
色彩引擎：10 色彩空间互转、CIEDE2000、APCA、OKLab 混色、6 调和规则、色觉模拟——纯计算零依赖
npm install @yanseku/color
@yanseku/data
数据集：17 库 85,000+ 条目（命名色/标准卡/传统色/日本色/品牌色…），JSON 直读，LAB 预计算
npm install @yanseku/data
@yanseku/mcp
MCP Server：把整个颜色库接入 Claude / Cursor 等 AI 客户端，7 个工具离线可用
npm install -g @yanseku/mcp
yanseku (Python)
Python 版：pip 一装即用，同款 D65 数学与 ΔE2000，内置 659 传统色典故
pip install yanseku
MCP 配置·远程（免安装，直接连云端数据库）
{
"mcpServers": {
"yanseku": {
"url": "https://bfa7d18b-8d8f-4701-9c86-b87b2a0b3e3e.dev.coze.site/api/mcp"
}
}
}MCP 配置·本地（npx 离线运行）
{
"mcpServers": {
"yanseku": {
"command": "npx",
"args": ["-y", "@yanseku/mcp"]
}
}
}与其他色彩库的能力对比
常见色彩库只做数学转换；Yanseku 独有的是「数据层」：命名色检索、官方色卡对位与传统色典故。
| 能力 | Yanseku | colorjs.io | culori | chroma-js |
|---|---|---|---|---|
| 色彩空间互转（10 种格式） | ✔ | ✔ | ✔ | |
| CIEDE2000 色差 | ✔ | ✔ | ✔ | |
| APCA 感知对比度 | ✔ | ✘ | ✘ | |
| 色觉缺陷模拟（8 型） | ✔ | ✘ | ✘ | |
| 命名色检索（32,258） | ✔ 32,258 | ✘ | ✘ | |
| 官方色卡对位（13 体系） | ✔ 18,114 | ✘ | ✘ | |
| 中国传统色典故（659） | ✔ 659 | ✘ | ✘ | |
| 感知调和规则 | ✔ 6 rules | ✘ | ✔ palette | |
| MCP Server（离线） | ✔ remote + offline | ✘ | ✘ | |
| Python 移植 | ✔ | ✘ | ✘ | |
| 整库 CSV / HF Dataset | ✔ 17 sets | ✘ | ✘ |
发布渠道: npm (@yanseku/color · @yanseku/data · @yanseku/mcp) · PyPI (yanseku) · HuggingFace (yanseku/chinese-traditional-colors)
来源标记：standard = 官方标准色卡；community = 社区命名色；traditional = 中国传统色
免费公开接口，请合理调用（建议 ≤ 60 次/分钟）。