Cursor
Grok Bot
Grok
MuseTitle97/100
Search clothes, shoes and bags in stock
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Search what is in stock right now at independent luxury boutiques: clothes, shoes, bags, jewellery, watches and home objects, new and pre-owned. Each result has the price in the boutique's currency, the sizes in stock, the shop that has it and the shopwithin.co page to buy it. Use this when someone wants to find or shop for an item, a designer's items, something in their size or under a price, or what is in stock in a city. A plain sentence works as the query (prices like 'under $400' and 'cheapest' are understood); designers, categories, sizes, women's or men's, boutiques, city and price narrow it. With no arguments it returns the front of the shop; lens browses new arrivals, most saved, or marked down. It reads only the boutiques on within, not mass market stores, and gives no style advice.
The description explains the capability, when to use it, and what to expect.
Inputs85/100
12 of 13 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
query
What the shopper wants, in plain words: 'black leather loafers', 'Lemaire', 'a birthday gift for my dad under $300'.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
brands
Designer or house names to restrict to, exactly as they appear in results.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
categories
Product types to restrict to, e.g. 'Sneakers', 'Bags'; take values from a previous result's facets.
Clear enough to supply this argument.
sizes
Sizes that must be in stock, as labelled on the shelf: 'M', '42', 'US 9', 'IT 38'.
Clear enough to supply this argument.
boutiques
Boutique domains to restrict to, as shown on boutiques and pieces (e.g. 'wdlt117.myshopify.com').
Clear enough to supply this argument.
city
The city the boutiques are in, e.g. 'Toronto': a place to shop, not the shopper's own location. If within has no boutiques there yet, the answer says so and names the cities that have them.
Clear enough to supply this argument.
department
Only women's or only men's.
Clear enough to supply this argument.
price_min
Lowest price to include, in the boutique's currency.
Clear enough to supply this argument.
price_max
Highest price to include, in the boutique's currency.
Clear enough to supply this argument.
sort
Not provided
Missing description. Explain what this value means and how to supply it.
lens
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.
Clear enough to supply this argument.
limit
Pieces per page, default 12.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
offset
Pieces to skip; use next_offset from the previous page.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search clothes, shoes and bags in stock",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema66/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pieces",
"total",
"total_is_floor",
"next_offset",
"facets",
"related_searches",
"view_url",
"note"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"facets": {
"anyOf": [
{
"type": "object",
"required": [
"brands",
"categories",
"sizes",
"boutiques"
],
"properties": {
"sizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "number"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"brands": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "number"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
},
"boutiques": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"name",
"count"
],
"properties": {
"name": {
"type": "string"
},
"count": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"count"
],
"properties": {
"count": {
"type": "number"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"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"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"type": "number"
},
"title": {
"type": "string"
},
"boutique": {
"type": "object",
"required": [
"domain",
"name",
"neighbourhood",
"city",
"url"
],
"properties": {
"url": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"domain": {
"type": "string"
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"delivery": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"enum": [
"pre-owned",
"lightly-used",
"worn-once",
"vintage",
"new"
],
"type": "string"
},
{
"type": "null"
}
]
},
"price_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"price_drop": {
"anyOf": [
{
"type": "object",
"required": [
"from",
"at"
],
"properties": {
"at": {
"type": "string"
},
"from": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"price_label": {
"type": "string"
},
"sizes_in_stock": {
"type": "array",
"items": {
"type": "string"
}
},
"units_in_stock": {
"type": "number"
},
"boutique_domain": {
"type": "string"
},
"collect_in_store": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"stock_checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"view_url": {
"type": "string"
},
"next_offset": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"total_is_floor": {
"type": "boolean"
},
"related_searches": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"query",
"count"
],
"properties": {
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"query": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}