Cerulean Jobs
Open jobs at luxury houses and brands worldwide: search them, read one in full, find roles like it.
我該用這個嗎
品質與安全性
發現項目(1)
- LOW在 fetch 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"search": {
"url": "https://ceruleanjobs.com/api/mcp"
}
}
}遠端端點
https://ceruleanjobs.com/api/mcpstreamable-http它能做什麼
工具清單
工具(3)
🟢fetch(id, locale)
Use this when someone asks about one specific Cerulean listing — its responsibilities, qualifications, skills, experience, education, pay when the employer states it, benefits or required languages — and its id or Cerulean URL is known. Returns that one listing in full as text, with its url and structured details. It does not search. An unknown or closed listing is an error.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The listing's id, as every result carries it, or its URL on a Cerulean site."
},
"locale": {
"type": "string",
"description": "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en.",
"pattern": "^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$"
}
},
"required": [
"id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string",
"description": "The whole listing as text: its summary, responsibilities, qualifications, skills, experience, education, pay where stated, benefits and languages."
},
"url": {
"type": "string",
"description": "The listing on ceruleanjobs.com, where a candidate reads it in full and applies."
},
"metadata": {
"type": "object",
"properties": {
"brand": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The brand filter's value for this brand."
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"datePosted": {
"type": "string"
},
"employmentType": {
"type": "string"
},
"seniorityLevel": {
"type": "string"
},
"industry": {
"type": "string"
},
"department": {
"type": "string"
},
"compensation": {
"type": [
"null",
"object"
],
"properties": {
"min": {
"type": [
"null",
"number"
]
},
"max": {
"type": [
"null",
"number"
]
},
"currency": {
"type": "string"
},
"period": {
"type": "string"
},
"text": {
"type": "string"
}
},
"description": "The pay the listing states: a range, either end of which may be open, or text. Absent when it states none.",
"additionalProperties": false
},
"languages": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "The languages the role asks for, as ISO 639 codes."
},
"localizedUrl": {
"type": "string"
},
"indexBuiltAt": {
"type": "string"
},
"warnings": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"parameter": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestions": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"brand"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"additionalProperties": false
}🟢find_similar_jobs(id, location, country, locale, limit, ...)
Use this when someone wants more roles like one specific Cerulean listing: the closest open roles by what the job is and where it is. Takes that listing's id, not keywords. If the listing is unknown or has no similarity data, it returns an error rather than unrelated results.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The id of the listing to find roles like, as every result carries it, or its URL on a Cerulean site. It is not among its own results."
},
"location": {
"type": "string",
"description": "Keep only similar roles in this city, region or country."
},
"country": {
"type": "string",
"description": "Keep only similar roles in this country."
},
"locale": {
"type": "string",
"description": "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en.",
"pattern": "^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$"
},
"limit": {
"type": "integer",
"description": "How many similar roles to return, up to 20. Defaults to 12."
},
"offset": {
"type": "integer",
"description": "How many to skip, for the next page. Defaults to 0, maximum 10000."
}
},
"required": [
"id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"similarTo": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The brand filter's value for this brand."
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"brand"
],
"additionalProperties": false
},
"results": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The listing's id: what fetch and find_similar_jobs take."
},
"title": {
"type": "string",
"description": "The job title, in the language of locale where the listing has a translation."
},
"url": {
"type": "string",
"description": "The listing on ceruleanjobs.com, where a candidate reads it in full and applies."
},
"text": {
"type": "string",
"description": "The listing's summary, up to 300 characters."
},
"brand": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The brand filter's value for this brand."
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"datePosted": {
"type": "string",
"description": "When the listing was first seen, RFC 3339."
},
"employmentType": {
"type": "string",
"description": "An employment_type filter value."
},
"seniorityLevel": {
"type": "string",
"description": "A seniority_level filter value."
},
"industry": {
"type": "string",
"description": "An industry filter value."
},
"department": {
"type": "string",
"description": "A department filter value."
},
"localizedUrl": {
"type": "string",
"description": "The listing on the Cerulean site for locale, when that site carries it."
}
},
"required": [
"id",
"title",
"url",
"brand"
],
"additionalProperties": false
}
},
"hasMore": {
"type": "boolean"
},
"offset": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"indexBuiltAt": {
"type": "string"
},
"warnings": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"parameter": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestions": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
}
},
"required": [
"similarTo",
"results",
"hasMore",
"offset",
"limit"
],
"additionalProperties": false
}🟢search(query, brand, location, country, employment_type, ...)
Use this when someone wants to find, browse, count or compare open roles at luxury houses and brands, the newest openings included. The listings are read from the houses' own career sites every four hours, and closed roles drop out. query takes keywords or a plain request ("senior client advisor, Bulgari, Geneva"), and may be empty to browse; brand, place, employment type, seniority, industry and department can also be set as filters, and they combine; posted_within_days keeps only recent listings. Returns one page of listings — each with an id, a short summary and the url where candidates read it and apply — plus total, the number of matches.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords, or the request as a plain sentence (\"senior client advisor, Bulgari, Geneva\"). A brand, place, country or employment type it names is applied as that filter, unless the filter is set, and reported in interpreted. Leave it out, or empty, to browse by filters alone."
},
"brand": {
"type": "string",
"description": "A brand, by name or slug: \"Tiffany & Co.\", \"LV\", \"louis-vuitton\". A name that matches no brand comes back as an unknown_value warning with close spellings."
},
"location": {
"type": "string",
"description": "A city, region or country, in any common spelling: \"Geneva\" or \"Genève\", \"New York\" or \"NYC\", \"Lombardy\", \"UAE\"."
},
"country": {
"type": "string",
"description": "A country, by name or ISO code — \"Switzerland\", \"US\", \"Deutschland\". Narrower than location, and combinable with it."
},
"employment_type": {
"type": "string",
"description": "Employment type.",
"enum": [
"full-time",
"part-time",
"contract",
"temporary",
"seasonal",
"internship",
"volunteer",
"per-diem",
"other"
]
},
"seniority_level": {
"type": "string",
"description": "Seniority level.",
"enum": [
"intern",
"entry-level",
"junior",
"mid-level",
"senior",
"lead",
"supervisor",
"manager",
"director",
"executive"
]
},
"industry": {
"type": "string",
"description": "Industry.",
"enum": [
"fashion-apparel-leather",
"watches-horology",
"high-jewelry",
"perfumes-cosmetics-beauty",
"eyewear-vision-care",
"wines-spirits-gastronomy",
"luxury-hospitality-travel",
"selective-retailing",
"luxury-real-estate",
"yachting-aviation-mobility",
"pre-owned-vintage-luxury",
"media-art-culture",
"luxury-automotive",
"luxury-furniture-homewares",
"high-end-audio-electronics",
"premium-sporting-equipment",
"photography-optics"
]
},
"department": {
"type": "string",
"description": "Department.",
"enum": [
"retail-operations",
"wholesale-b2b",
"merchandising-buying",
"ecommerce-digital",
"clienteling-crm",
"creative-design",
"research-innovation",
"visual-merchandising-architecture",
"heritage-archives",
"manufacturing-artisanal",
"supply-chain-logistics",
"culinary-food-production",
"food-beverage-service",
"front-office-guest-experience",
"housekeeping-cleaning",
"spa-wellness",
"engineering-facilities",
"real-estate-asset-management",
"corporate-affairs-csr",
"human-resources",
"finance-accounting",
"it-technology",
"medical-clinical",
"legal-compliance",
"executive-management",
"other"
]
},
"locale": {
"type": "string",
"description": "The user's language and region, as a BCP 47 tag: fr-CH for someone writing French in Geneva, say. It sets the language of titles and descriptions, and adds localizedUrl, the listing on that locale's Cerulean site, where the site carries it. It does not filter: country and location do. Cerulean's sites are en: ceruleanjobs.com, English, worldwide; fr-FR: cerulean.fr, French, France; fr-CH: ceruleanjobs.ch, French, Switzerland; de-CH: ceruleanjobs.ch, German, Switzerland; en-CA: ceruleanjobs.ca, English, Canada; fr-CA: ceruleanjobs.ca, French, Canada; de-DE: ceruleanjobs.de, German, Germany; en-GB: ceruleanjobs.co.uk, English, UK; es-ES: cerulean.es, Spanish, Spain; it-IT: ceruleanjobs.it, Italian, Italy. Any other tag takes its language's site, so fr-BE reads as fr-FR and en-US as en; another language reads as en. Defaults to en.",
"pattern": "^([A-Za-z]{2,3}([-_][A-Za-z0-9]{1,8})*)?$"
},
"posted_within_days": {
"type": "integer",
"description": "Only listings posted in the last N days, by when Cerulean first saw them: 1 for today's, 7 for this week's. Up to 365."
},
"limit": {
"type": "integer",
"description": "How many results to return, up to 20. Defaults to 12; more than 20 is served as 20 with a clamped warning."
},
"offset": {
"type": "integer",
"description": "How many results to skip, for the next page. Defaults to 0, maximum 10000."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"results": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The listing's id: what fetch and find_similar_jobs take."
},
"title": {
"type": "string",
"description": "The job title, in the language of locale where the listing has a translation."
},
"url": {
"type": "string",
"description": "The listing on ceruleanjobs.com, where a candidate reads it in full and applies."
},
"text": {
"type": "string",
"description": "The listing's summary, up to 300 characters."
},
"brand": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The brand filter's value for this brand."
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
],
"additionalProperties": false
},
"city": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"datePosted": {
"type": "string",
"description": "When the listing was first seen, RFC 3339."
},
"employmentType": {
"type": "string",
"description": "An employment_type filter value."
},
"seniorityLevel": {
"type": "string",
"description": "A seniority_level filter value."
},
"industry": {
"type": "string",
"description": "An industry filter value."
},
"department": {
"type": "string",
"description": "A department filter value."
},
"localizedUrl": {
"type": "string",
"description": "The listing on the Cerulean site for locale, when that site carries it."
}
},
"required": [
"id",
"title",
"url",
"brand"
],
"additionalProperties": false
}
},
"total": {
"type": "integer",
"description": "How many listings match, across every page.",
"minimum": 0
},
"hasMore": {
"type": "boolean"
},
"offset": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"interpreted": {
"type": [
"null",
"object"
],
"properties": {
"brand": {
"type": "string",
"description": "The brand the sentence named, as the brand filter's slug."
},
"location": {
"type": "string",
"description": "The place the sentence named, applied as the location filter."
},
"country": {
"type": "string",
"description": "A second place the sentence named, a country, applied as the country filter."
},
"employmentType": {
"type": "string",
"description": "The employment type the sentence named, applied as that filter."
},
"query": {
"type": "string",
"description": "The words left to search as text: empty when the sentence named only filters."
}
},
"description": "How the query was read, when it named filters or carried words every search does.",
"required": [
"query"
],
"additionalProperties": false
},
"indexBuiltAt": {
"type": "string",
"description": "When the index was built, RFC 3339: how far results can trail the site."
},
"warnings": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"parameter": {
"type": "string"
},
"message": {
"type": "string"
},
"suggestions": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"description": "What was clamped, not recognised or matched nothing — what tells a typo from an empty shelf."
}
},
"required": [
"results",
"total",
"hasMore",
"offset",
"limit"
],
"additionalProperties": false
}社群
證據