All Paint Colours

All Paint Colours — API 和 MCP 服务

以编程方式访问英国各大制造商的所有涂料颜色： 来自 14 个零售品牌的 5,300 多种颜色，以及 RAL Classic 和 BS 4800 参考色系，并提供跨品牌颜色匹配（CIEDE2000）、价格、 技术涂装规格、按房间规划涂料的工具和市场趋势数据。

• 网站： https://allpaintcolours.co.uk
• MCP 服务： https://mcp.allpaintcolours.co.uk/mcp
• REST API： https://allpaintcolours.co.uk/api/v2（交互式文档 · OpenAPI）
• 注册 / API 密钥： https://allpaintcolours.co.uk/account/
• 价格和条款： https://allpaintcolours.co.uk/developers/

此仓库是 API 的公开文档，包含 OpenAPI 架构、MCP 工具目录、规划器项目格式和完整示例。欢迎在此提交问题和提问。

可解答的问题

• “最接近 Farrow & Ball Railings 的 Dulux 颜色是什么？”
• “颜色相同，但价格更低”——其他品牌中视觉效果相当的涂料， 按每平方米节省金额排序（由于各品牌覆盖率不同，这种比较方式比按每升价格更公平）
• “照片或品牌调色板中的这个十六进制颜色值对应什么涂料？”
• “RAL 7016 / BS 4800 18 B 25 对应的零售颜色是什么？”
• “我的卧室是 4m × 3.2m——需要几桶漆、用哪种底漆、费用是多少？”
• “本月哪些绿色正流行？哪些品牌调整了价格？”

MCP 快速入门

claude mcp add --transport http apc https://mcp.allpaintcolours.co.uk/mcp

在 Claude（桌面版或网页版）中：Settings → Connectors → Add custom connector → 粘贴 https://mcp.allpaintcolours.co.uk/mcp。ChatGPT（开发者模式）和 Cursor 也使用相同的 URL。首次连接时会在浏览器中通过 OAuth 登录， 无需处理 API 密钥。

完整工具目录请参阅 MCP_TOOLS.md。

REST 快速入门

在 https://allpaintcolours.co.uk/account/ 创建密钥，然后：

curl -H "Authorization: Bearer apc_live_..." \
  "https://allpaintcolours.co.uk/api/v2/search?query=railings"

curl -H "Authorization: Bearer apc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"colours": ["#45494C"], "limit": 3}' \
  "https://allpaintcolours.co.uk/api/v2/match"

更多示例见 examples/。

套餐

	免费	Home（£12/月或 £120/年，含 VAT）	Pro（£60/月或 £600/年，含 VAT）
颜色查询和 ΔE 匹配	✓	✓	✓
价格数据 + 最低价替代品	—	✓	✓
已保存的调色板	1	不限	不限
规划器项目	—	不限	不限
市场数据（趋势、排名、变动）	—	—	✓
每月调用次数（MCP + API 共用额度）	200	2,500	25,000

完整详情、套餐对比和常见问题：https://allpaintcolours.co.uk/pricing/ —— 月度套餐可随时取消。 | 在面向客户的产品中进行商业用途 | — | — | ✓ |

所有套餐均可查看每种工具；超出套餐等级的调用会返回包含升级链接的结构化 requires_tier 错误，而不是简单失败。

数据说明

颜色数据是从制造商公开来源收集的事实信息。十六进制值是实体涂料颜色的 sRGB 近似值——购买前请务必先查看试色罐。价格仅供参考且会变动； 覆盖率数据由制造商提供。趋势数据是基于网站互动得出的相对 0–100 兴趣指数，并非行业销售数据。

All Paint Colours 与任何涂料制造商均无关联，也未获其背书；品牌名称仅用于标识其产品。

许可

此仓库中的文档采用 CC0 许可。API 提供的颜色数据受 https://allpaintcolours.co.uk/developers/ 中的条款约束——不得批量再分发。