Uniqlo MCP server for AI agents
Let Claude, ChatGPT or your own agent read Uniqlo: 2 typed functions through one MCP server. No Uniqlo API key needed.
- Site
- uniqlo.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Uniqlo
An MCP server for Uniqlo 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/uniqloEvery site
One MCP server for Uniqlo 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.
Read 2
getProductReads one Uniqlo product's every color × size with its price, live stock status and unit count, per-color in-stock and sold-out size lists, photos…Arguments
Name Type Required productstring | { productId: string; priceGroup?: string; market?: "com" | "ca"; country?: "us" | "ca" } | UniqloSearchHitYes interface UniqloColorRef { code: string; // color display code, e.g. "69" name: string | null; // "NAVY" image: string | null; // this color's product photo } interface UniqloSearchHit { productId: string; // pass with priceGroup to getProduct (or pass the hit itself) priceGroup: string; // "00" full price, "01"/"02" a reduced price for select colors/sizes country: "us" | "ca"; // the store this hit came from; getProduct(hit) reads the same store url: string; name: string; gender: string | null; // "MEN" | "WOMEN" | "UNISEX" | … price: number | null; // what it costs now regularPrice: number | null; // the original, ONLY when the site publishes one, usually null on a Sale item onSale: boolean; // the site marks it Sale currency: string | null; // "USD" | "CAD" rating: number | null; reviewCount: number | null; colors: UniqloColorRef[]; sizes: string[]; image: string | null; }Returns
UniqloProductinterface UniqloSku { l2Id: string; color: string | null; colorCode: string | null; size: string | null; // "M", "L", "3XL", … sizeCode: string | null; url: string; // opens this color AND size price: number | null; regularPrice: number | null; // original, when published; else null onSale: boolean; inStock: boolean; // IN_STOCK or LOW_STOCK lowStock: boolean; quantity: number | null; // units the site reports status: string | null; // "IN_STOCK" | "LOW_STOCK" | "STOCK_OUT" } interface UniqloColor { code: string; name: string | null; url: string; // opens this color image: string | null; // main photo images: string[]; // main photo first, then this color's other views inStock: boolean; sizesInStock: string[]; sizesOutOfStock: string[]; } interface UniqloProduct { productId: string; priceGroup: string; country: "us" | "ca"; url: string; name: string; gender: string | null; price: number | null; regularPrice: number | null; // original, when published; else null onSale: boolean; currency: string | null; // "USD" | "CAD" rating: number | null; reviewCount: number | null; composition: string | null; // "100% Cotton\nImported" sizes: string[]; colors: UniqloColor[]; skus: UniqloSku[]; inStock: boolean; warnings: string[]; // the full-price lookup for a reduced price group failed; empty otherwise }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/uniqlo/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.uniqlo.getProduct({ productId: "E450260-000", market: "com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.uniqlo.getProduct({"productId": "E450260-000", "market": "com"}))curl -X POST https://api.bowmark.ai/v1/sites/uniqlo/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"product":{"productId":"E450260-000","market":"com"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.uniqlo.getProduct({ productId: "E450260-000", market: "com" });searchProductsSearches Uniqlo's live clothing catalog, the US store (uniqlo.com/us, USD) by default or the Canadian one (uniqlo.com/ca, CAD) with country: "ca", by…Arguments
Name Type Required argsUniqloSearchArgs | stringYes interface UniqloSearchArgs { query?: string; // a query, a department, or both department?: "men" | "women" | "kids" | "baby"; // department alone lists the whole department onSaleOnly?: boolean; // the site's own Sale filter limit?: number; // default 24, max 1000; the search walks result pages until it has this many market?: "com" | "ca"; // which storefront: "com" (US, default) or "ca" (Canada, CAD prices and Canadian stock) country?: "us" | "ca"; // compatibility alias for market: "us" or "ca" }Returns
UniqloSearchResultinterface UniqloColorRef { code: string; // color display code, e.g. "69" name: string | null; // "NAVY" image: string | null; // this color's product photo } interface UniqloSearchHit { productId: string; // pass with priceGroup to getProduct (or pass the hit itself) priceGroup: string; // "00" full price, "01"/"02" a reduced price for select colors/sizes country: "us" | "ca"; // the store this hit came from; getProduct(hit) reads the same store url: string; name: string; gender: string | null; // "MEN" | "WOMEN" | "UNISEX" | … price: number | null; // what it costs now regularPrice: number | null; // the original, ONLY when the site publishes one, usually null on a Sale item onSale: boolean; // the site marks it Sale currency: string | null; // "USD" | "CAD" rating: number | null; reviewCount: number | null; colors: UniqloColorRef[]; sizes: string[]; image: string | null; } interface UniqloSearchResult { query: string | null; department: "men" | "women" | "kids" | "baby" | null; onSaleOnly: boolean; country: "us" | "ca"; total: number; // products the site matched hasMore: boolean; // true when more matching products exist past `limit` hits: UniqloSearchHit[]; warnings: string[]; // a results page that failed after the first; empty when complete }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/uniqlo/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.uniqlo.searchProducts({ query: "shirt", department: "men", market: "com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.uniqlo.searchProducts({"query": "shirt", "department": "men", "market": "com"}))curl -X POST https://api.bowmark.ai/v1/sites/uniqlo/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"shirt","department":"men","market":"com"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.uniqlo.searchProducts({ query: "shirt", department: "men", market: "com" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/uniqlo/<function> - OpenAPI
/v1/sites/uniqlo/openapi.json