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.
- Site
- alibaba.com
- Functions
- 13
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/alibabaOne 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/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.
getOrderGet details for a specific order including tracking, payment status and items.Arguments
Name Type Required orderIdstringYes Returns
alibabaAccountPageinterface alibabaAccountPage { url: string; // where the page finally answered title: string | null; html: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/getOrderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getOrder({ orderId: "283746501234" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getOrder({"orderId": "283746501234"}))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getOrder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"orderId":"283746501234"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.getOrder({ orderId: "283746501234" });getProductGet detailed information for a single product by ID, including specs, images, pricing and availability.Arguments
Name Type Required idOrUrlstring | numberYes Returns
alibabaProductRowinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getProduct(1601361058042);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getProduct(1601361058042))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":1601361058042}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.getProduct(1601361058042);getProductReviewsOne page of a product's buyer reviews.Arguments
Name Type Required 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
alibabaProductReviewsinterface 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/getProductReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getProductReviews(11000031480547);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getProductReviews(11000031480547))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getProductReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product":11000031480547}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.getProductReviews(11000031480547);getProfileGet the current user's account profile with name, email, company and address.Arguments
None.
Returns
alibabaAccountPageinterface alibabaAccountPage { url: string; // where the page finally answered title: string | null; html: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/getProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getProfile())curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getProfile \ -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.alibaba.getProfile();getSuggestionsGet search suggestions and autocomplete hints based on partial keyword.Arguments
Name Type Required keywordstringYes Returns
alibabaSuggestionRow[]interface alibabaSuggestionRow { keywords: string; fromHistory: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/getSuggestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getSuggestions("led light");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getSuggestions("led light"))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getSuggestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"keyword":"led light"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.getSuggestions("led light");getSupplierGet supplier profile page with company info, ratings, verification status and contact details.Arguments
Name Type Required profileUrlstringYes Returns
alibabaSupplierProfileRowinterface 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/getSupplierCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.getSupplier("<profileUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.getSupplier("<profileUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/getSupplier \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"profileUrl":"<profileUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/alibaba/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.alibaba.listCategories();listMessagesGet inbox of messages from suppliers and other contacts.Arguments
None.
Returns
alibabaAccountPageinterface alibabaAccountPage { url: string; // where the page finally answered title: string | null; html: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/listMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listMessages();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listMessages())curl -X POST https://api.bowmark.ai/v1/sites/alibaba/listMessages \ -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.alibaba.listMessages();listOrdersGet list of past orders with status, date and items.Arguments
None.
Returns
alibabaAccountPageinterface alibabaAccountPage { url: string; // where the page finally answered title: string | null; html: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/alibaba/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.alibaba.listOrders();listSavedItemsGet list of saved/favorited products.Arguments
None.
Returns
alibabaAccountPageinterface alibabaAccountPage { url: string; // where the page finally answered title: string | null; html: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/alibaba/listSavedItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listSavedItems();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listSavedItems())curl -X POST https://api.bowmark.ai/v1/sites/alibaba/listSavedItems \ -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.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
Name Type Required 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/listSupplierProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listSupplierProducts("<profileUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listSupplierProducts("<profileUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/listSupplierProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"profileUrl":"<profileUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.listSupplierProducts("<profileUrl>");listSuppliersSearch for suppliers by company name or product type.Arguments
Name Type Required 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/listSuppliersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.listSuppliers({ query: "led light" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.listSuppliers({"query": "led light"}))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/listSuppliers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"led light"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.listSuppliers({ query: "led light" });searchProductsSearch for products by keyword, returning results with title, price, supplier and details.Arguments
Name Type Required 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.alibaba.searchProducts({ query: "led light" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.alibaba.searchProducts({"query": "led light"}))curl -X POST https://api.bowmark.ai/v1/sites/alibaba/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"led light"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.alibaba.searchProducts({ query: "led light" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/alibaba/<function> - OpenAPI
/v1/sites/alibaba/openapi.json