ओपन API
पाँच मुफ्त एंडपॉइंट, कोई साइनअप नहीं, कोई कुंजी नहीं, CORS-सक्षम। साइट जैसा ही डेटा: 24-बिट स्पेस, 32,258 नामित रंग, 17,756 मानक स्वैच और 659 चीनी पारंपरिक रंग।
एक नज़र में एंडपॉइंट
प्रत्येक एंडपॉइंट CORS-सक्षम है - ब्राउज़र या Node.js से सीधे फ़ेच करें।
GET/api/search?q=crimson&limit=8
नाम, मानक कोड, पारंपरिक नाम या HEX द्वारा रंग खोजें
पैरामीटर
| q | क्वेरी कीवर्ड: HEX मान (ff0000), रंग नाम (crimson) या मानक कोड (RAL 3020) |
| limit | अधिकतम परिणाम, डिफ़ॉल्ट 12, 50 तक सीमित |
उदाहरण अनुरोध
curl "https://www.yanseku.com/api/search?q=crimson&limit=8"
ब्राउज़र में सीधे फ़ेच काम करता है (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 मानक सिस्टम में मेल + पारंपरिक मेल + 6 सामंजस्य + कंट्रास्ट
पैरामीटर
| hex | रंग मान: 3 या 6 हेक्स अंक (e63946 या e63) |
उदाहरण अनुरोध
curl "https://www.yanseku.com/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 हेक्स अंक (e63946 या e63) |
| mode | सामंजस्य मोड, डिफ़ॉल्ट पूरक. विकल्प: complementary / split-complementary / triadic / tetradic / analogous / monochromatic |
उदाहरण अनुरोध
curl "https://www.yanseku.com/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 | फोरग्राउंड हेक्स, उदाहरण के लिए ffffff |
| bg | बैकग्राउंड हेक्स, उदाहरण के लिए e63946 |
उदाहरण अनुरोध
curl "https://www.yanseku.com/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://www.yanseku.com/api/random?count=5"
उदाहरण प्रतिक्रिया
{
"count": 3,
"colors": [
{ "name": "Sea Foam Green", "hex": "c2e4d0" },
{ "name": "Deep Koamaru", "hex": "333366" },
{ "name": "Laser Lemon", "hex": "ffff66" }
]
}ओपन डेटा डाउनलोड
API से परे - पूरी लाइब्रेरी को अपने साथ ले जाएं. CSV फ़ॉर्मेट (UTF-8, हेडर पंक्ति), डेटा विश्लेषण, मशीन लर्निंग और डिज़ाइन-सिस्टम अनुसंधान के लिए तैयार. फ़ील्ड नाम हेडर में हैं; हर बिल्ड के साथ डेटासेट अपडेट होते हैं.
रंग नाम meodai/color-names (MIT) और xkcd कलर सर्वे से लिए गए हैं; ब्रांड रंग simple-icons ओपन डेटा से; चीनी पारंपरिक रंग zerosoul/chinese-colors और zhongguose.com से; मानक स्वैच मान कंप्यूटर-सिमुलेटेड रूपांतरण हैं - उत्पादन के लिए भौतिक स्वैच से सत्यापन करें। संबंधित अपस्ट्रीम लाइसेंस का पालन करें।
ओपन-सोर्स पैकेज
साइट का इंजन और डेटा ओपन-सोर्स लाइब्रेरी के रूप में उपलब्ध हैं - ऑफलाइन-सक्षम, उत्पादन-तैयार। तीन npm पैकेज इंजन, डेटासेट और एक MCP सर्वर को कवर करते हैं, साथ ही एक पायथन पोर्ट और एक हगिंगफेस डेटासेट भी है।
कलर इंजन: 10-फॉर्मेट रूपांतरण, CIEDE2000, APCA, OKLab ब्लेंडिंग, 6 हार्मोनी नियम, दृष्टि सिमुलेशन - शुद्ध गणित, शून्य निर्भरता
npm install @yanseku/color
डेटासेट: 17 कॉर्पोरा, 85,000+ प्रविष्टियाँ (नामित रंग, मानक स्वैच, पारंपरिक, जापानी, ब्रांड...), प्री-कंप्यूटेड LAB के साथ JSON
npm install @yanseku/data
MCP सर्वर: पूरे रंग डेटाबेस को Claude / Cursor में प्लग करें - 7 ऑफलाइन टूल
npm install -g @yanseku/mcp
पायथन पोर्ट: pip install करें और उपयोग करें - समान D65 गणित और deltaE2000, 659 पारंपरिक कहानियाँ संलग्न हैं
pip install yanseku
MCP कॉन्फ़िगरेशन (claude_desktop_config.json)
{
"mcpServers": {
"yanseku": {
"url": "https://www.yanseku.com/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 | ✘ | ✘ | |
| आधिकारिक स्वैच मैचिंग (12 सिस्टम) | ✔ 17,756 | ✘ | ✘ | |
| चीनी पारंपरिक कहानियां (659) | ✔ 659 | ✘ | ✘ | |
| अवधारणात्मक सामंजस्य नियम | ✔ 6 rules | ✘ | ✔ palette | |
| MCP सर्वर (ऑफलाइन) | ✔ remote + offline | ✘ | ✘ | |
| पाइथन पोर्ट | ✔ | ✘ | ✘ | |
| पूर्ण CSV / HF डेटासेट | ✔ 17 sets | ✘ | ✘ |
इसे कहां से प्राप्त करें: npm (@yanseku/color · @yanseku/data · @yanseku/mcp) · PyPI (yanseku) · HuggingFace (yanseku/chinese-traditional-colors)
स्रोत: standard = आधिकारिक स्वैच; community = समुद्र द्वारा नामित रंग; traditional = Chinese traditional color
मुफ्त सार्वजनिक एंडपॉइंट - कृपया उचित रहें (≤ 60 req/min सुझाव दिया गया).