within · luxury boutiques
Live stock at independent luxury boutiques: pieces, sizes, prices and the page to buy each one.
我該用這個嗎
品質與安全性
A
發現項目（3）
- HIGHTool description contains system tag or marker在 convert_size 中
- HIGHTool poisoning patterns detected
- LOWTool 'similar_pieces' description lacks action verb在 similar_pieces 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~9,111Token（工具定義）
~10.1 KB典型回應大小
顯著的注意力影響（128k 上下文的 7.12%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"within": {
"url": "https://shopwithin.co/mcp"
}
}
}遠端端點
https://shopwithin.co/mcpstreamable-http它能做什麼
工具清單
工具（9）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_pieces(query, brands, categories, sizes, boutiques, ...)
Search pieces (clothing, shoes, bags, jewellery, watches, objects) in stock right now at independent luxury boutiques, with live sizes, price in the boutique's currency, the shop that holds each piece, and the shopwithin.co page to buy it. Use this when someone wants to find or compare a kind of piece, a designer's pieces at boutiques, a gift, or what is in stock in a city. A plain sentence works as the query (prices like 'under $400' and 'cheapest' are understood); brands, categories, sizes, boutiques, or city narrow it. With no arguments it returns the current front shelf; lens browses new arrivals, most saved, or marked down. Do not use for general style advice or for mass market retailers.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"description": "What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'.",
"type": "string",
"maxLength": 200
},
"brands": {
"description": "Designer or house names to restrict to, exactly as they appear in results.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 80
}
},
"categories": {
"description": "Product types to restrict to, e.g. 'Sneakers', 'Bags'; take values from a previous result's facets.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"sizes": {
"description": "Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 30
}
},
"boutiques": {
"description": "Boutique domains to restrict to, as shown on boutiques and pieces (e.g. 'wdlt117.myshopify.com').",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 120
}
},
"city": {
"description": "Only boutiques in this city, e.g. 'Toronto'. If within has no boutiques there yet, the answer says so and names the live cities.",
"type": "string",
"maxLength": 60
},
"price_min": {
"description": "Lowest price to include, in the boutique's currency.",
"type": "number",
"minimum": 0
},
"price_max": {
"description": "Highest price to include, in the boutique's currency.",
"type": "number",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"enum": [
"relevance",
"newest",
"price_low_to_high",
"price_high_to_low"
]
},
"lens": {
"description": "Browse a shelf instead of searching: 'new' = just arrived, 'trending' = what people are saving, 'sale' = marked down. Ignored when a query or filters are given.",
"type": "string",
"enum": [
"new",
"trending",
"sale"
]
},
"limit": {
"description": "Pieces per page, default 12.",
"type": "integer",
"minimum": 1,
"maximum": 24
},
"offset": {
"description": "Pieces to skip; use next_offset from the previous page.",
"type": "integer",
"minimum": 0,
"maximum": 480
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
},
"total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"total_is_floor": {
"type": "boolean"
},
"next_offset": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"facets": {
"anyOf": [
{
"type": "object",
"properties": {
"brands": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
},
"boutiques": {
"type": "array",
"items": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"domain",
"name",
"count"
],
"additionalProperties": false
}
}
},
"required": [
"brands",
"categories",
"sizes",
"boutiques"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"related_searches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"query": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"label",
"query",
"count"
],
"additionalProperties": false
}
},
"view_url": {
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"pieces",
"total",
"total_is_floor",
"next_offset",
"facets",
"related_searches",
"view_url",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_piece(url, boutique_domain, id)
One piece in full: description, every size or variant with live stock, photographs, price and any markdown, whether it is collected in the shop or delivered, the boutique, the page to buy it, and a few pieces in the same vein. Use this when a shopper asks about a specific piece from a result, pastes a shopwithin.co link, or wants to know whether a size is in stock before buying. Identify the piece by url, or by boutique_domain and id from a previous result.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"description": "A shopwithin.co piece link, e.g. https://shopwithin.co/product/<boutique>/<id>.",
"type": "string",
"maxLength": 400
},
"boutique_domain": {
"description": "The piece's boutique_domain from a previous result.",
"type": "string",
"maxLength": 120
},
"id": {
"description": "The piece's id from a previous result.",
"type": "string",
"maxLength": 80
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"piece": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"price": {
"type": "number"
},
"compare_at_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"units": {
"type": "number"
}
},
"required": [
"label",
"price",
"compare_at_price",
"in_stock",
"units"
],
"additionalProperties": false
}
},
"collect_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rating": {
"anyOf": [
{
"type": "object",
"properties": {
"average": {
"type": "number"
},
"count": {
"type": "number"
}
},
"required": [
"average",
"count"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"description",
"images",
"tags",
"variants",
"collect_at",
"rating"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"similar": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
}
},
"required": [
"found",
"piece",
"similar"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢trending_now(dept, kind, limit)
within's chart of the designer pieces trending at independent boutiques this week, updated daily: the top ten in order, each with its reason (Google searches, Pinterest searches, what boutiques worldwide are stocking, what people look at on within), its place last week and its weeks on the list, plus the designers of the week. Use this when someone asks what is trending in designer or luxury fashion right now, which designers or pieces are hot this week, or what is trending in a kind of piece (sneakers, bags, jackets, boots, jewelry…). dept narrows to women or men; kind to one kind of piece. Each piece has a url to buy it. Do not use for mass market retailers or for last year's trends.
輸入結構描述
{
"type": "object",
"properties": {
"dept": {
"description": "The women's or the men's chart; leave out for everyone's.",
"type": "string",
"enum": [
"women",
"men"
]
},
"kind": {
"description": "One kind of piece, e.g. 'sneakers', 'bags', 'jackets', 'boots', 'jewelry', 'dresses'.",
"type": "string",
"enum": [
"sneakers",
"boots",
"loafers",
"sandals",
"heels",
"jackets",
"hoodies",
"knitwear",
"t-shirts",
"shirts",
"pants",
"jeans",
"shorts",
"dresses",
"skirts",
"suits",
"activewear",
"bags",
"jewelry",
"watches",
"eyewear",
"hats",
"scarves",
"wallets",
"belts"
]
},
"limit": {
"description": "How many places to return, up to ten, default 10.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"week": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"place": {
"type": "number"
},
"title": {
"type": "string"
},
"designer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"url": {
"type": "string"
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_week": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"weeks_on_list": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"move": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"place",
"title",
"designer",
"price",
"currency",
"url",
"image",
"reason",
"last_week",
"weeks_on_list",
"move"
],
"additionalProperties": false
}
},
"designers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"move": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"name",
"reason",
"move",
"url"
],
"additionalProperties": false
}
},
"kinds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"url"
],
"additionalProperties": false
}
},
"past_weeks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"week": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"week",
"url"
],
"additionalProperties": false
}
},
"json": {
"type": "string"
}
},
"required": [
"title",
"url",
"week",
"as_of",
"items",
"designers",
"kinds",
"past_weeks",
"json"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢similar_pieces(url, boutique_domain, id, limit)
Pieces in the same vein as one piece: same spirit, same department, across every boutique, in stock now. Use this when a shopper likes a piece but wants alternatives, another price, or another shop. Identify the anchor piece by url, or by boutique_domain and id.
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"description": "A shopwithin.co piece link.",
"type": "string",
"maxLength": 400
},
"boutique_domain": {
"type": "string",
"maxLength": 120
},
"id": {
"type": "string",
"maxLength": 80
},
"limit": {
"description": "Default 8.",
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"anchor": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
}
},
"required": [
"anchor",
"pieces"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_boutiques(city)
The independent luxury boutiques listed on within, with neighbourhood, city, how many pieces each has live, opening hours, and whether a shopper collects in the shop or can have pieces delivered. Use this when someone asks which shops are on within, what is in a city or neighbourhood, or where to visit in person. The returned domain identifies a boutique everywhere else.
輸入結構描述
{
"type": "object",
"properties": {
"city": {
"description": "Only boutiques in this city, e.g. 'Toronto'.",
"type": "string",
"maxLength": 60
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"boutiques": {
"type": "array",
"items": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pieces_live": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"hours": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"collect_in_store": {
"type": "boolean"
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"collect_ready_in_minutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"pieces_live",
"currency",
"hours",
"collect_in_store",
"delivery",
"collect_ready_in_minutes",
"url"
],
"additionalProperties": false
}
},
"cities": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"boutiques",
"cities"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢boutique_shelf(boutique_domain, query, limit, offset)
One boutique's shelf right now, newest first, with sizes and prices; a query searches inside that shop only. Use this when a shopper names a specific boutique ('what does WDLT117 have', 'show me Utopia's sneakers') or wants to browse a shop they read about. boutique_domain is the domain shown on any boutique or piece.
輸入結構描述
{
"type": "object",
"properties": {
"boutique_domain": {
"type": "string",
"maxLength": 120,
"description": "The boutique's domain, as shown on boutiques and pieces (e.g. 'utopia-kicks.myshopify.com')."
},
"query": {
"description": "Search inside this boutique only.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Default 12.",
"type": "integer",
"minimum": 1,
"maximum": 24
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 480
}
},
"required": [
"boutique_domain"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"boutique": {
"anyOf": [
{
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pieces_live": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"hours": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"collect_in_store": {
"type": "boolean"
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"collect_ready_in_minutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"pieces_live",
"currency",
"hours",
"collect_in_store",
"delivery",
"collect_ready_in_minutes",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at"
],
"additionalProperties": false
}
},
"next_offset": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"view_url": {
"type": "string"
}
},
"required": [
"boutique",
"pieces",
"next_offset",
"view_url"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢visual_search(image_url, image_base64, media_type, post_url, image_file)
Pieces on the boutiques' shelves that resemble a photograph: a screenshot, a street style shot, a product photo, or a TikTok or Pinterest link. Answers in two tiers: pieces close enough to be the same or a near twin, and pieces in the same spirit. Use this when a shopper shares an image of something they want to find or 'something like this'. Pass image_url for a direct image, image_base64 with media_type for an uploaded file, or post_url for a TikTok or Pinterest link. Photographs are matched in memory and never stored. Do not use for Instagram links; they cannot be read, so ask for a screenshot instead.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"description": "A direct, publicly reachable JPEG, PNG or WebP URL (under 1.5 MB).",
"type": "string",
"maxLength": 2000
},
"image_base64": {
"description": "The image bytes, base64 encoded (under 1.5 MB decoded).",
"type": "string",
"maxLength": 2000000
},
"media_type": {
"description": "Required with image_base64.",
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"image/webp"
]
},
"post_url": {
"description": "A TikTok or Pinterest post link; the photograph is read from the post.",
"type": "string",
"maxLength": 500
},
"image_file": {
"description": "A photograph the shopper uploaded in the chat; the host passes the file here.",
"type": "object",
"properties": {
"file_id": {
"type": "string"
},
"download_url": {
"type": "string",
"maxLength": 4000
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"close": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"type": "number"
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"score"
],
"additionalProperties": false
}
},
"in_spirit": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"boutique_domain": {
"type": "string"
},
"title": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"additionalProperties": false
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"price_drop": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "number"
},
"at": {
"type": "string"
}
},
"required": [
"from",
"at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string",
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
]
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"type": "number"
}
},
"required": [
"id",
"boutique_domain",
"title",
"brand",
"category",
"price",
"price_max",
"currency",
"price_label",
"sizes_in_stock",
"units_in_stock",
"boutique",
"collect_in_store",
"delivery",
"image",
"url",
"price_drop",
"condition",
"stock_checked_at",
"score"
],
"additionalProperties": false
}
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"close",
"in_spirit",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢convert_size(kind, designer, from, size, to, ...)
Turn a size in one system into every other system: rings, shoes, clothing, suits, belts and hats, or one designer's own chart (pass designer as its slug, e.g. 'nike'). Answers only from the size tables on shopwithin.co/sizes, where every row comes from a named source with the day it was read, and returns the page that shows the answer. Use this when a shopper asks what their size is in another country's system, which size to take in a designer, or how a designer's sizes run. Call it without from and size to list the systems and tables a kind or a designer has.
輸入結構描述
{
"type": "object",
"properties": {
"kind": {
"description": "What is being sized: rings, shoes, clothing, suits, belts or hats.",
"type": "string",
"enum": [
"rings",
"shoes",
"clothing",
"suits",
"belts",
"hats"
]
},
"designer": {
"description": "A designer's slug, as in shopwithin.co/designers/<slug>, to read that designer's own charts instead of a kind.",
"type": "string",
"maxLength": 80
},
"from": {
"description": "The system the size is written in, as a key this tool lists, e.g. 'us', 'uk', 'eu'.",
"type": "string",
"maxLength": 48
},
"size": {
"description": "The size as printed, e.g. '7', 'N 1/2', '42', 'M'.",
"type": "string",
"maxLength": 24
},
"to": {
"description": "Optional: one system key to lead the answer with.",
"type": "string",
"maxLength": 48
},
"department": {
"description": "Optional: only women's or men's tables.",
"type": "string",
"enum": [
"women",
"men"
]
},
"table": {
"description": "Optional: one table or chart id this tool lists.",
"type": "string",
"maxLength": 48
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"scope": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"designer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"kind",
"designer",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"systems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
}
},
"tables": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"title",
"department"
],
"additionalProperties": false
}
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"table_id": {
"type": "string"
},
"table_title": {
"type": "string"
},
"match": {
"type": "string"
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"system": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"system",
"label",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"table_id",
"table_title",
"match",
"sizes"
],
"additionalProperties": false
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
},
"read_on": {
"type": "string"
}
},
"required": [
"publisher",
"url",
"read_on"
],
"additionalProperties": false
}
},
"page_url": {
"type": "string"
},
"size_page_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"designers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"status",
"scope",
"systems",
"tables",
"matches",
"sources",
"page_url",
"note",
"kinds",
"designers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢estimate_duty(to, price, currency, kind, department, ...)
Work out what a piece of clothing, a pair of shoes, a bag, jewellery, a watch or an accessory costs at the door when it is shipped to the US, Canada, the UK or Australia: the duty, any extra tariff on the country it was made in, the tax, the government and carrier fees, and the total. Every line names its official source and the day it was read, and the answer links the page on shopwithin.co/duty-calculator that shows it. Use this when a shopper asks about customs, duty, tariffs or import tax on a cross-border order. It is an estimate; the carrier's bill is the final word.
輸入結構描述
{
"type": "object",
"properties": {
"to": {
"type": "string",
"enum": [
"us",
"canada",
"uk",
"australia"
],
"description": "Where the piece is shipped to."
},
"price": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "The price, without shipping."
},
"currency": {
"type": "string",
"enum": [
"CAD",
"USD",
"GBP",
"EUR",
"AUD"
],
"description": "The currency of the price."
},
"kind": {
"type": "string",
"maxLength": 40,
"description": "What the piece is, one of: coat-wool, coat-cotton, coat-polyester, puffer-down, jacket-wool, jacket-cotton, jacket-polyester, jacket-leather, blazer-wool, blazer-cotton, blazer-polyester, trousers-wool, trousers-cotton, trousers-polyester, dress-wool, dress-cotton, dress-silk, dress-polyester, skirt-wool, skirt-cotton, skirt-polyester, shirt-cotton, shirt-silk, shirt-polyester, tshirt-cotton, tshirt-polyester, sweater-cashmere, sweater-wool, sweater-cotton, sweater-polyester, shoes-leather, sneakers-leather, boots-leather, sneakers-textile, bag-leather, bag-textile, wallet-leather, jewellery-gold, jewellery-silver, jewellery-costume, watch-automatic, watch-gold, belt-leather, scarf-silk, scarf-wool, tie-silk, sunglasses."
},
"department": {
"description": "Women's or men's; some duty rates differ.",
"type": "string",
"enum": [
"women",
"men"
]
},
"made_in": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two letter country code of where it was made, e.g. IT, FR, CA, US, JP."
},
"ships_from": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two letter country code of where it ships from."
},
"ship_by": {
"description": "us: fedex, courier or post. canada: fedex, courier or post. uk: royalmail, parcelforce or courier. australia: courier or post.",
"type": "string",
"maxLength": 20
},
"region": {
"description": "Canada only: the province code, e.g. ON, QC, BC.",
"type": "string",
"maxLength": 3
},
"shipping": {
"description": "Optional shipping cost, in the price's currency.",
"type": "number",
"minimum": 0,
"maximum": 100000
},
"weight_kg": {
"description": "Optional weight; a few US lines add a charge per kilogram.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"usmca": {
"description": "US only: true if a piece made in Canada or Mexico qualifies under USMCA.",
"type": "boolean"
}
},
"required": [
"to",
"price",
"currency",
"kind",
"made_in",
"ships_from"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"to": {
"type": "string"
},
"currency": {
"type": "string"
},
"status": {
"type": "string"
},
"value": {
"type": "number"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"detail": {
"type": "string"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sources": {
"type": "array",
"items": {}
}
},
"required": [
"label",
"amount"
],
"additionalProperties": false
}
},
"owed_before_delivery": {},
"tax_at_checkout": {},
"total": {},
"what_changes_it": {},
"notes": {},
"exchange_rate_date": {},
"estimate_note": {
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"page": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本9 個工具