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 markerconvert_size 内
- HIGHTool poisoning patterns detected
- LOWTool 'similar_pieces' description lacks action verbsimilar_pieces 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~9,111トークン数（ツール定義）
~10.1 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 7.12%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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 件