Caudalie MCP server for AI agents
Let Claude, ChatGPT or your own agent read Caudalie: 5 typed functions through one MCP server. No Caudalie API key needed.
- Site
- us.caudalie.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Caudalie alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/caudalieOne MCP server for Caudalie and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getProductOne Caudalie US product as its page shows it: sku, name, description, collection, USD price and stock for the size the link pins (named in size)…Arguments
Name Type Required skustringNo urlstringNo Returns
CaudalieProductinterface CaudalieSize { size: string; name: string; sku: string | null; price: number | null; inStock: boolean | null; url: string | null; } interface CaudalieProduct { sku: string; name: string; description: string | null; collection: string | null; gtin13: string | null; price: number | null; currency: string; inStock: boolean | null; size: string | null; sizes: CaudalieSize[]; rating: number | null; reviewCount: number | null; breadcrumb: string[]; images: string[]; url: string; /** Present only when a size page failed; names the size. */ warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/caudalie/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caudalie.getProduct({ sku: "328" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caudalie.getProduct({"sku": "328"}))curl -X POST https://api.bowmark.ai/v1/sites/caudalie/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sku":"328"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caudalie.getProduct({ sku: "328" });getProductReviewsCustomer reviews of one Caudalie US product: average rating, review count and the newest reviews the page shows (title, text, stars, date, author…Arguments
Name Type Required skustringNo urlstringNo Returns
CaudalieReviewsinterface CaudalieReview { title: string | null; text: string | null; rating: number | null; date: string | null; author: string | null; photos: string[]; } interface CaudalieReviews { sku: string; name: string; averageRating: number | null; reviewCount: number | null; reviews: CaudalieReview[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/caudalie/getProductReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caudalie.getProductReviews({ sku: "328" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caudalie.getProductReviews({"sku": "328"}))curl -X POST https://api.bowmark.ai/v1/sites/caudalie/getProductReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sku":"328"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caudalie.getProductReviews({ sku: "328" });listCategoriesEvery product category on Caudalie's US store (e.g. All Products > Face > Cleansers), with its page link.Arguments
None.
Returns
CaudalieCategory[]interface CaudalieCategory { name: string; path: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/caudalie/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caudalie.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caudalie.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/caudalie/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caudalie.listCategories();listCategoryProductsOne Caudalie US category as its page lists it, in page order, with prices, the size each price is for, and star ratings.Arguments
Name Type Required categorystringYes Returns
CaudalieProductCard[]interface CaudalieProductCard { sku: string; name: string; collection: string | null; size: string | null; price: number | null; priceMax: number | null; currency: "USD"; rating: number | null; reviewCount: number | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/caudalie/listCategoryProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caudalie.listCategoryProducts({ category: "Face > Cleansers" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caudalie.listCategoryProducts({"category": "Face > Cleansers"}))curl -X POST https://api.bowmark.ai/v1/sites/caudalie/listCategoryProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"category":"Face > Cleansers"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caudalie.listCategoryProducts({ category: "Face > Cleansers" });searchProductsSearch Caudalie's US skincare store (us.caudalie.com) by words, e.g. "beauty elixir" or "vitamin c serum": sku, name, collection, USD price, star…Arguments
Name Type Required querystringYes limitnumberNo Returns
CaudalieProductCard[]interface CaudalieProductCard { sku: string; name: string; collection: string | null; size: string | null; price: number | null; priceMax: number | null; currency: "USD"; rating: number | null; reviewCount: number | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/caudalie/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caudalie.searchProducts({ query: "grape water" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caudalie.searchProducts({"query": "grape water"}))curl -X POST https://api.bowmark.ai/v1/sites/caudalie/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"grape water"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caudalie.searchProducts({ query: "grape water" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/caudalie/<function> - OpenAPI
/v1/sites/caudalie/openapi.json