within · luxury boutiques
Live stock at independent luxury boutiques: pieces, sizes, prices and the page to buy each one.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (3)
- HIGHTool description contains system tag or markeren convert_size
- HIGHTool poisoning patterns detected
- LOWTool 'similar_pieces' description lacks action verben similar_pieces
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~9,111Tokens (definiciones de herramientas)
~10.1 KBTamaño de respuesta típico
Impacto significativo en la atención (7.12% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"within": {
"url": "https://shopwithin.co/mcp"
}
}
}Puntos de conexión remotos
https://shopwithin.co/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada9 herramientas