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.

Functions
12
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Shein

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/shein
Every site

One MCP server for Shein and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 12
  • getPointsReturns the signed-in caller's SHEIN points balance and how much it is worth at checkout.

    Arguments

    None.

    Returns sheinPoints

    interface sheinPoints {
      points: number | null;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/shein/getPoints

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.shein.getPoints();
  • getProductReturns product details: title, description, sizes, colors, price, reviews and availability.

    Arguments

    NameTypeRequired
    productIdstringYes

    Returns sheinProductDetail

    interface 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/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    productIdstringYes

    Returns sheinSizeGuide

    interface 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/getSizeGuide

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    productIdstringYes

    Returns sheinStore

    interface 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/getStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listFlashSale

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listMyCoupons

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listNewArrivals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.shein.listOrders();
  • listProductsByCategoryLists products in a category with pagination.

    Arguments

    NameTypeRequired
    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/listProductsByCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/listStoreProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.shein.listStoreProducts({ storeCode: "7465985101" });

Use it from code