Alibaba.com MCP server for AI agents

Let Claude, ChatGPT or your own agent read Alibaba.com: 13 typed functions through one MCP server. No Alibaba.com API key needed.

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

Connect

Just Alibaba.com

An MCP server for Alibaba.com 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/alibaba
Every site

One MCP server for Alibaba.com 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 13
  • getOrderGet details for a specific order including tracking, payment status and items.

    Arguments

    NameTypeRequired
    orderIdstringYes

    Returns alibabaAccountPage

    interface alibabaAccountPage {
      url: string;           // where the page finally answered
      title: string | null;
      html: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getOrder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getOrder({ orderId: "283746501234" });
  • getProductGet detailed information for a single product by ID, including specs, images, pricing and availability.

    Arguments

    NameTypeRequired
    idOrUrlstring | numberYes

    Returns alibabaProductRow

    interface alibabaProductRow {
      id: number;
      title: string;
      price: string;
      moq: number;
      images: string[];
      supplierName: string;
      supplierId: number;
      supplierProfileUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getProduct(1601361058042);
  • getProductReviewsOne page of a product's buyer reviews.

    Arguments

    NameTypeRequired
    productstring | number | alibabaProductReviewsArgsYes
    interface alibabaProductReviewsArgs {
      product: string | number;          // id or product-detail URL
      supplierId?: string | number;      // getProduct().supplierId, skips one page load
      page?: number;                     // default 1
      pageSize?: number;                 // 1-20, default 10
    }

    Returns alibabaProductReviews

    interface alibabaProductReview {
      id: string;
      rating: number | null;    // 1-5 stars for product quality
      text: string;
      date: string | null;      // YYYY-MM-DD
      reviewer: string | null;  // masked by the site, e.g. "D***n"
      country: string | null;   // two-letter code
      verifiedPurchase: boolean;
      helpfulCount: number;
      variant: Record<string, string> | null; // what the reviewer bought, e.g. { color: "Black" }
    }
    
    interface alibabaProductReviews {
      productId: string;
      totalCount: number;       // the site's count across pages; can exceed the rows served
      page: number;
      reviews: alibabaProductReview[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getProductReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getProductReviews(11000031480547);
  • getProfileGet the current user's account profile with name, email, company and address.

    Arguments

    None.

    Returns alibabaAccountPage

    interface alibabaAccountPage {
      url: string;           // where the page finally answered
      title: string | null;
      html: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getProfile();
  • getSuggestionsGet search suggestions and autocomplete hints based on partial keyword.

    Arguments

    NameTypeRequired
    keywordstringYes

    Returns alibabaSuggestionRow[]

    interface alibabaSuggestionRow {
      keywords: string;
      fromHistory: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getSuggestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getSuggestions("led light");
  • getSupplierGet supplier profile page with company info, ratings, verification status and contact details.

    Arguments

    NameTypeRequired
    profileUrlstringYes

    Returns alibabaSupplierProfileRow

    interface alibabaSupplierProfileRow {
      id: string;
      name: string;
      country: string | null;
      verified: boolean;
      rating: number | null;
      maxRating: number | null;
      yearsOnPlatform: string | null;
      staffCount: number | null;
      address: string | null;
      logoUrl: string | null;
      identityType: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/getSupplier

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.getSupplier("<profileUrl>");
  • listCategoriesList the marketplace's top-level product categories.

    Arguments

    None.

    Returns alibabaCategoryRow[]

    interface alibabaCategoryRow {
      id: string;
      title: string;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listCategories();
  • listMessagesGet inbox of messages from suppliers and other contacts.

    Arguments

    None.

    Returns alibabaAccountPage

    interface alibabaAccountPage {
      url: string;           // where the page finally answered
      title: string | null;
      html: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listMessages();
  • listOrdersGet list of past orders with status, date and items.

    Arguments

    None.

    Returns alibabaAccountPage

    interface alibabaAccountPage {
      url: string;           // where the page finally answered
      title: string | null;
      html: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listOrders();
  • listSavedItemsGet list of saved/favorited products.

    Arguments

    None.

    Returns alibabaAccountPage

    interface alibabaAccountPage {
      url: string;           // where the page finally answered
      title: string | null;
      html: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listSavedItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listSavedItems();
  • listSupplierProductsLists the other products a supplier's storefront carries, so a buyer vetting a company via getSupplier can see what else it makes.

    Arguments

    NameTypeRequired
    profileUrlstringYes

    Returns alibabaSupplierProductRow[]

    interface alibabaSupplierProductRow {
      id: string;
      title: string;
      price: string;
      moq: string | null;
      imageUrl: string | null;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listSupplierProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listSupplierProducts("<profileUrl>");
  • listSuppliersSearch for suppliers by company name or product type.

    Arguments

    NameTypeRequired
    args{ query: string }Yes

    Returns alibabaSupplierRow[]

    interface alibabaSupplierRow {
      id: string;
      name: string;
      country: string | null;
      rating: number | null;
      yearsOnPlatform: string | null;
      profileUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/listSuppliers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.listSuppliers({ query: "led light" });
  • searchProductsSearch for products by keyword, returning results with title, price, supplier and details.

    Arguments

    NameTypeRequired
    args{ query: string, language?: string, country?: string, priceMin?: number, priceMax?: number, page?: number }Yes

    Returns alibabaSearchRow[]

    interface alibabaSearchRow {
      id: number;
      title: string;
      price: string;
      supplierName: string;
      supplierId: number;
      mainImage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/alibaba/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.alibaba.searchProducts({ query: "led light" });

Use it from code