Shein MCP server for AI agents
Let Claude, ChatGPT or your own agent read Shein: 12 typed functions through one MCP server. No Shein API key needed.
- Site
- shein.com
- Functions
- 12
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Shein 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/sheinOne MCP server for Shein 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 that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getPointsReturns the signed-in caller's SHEIN points balance and how much it is worth at checkout.Arguments
None.
Returns
sheinPointsinterface sheinPoints { points: number | null; text: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/getPointsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.getPoints();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.getPoints())curl -X POST https://api.bowmark.ai/v1/sites/shein/getPoints \ -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.shein.getPoints();getProductReturns product details: title, description, sizes, colors, price, reviews and availability.Arguments
Name Type Required productIdstringYes Returns
sheinProductDetailinterface sheinProductVariant { sku: string; name: string; size: string | null; price: string | null; currency: string | null; inStock: boolean; } interface sheinProductDetail { id: string; title: string; description: string; brand: string | null; color: string | null; productGroupId: string | null; images: string[]; price: string | null; currency: string | null; inStock: boolean; variants: sheinProductVariant[]; breadcrumbs: { name: string; url: string }[]; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.getProduct({ productId: "<productId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.getProduct({"productId": "<productId>"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productId":"<productId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.getProduct({ productId: "<productId>" });getSizeGuideReturns a product's size chart: the measurement columns (bust, waist, hip, length) and each size's values in cm, read off the product page's own…Arguments
Name Type Required productIdstringYes Returns
sheinSizeGuideinterface sheinSizeRow { size: string; measurements: Record<string, string>; } interface sheinSizeGuide { productId: string; dimensions: string[]; sizes: sheinSizeRow[]; sizeGuideUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/getSizeGuideCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.getSizeGuide({ productId: "<productId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.getSizeGuide({"productId": "<productId>"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/getSizeGuide \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productId":"<productId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.getSizeGuide({ productId: "<productId>" });getStoreReturns the marketplace store that sells a product: store code, name, logo, description and product count, read off the product page's own state.Arguments
Name Type Required productIdstringYes Returns
sheinStoreinterface sheinStore { storeCode: string; name: string; logoUrl: string | null; description: string | null; productCount: string | null; storeUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/getStoreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.getStore({ productId: "<productId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.getStore({"productId": "<productId>"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/getStore \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productId":"<productId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.getStore({ productId: "<productId>" });listCategoriesLists the top-level product categories on Shein.Arguments
None.
Returns
sheinCategory[]interface sheinCategory { id: string; name: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/shein/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.shein.listCategories();listFlashSaleLists the products on Shein's Sale tab (its discounted grid; the site has no separate Flash Sale page).Arguments
None.
Returns
sheinProduct[]interface sheinProduct { id: string; title: string; price: string; imageUrl: string; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listFlashSaleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listFlashSale();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listFlashSale())curl -X POST https://api.bowmark.ai/v1/sites/shein/listFlashSale \ -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.shein.listFlashSale();listMyCouponsLists the coupons on the signed-in caller's account, with the discount, minimum spend and expiry.Arguments
None.
Returns
sheinCoupon[]interface sheinCoupon { text: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listMyCouponsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listMyCoupons();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listMyCoupons())curl -X POST https://api.bowmark.ai/v1/sites/shein/listMyCoupons \ -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.shein.listMyCoupons();listNewArrivalsLists Shein's New In products (the /recommend/New-In-sc-<id>.html selection).Arguments
None.
Returns
sheinProduct[]interface sheinProduct { id: string; title: string; price: string; imageUrl: string; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listNewArrivalsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listNewArrivals();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listNewArrivals())curl -X POST https://api.bowmark.ai/v1/sites/shein/listNewArrivals \ -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.shein.listNewArrivals();listOrdersLists the signed-in caller's orders with status (processing, shipped, delivered), date and total.Arguments
None.
Returns
sheinOrder[]interface sheinOrder { orderId: string; status: string | null; // the site's own labels, read the values off a result, never guess one from prose text: string; orderUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/shein/listOrders \ -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.shein.listOrders();listProductsByCategoryLists products in a category with pagination.Arguments
Name Type Required categoryIdstringYes Returns
sheinProduct[]interface sheinProduct { id: string; title: string; price: string; imageUrl: string; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listProductsByCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listProductsByCategory({ categoryId: "2030" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listProductsByCategory({"categoryId": "2030"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/listProductsByCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":"2030"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.listProductsByCategory({ categoryId: "2030" });listStoreProductsLists the first page of products a marketplace store sells, from the store's own home page.Arguments
Name Type Required storeCodestringYes Returns
sheinProduct[]interface sheinProduct { id: string; title: string; price: string; imageUrl: string; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/listStoreProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.listStoreProducts({ storeCode: "7465985101" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.listStoreProducts({"storeCode": "7465985101"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/listStoreProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"storeCode":"7465985101"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.listStoreProducts({ storeCode: "7465985101" });searchSearches products by keyword and returns results with price, images and availability.Arguments
Name Type Required querystringYes Returns
sheinProduct[]interface sheinProduct { id: string; title: string; price: string; imageUrl: string; productUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/shein/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.shein.search({ query: "dress" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.shein.search({"query": "dress"}))curl -X POST https://api.bowmark.ai/v1/sites/shein/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"dress"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.shein.search({ query: "dress" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/shein/<function> - OpenAPI
/v1/sites/shein/openapi.json