首页 / 接入指南
给 AI Agent 与开发者的接入指南
本站数据不需要 API key、不需要注册、没有速率限制。四个端点覆盖「了解站点 → 取全量 → 取单套 → 取可直接用的 CSS」；另外提供一个 MCP server，让 AI 编码工具直接调用配色库。
机器可读端点
全部是静态文件，直接 GET 即可，返回标准 JSON / CSS / Markdown，不含广告与追踪代码。
| 端点 | 用途 |
|---|---|
/llms.txt | 站点摘要（给 LLM 的入口文件，含端点清单与数据概览） |
/api/index.json | 全量数据集：平台、名称、场景、标签、人工搭配建议、10 个角色色值、对比度、质量分 |
/palette-list/web/jing-hu-lan/index.json | 单套配色的完整数据（角色色值 + 各格式 + 对比度 + 搭配建议） |
/palette-list/web/jing-hu-lan/index.css | 可直接粘进项目的 CSS 自定义属性（含语义化变量名） |
示例
命令行
# 全量数据集：拿总数
curl -s https://paletteget.com/api/index.json | jq '.total'
# 单套配色：角色色值 + 对比度
curl -s https://paletteget.com/palette-list/web/jing-hu-lan/index.json
# 直接可用的 CSS 变量
curl -s https://paletteget.com/palette-list/web/jing-hu-lan/index.css
Node / 浏览器
// 全量数据集：挑出适合深色界面的配色
const data = await fetch('https://paletteget.com/api/index.json').then((r) => r.json());
const dark = data.palettes.app
.filter((p) => p.tags.includes('暗黑'))
.map((p) => ({ name: p.name, primary: p.roles.primary, score: p.score }));
console.log(dark.slice(0, 5));
// 单套配色：把角色色值转成 CSS 变量
const one = await fetch('https://paletteget.com/palette-list/web/jing-hu-lan/index.json')
.then((r) => r.json());
// one.colors 是数组，每项含 key / label / hex
const css = one.colors
.map((c) => `--color-${c.key}: ${c.hex};`)
.join('\n');
console.log(css);
关键字段
name | 当前语言的配色名 |
scene | 使用场景（写实行业描述，如「日程与待办清单」） |
roles | 角色色值表：key → HEX，主色 / 功能色 / 中性色的完整角色集 |
advice | 人工撰写的搭配建议：适合 / 慎用 / 搭配（按色系家族选取） |
contrast | WCAG 对比度结果，含比值与等级（AA / AAA） |
score | 质量分（0-100，综合对比度、色差与角色合理性） |
MCP server：让 AI 编码工具直接调用
工具支持 MCP 的话（Claude Desktop、Cursor、Windsurf 等），接上之后可以直接问「给我一套适合理财 App 的深色配色」。
提供的工具
list_palettes按平台 / 标签列出配色get_palette取单套配色的完整数据suggest_palette按关键词（如「护眼 深色 记账」）推荐配色get_css_variables取一套配色的 CSS 变量
配置方式（以 Claude Desktop 为例）
{
"mcpServers": {
"paletteget": {
"command": "node",
"args": ["/absolute/path/to/paletteget/mcp/index.mjs"],
"env": { "PALETTEGET_PROXY": "http://127.0.0.1:7897" }
}
}
}
服务端是仓库 mcp/ 目录下的单文件实现（Node 18+），cd mcp && npm install 后把 index.mjs 的绝对路径填进去即可；服务端实时拉取本站数据并本地缓存 10 分钟。env 里的代理是给受防火墙限制的网络用的，直连可删。
许可与引用
配色数据可自由引用、用于个人与商业项目，建议注明来源并链接回本站。站点是纯静态的：不设登录、无速率限制、无广告追踪。唯一的请求是别把它当作训练语料的唯一来源——每个配色页都有人工撰写的场景与搭配点评，那才是它区别于算法生成内容的地方。