Server definition
- Hash
- sha256:c4c438a517e60d97049d8e7ee559982c105482532e515fdc0c4fe7d9cbe45b8c
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "SkyBuyFly compares the prices of airport duty-free shops (perfume, cosmetics, spirits, wine, sweets, electronics, fashion); get_catalogue_stats tells how many products and airports it covers. It does not sell anything: every link opens the product or deal page on skybuyfly.pitchai.net, which hands off to the shop.\n- Start with search_products (or lookup_barcode for a barcode). Each card shows the product's price at every airport that sells it, cheapest first, and its lowest price, which may be a retailer's online shop serving several airports; pass airports=[IATA codes] to compare specific airports.\n- Prices are per airport shop and are the latest stored observations. When the traveller wants current prices, call get_live_prices with the product_id: it confirms each airport's price on the shop's page now (5-15 s) and marks every offer live-confirmed or stored with its date. If it is rate limited, use get_product for the stored offers.\n- get_price_history shows how prices developed; list_airports and list_currencies give the valid airport codes and currencies; get_featured_products gives inspiration.\n- Every price names its airport shop and whether it is live-confirmed or stored (and when). Tobacco and nicotine products are not available.",
"tools": [
{
"description": "Get the size and freshness of SkyBuyFly's price comparison catalogue: the number of products, the number of airports and when the figures were generated. Relevant when asked how much SkyBuyFly covers.",
"inputSchema": {
"properties": {},
"title": "get_catalogue_statsArguments",
"type": "object"
},
"name": "get_catalogue_stats",
"outputSchema": {
"additionalProperties": false,
"description": "``get_catalogue_stats``.",
"properties": {
"airports": {
"title": "Airports",
"type": "integer"
},
"generated_at": {
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"total_products": {
"title": "Total Products",
"type": "integer"
}
},
"required": [
"total_products",
"airports",
"generated_at"
],
"title": "StatsResult",
"type": "object"
}
},
{
"description": "Get SkyBuyFly's featured airport duty-free products with their airport prices, and the most popular catalogue categories. Not personalised. Relevant when a traveller wants inspiration or asks what is popular at duty free.",
"inputSchema": {
"properties": {
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
}
},
"title": "get_featured_productsArguments",
"type": "object"
},
"name": "get_featured_products",
"outputSchema": {
"$defs": {
"AirportPrice": {
"additionalProperties": false,
"description": "A product's price at one airport, in the requested currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"code",
"name",
"price"
],
"title": "AirportPrice",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
},
"PopularCategory": {
"additionalProperties": false,
"description": "A catalogue category and its product count.",
"properties": {
"count": {
"title": "Count",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
}
},
"required": [
"name",
"count"
],
"title": "PopularCategory",
"type": "object"
},
"ProductCard": {
"additionalProperties": false,
"description": "One product with its price at every airport that sells it (cheapest first).\n\n``lowest_price``/``highest_price`` span every comparable shop price, online shops included\n(``lowest_price_scope`` says where the lowest is); ``airports`` lists airport prices only. ``offer_count`` is the\nnumber of shop offers the API knows for the product (null where the answer does not say). ``size`` is the API's\nown measure (\"100 ml\"; null where the answer carries none).",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url"
],
"title": "ProductCard",
"type": "object"
}
},
"additionalProperties": false,
"description": "``get_featured_products``.",
"properties": {
"currency": {
"title": "Currency",
"type": "string"
},
"notice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Notice"
},
"popular_categories": {
"items": {
"$ref": "#/$defs/PopularCategory"
},
"title": "Popular Categories",
"type": "array"
},
"products": {
"items": {
"$ref": "#/$defs/ProductCard"
},
"title": "Products",
"type": "array"
},
"view": {
"const": "product_list",
"default": "product_list",
"title": "View",
"type": "string"
}
},
"required": [
"currency",
"products",
"popular_categories",
"notice"
],
"title": "FeaturedResult",
"type": "object"
}
},
{
"description": "Check a product's prices live at every airport shop that sells it: SkyBuyFly opens each shop's page now and confirms the current price. Every offer comes back marked live_confirmed (checked just now) or stored (the last observed price, with its date), cheapest first. Takes about 5-15 seconds. Relevant when a traveller wants current prices or is deciding where to buy. A check of the same product within a minute returns the same result; when SkyBuyFly's price service is busy the answer is rate_limited and lists no offers.",
"inputSchema": {
"properties": {
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
},
"product_id": {
"description": "A SkyBuyFly product_id exactly as search_products, lookup_barcode or get_featured_products answered it: 32 lowercase hex characters or a dashed UUID.",
"pattern": "^(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$",
"title": "Product Id",
"type": "string"
},
"wait_seconds": {
"default": 12,
"description": "Seconds to wait for the airports' shops to answer: a whole number from 5 to 20 (default 12); offers not confirmed by then are returned with their stored price.",
"maximum": 20,
"minimum": 5,
"title": "Wait Seconds",
"type": "integer"
}
},
"required": [
"product_id"
],
"title": "get_live_pricesArguments",
"type": "object"
},
"name": "get_live_prices",
"outputSchema": {
"$defs": {
"AirportPrice": {
"additionalProperties": false,
"description": "A product's price at one airport, in the requested currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"code",
"name",
"price"
],
"title": "AirportPrice",
"type": "object"
},
"LiveSummary": {
"additionalProperties": false,
"description": "How a live check went: offers checked, confirmed, failed, and shown with their stored price only.",
"properties": {
"checked": {
"title": "Checked",
"type": "integer"
},
"failed": {
"title": "Failed",
"type": "integer"
},
"live_confirmed": {
"title": "Live Confirmed",
"type": "integer"
},
"stored_only": {
"title": "Stored Only",
"type": "integer"
}
},
"required": [
"checked",
"live_confirmed",
"failed",
"stored_only"
],
"title": "LiveSummary",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
},
"Offer": {
"additionalProperties": false,
"description": "One shop's offer: at one airport, or a retailer-wide online shop (``scope``), whose airport fields are null.\n\nAn ``online_shop`` offer is a real shop price, never one of a card's ``airports``.",
"properties": {
"airport_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Airport Code"
},
"airport_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Airport Name"
},
"availability": {
"anyOf": [
{
"enum": [
"in_stock",
"sold_out_online"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Availability"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country"
},
"display_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"observed_at": {
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"title": "Observed At",
"type": "string"
},
"price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"retailer": {
"title": "Retailer",
"type": "string"
},
"retailer_domain": {
"title": "Retailer Domain",
"type": "string"
},
"scope": {
"enum": [
"airport",
"online_shop"
],
"title": "Scope",
"type": "string"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"source": {
"enum": [
"live",
"stored"
],
"title": "Source",
"type": "string"
},
"status": {
"enum": [
"live_confirmed",
"stored",
"live_check_failed",
"live_timeout",
"live_blocked"
],
"title": "Status",
"type": "string"
}
},
"required": [
"airport_code",
"airport_name",
"city",
"country",
"scope",
"retailer",
"retailer_domain",
"price",
"display_price",
"availability",
"observed_at",
"source",
"status",
"skybuyfly_url"
],
"title": "Offer",
"type": "object"
},
"ProductCard": {
"additionalProperties": false,
"description": "One product with its price at every airport that sells it (cheapest first).\n\n``lowest_price``/``highest_price`` span every comparable shop price, online shops included\n(``lowest_price_scope`` says where the lowest is); ``airports`` lists airport prices only. ``offer_count`` is the\nnumber of shop offers the API knows for the product (null where the answer does not say). ``size`` is the API's\nown measure (\"100 ml\"; null where the answer carries none).",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url"
],
"title": "ProductCard",
"type": "object"
}
},
"additionalProperties": false,
"description": "``get_live_prices``; ``retry_after_seconds`` is set when rate limited, ``reason`` when unavailable.",
"properties": {
"cheapest": {
"anyOf": [
{
"$ref": "#/$defs/Offer"
},
{
"type": "null"
}
]
},
"checked_at": {
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"title": "Checked At",
"type": "string"
},
"currency": {
"title": "Currency",
"type": "string"
},
"live_status": {
"enum": [
"complete",
"partial",
"rate_limited",
"unavailable",
"no_offers"
],
"title": "Live Status",
"type": "string"
},
"offers": {
"items": {
"$ref": "#/$defs/Offer"
},
"title": "Offers",
"type": "array"
},
"product": {
"$ref": "#/$defs/ProductCard"
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason"
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Retry After Seconds"
},
"summary": {
"$ref": "#/$defs/LiveSummary"
},
"view": {
"const": "live_offers",
"default": "live_offers",
"title": "View",
"type": "string"
}
},
"required": [
"product",
"currency",
"checked_at",
"live_status",
"retry_after_seconds",
"reason",
"offers",
"summary",
"cheapest"
],
"title": "LiveResult",
"type": "object"
}
},
{
"description": "Get a product's observed prices per airport over time: SkyBuyFly's 50 most recent observations (the answer says which dates they cover), as each airport's price changes, with the lowest and latest price. Relevant when a traveller asks whether a price is good, has changed or how it developed. It does not check current prices.",
"inputSchema": {
"properties": {
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
},
"product_id": {
"description": "A SkyBuyFly product_id exactly as search_products, lookup_barcode or get_featured_products answered it: 32 lowercase hex characters or a dashed UUID.",
"pattern": "^(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$",
"title": "Product Id",
"type": "string"
}
},
"required": [
"product_id"
],
"title": "get_price_historyArguments",
"type": "object"
},
"name": "get_price_history",
"outputSchema": {
"$defs": {
"AirportHistory": {
"additionalProperties": false,
"description": "A product's observed prices at one airport (``code`` null: an online shop serving several airports).",
"properties": {
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Code"
},
"latest": {
"$ref": "#/$defs/Money"
},
"lowest": {
"$ref": "#/$defs/Money"
},
"name": {
"title": "Name",
"type": "string"
},
"points": {
"items": {
"$ref": "#/$defs/HistoryPoint"
},
"title": "Points",
"type": "array"
}
},
"required": [
"code",
"name",
"points",
"lowest",
"latest"
],
"title": "AirportHistory",
"type": "object"
},
"HistoryPoint": {
"additionalProperties": false,
"description": "One observed price.",
"properties": {
"date": {
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"title": "Date",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"date",
"price"
],
"title": "HistoryPoint",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
}
},
"additionalProperties": false,
"description": "``get_price_history``: the product (for the widget's header) and its recent observations per airport.",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportHistory"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"currency": {
"title": "Currency",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"view": {
"const": "price_history",
"default": "price_history",
"title": "View",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"image_url",
"skybuyfly_url",
"currency",
"airports"
],
"title": "HistoryResult",
"type": "object"
}
},
{
"description": "Get one SkyBuyFly product by its product_id: its description and size, every stored offer per airport shop (the shop's own price, the price in the requested currency, when it was observed, a link to the SkyBuyFly deal page) and similar products. Relevant when a traveller wants every airport and shop for one product. The prices are stored observations; this tool does not check them live.",
"inputSchema": {
"properties": {
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
},
"product_id": {
"description": "A SkyBuyFly product_id exactly as search_products, lookup_barcode or get_featured_products answered it: 32 lowercase hex characters or a dashed UUID.",
"pattern": "^(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$",
"title": "Product Id",
"type": "string"
}
},
"required": [
"product_id"
],
"title": "get_productArguments",
"type": "object"
},
"name": "get_product",
"outputSchema": {
"$defs": {
"AirportPrice": {
"additionalProperties": false,
"description": "A product's price at one airport, in the requested currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"code",
"name",
"price"
],
"title": "AirportPrice",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
},
"Offer": {
"additionalProperties": false,
"description": "One shop's offer: at one airport, or a retailer-wide online shop (``scope``), whose airport fields are null.\n\nAn ``online_shop`` offer is a real shop price, never one of a card's ``airports``.",
"properties": {
"airport_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Airport Code"
},
"airport_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Airport Name"
},
"availability": {
"anyOf": [
{
"enum": [
"in_stock",
"sold_out_online"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Availability"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country"
},
"display_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"observed_at": {
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"title": "Observed At",
"type": "string"
},
"price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"retailer": {
"title": "Retailer",
"type": "string"
},
"retailer_domain": {
"title": "Retailer Domain",
"type": "string"
},
"scope": {
"enum": [
"airport",
"online_shop"
],
"title": "Scope",
"type": "string"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"source": {
"enum": [
"live",
"stored"
],
"title": "Source",
"type": "string"
},
"status": {
"enum": [
"live_confirmed",
"stored",
"live_check_failed",
"live_timeout",
"live_blocked"
],
"title": "Status",
"type": "string"
}
},
"required": [
"airport_code",
"airport_name",
"city",
"country",
"scope",
"retailer",
"retailer_domain",
"price",
"display_price",
"availability",
"observed_at",
"source",
"status",
"skybuyfly_url"
],
"title": "Offer",
"type": "object"
},
"ProductCard": {
"additionalProperties": false,
"description": "One product with its price at every airport that sells it (cheapest first).\n\n``lowest_price``/``highest_price`` span every comparable shop price, online shops included\n(``lowest_price_scope`` says where the lowest is); ``airports`` lists airport prices only. ``offer_count`` is the\nnumber of shop offers the API knows for the product (null where the answer does not say). ``size`` is the API's\nown measure (\"100 ml\"; null where the answer carries none).",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url"
],
"title": "ProductCard",
"type": "object"
},
"ProductDetail": {
"additionalProperties": false,
"description": "A product card with its description.",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url",
"description"
],
"title": "ProductDetail",
"type": "object"
}
},
"additionalProperties": false,
"description": "``get_product``.",
"properties": {
"currency": {
"title": "Currency",
"type": "string"
},
"offers": {
"items": {
"$ref": "#/$defs/Offer"
},
"title": "Offers",
"type": "array"
},
"product": {
"$ref": "#/$defs/ProductDetail"
},
"similar": {
"items": {
"$ref": "#/$defs/ProductCard"
},
"title": "Similar",
"type": "array"
},
"view": {
"const": "product",
"default": "product",
"title": "View",
"type": "string"
}
},
"required": [
"currency",
"product",
"offers",
"similar"
],
"title": "ProductResult",
"type": "object"
}
},
{
"description": "List the airports whose duty-free shops SkyBuyFly compares: IATA code, name, city and the shops' store domains, optionally only those matching a text (code, name or city). Relevant for finding an airport's IATA code or answering which airports are covered.",
"inputSchema": {
"properties": {
"query": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Up to 100 characters: only airports whose IATA code, name or city contains this text, e.g. 'London'.",
"title": "Query"
}
},
"title": "list_airportsArguments",
"type": "object"
},
"name": "list_airports",
"outputSchema": {
"$defs": {
"AirportEntry": {
"additionalProperties": false,
"description": "One airport and the store domains of its shops.",
"properties": {
"city": {
"title": "City",
"type": "string"
},
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"store_domains": {
"items": {
"type": "string"
},
"title": "Store Domains",
"type": "array"
}
},
"required": [
"code",
"name",
"city",
"store_domains"
],
"title": "AirportEntry",
"type": "object"
}
},
"additionalProperties": false,
"description": "``list_airports``.",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportEntry"
},
"title": "Airports",
"type": "array"
},
"total": {
"title": "Total",
"type": "integer"
}
},
"required": [
"airports",
"total"
],
"title": "AirportsResult",
"type": "object"
}
},
{
"description": "List the currencies SkyBuyFly shows prices in (ISO 4217 code, name, symbol). Every price tool takes one of these codes as currency.",
"inputSchema": {
"properties": {},
"title": "list_currenciesArguments",
"type": "object"
},
"name": "list_currencies",
"outputSchema": {
"$defs": {
"CurrencyEntry": {
"additionalProperties": false,
"description": "A display currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"symbol": {
"title": "Symbol",
"type": "string"
}
},
"required": [
"code",
"name",
"symbol"
],
"title": "CurrencyEntry",
"type": "object"
}
},
"additionalProperties": false,
"description": "``list_currencies``.",
"properties": {
"currencies": {
"items": {
"$ref": "#/$defs/CurrencyEntry"
},
"title": "Currencies",
"type": "array"
}
},
"required": [
"currencies"
],
"title": "CurrenciesResult",
"type": "object"
}
},
{
"description": "Find the SkyBuyFly product that carries a barcode (the digits of an EAN-8, UPC-A, EAN-13 or GTIN-14, e.g. read from a box or a photo) with its price at each airport shop that has an offer for that code, and when it was seen. An empty list means no airport shop SkyBuyFly compares sells it. It does not search by name.",
"inputSchema": {
"properties": {
"code": {
"description": "The barcode's 8 to 14 digits (EAN-8, UPC-A, EAN-13 or GTIN-14), e.g. 3145891165203.",
"pattern": "^\\d{8,14}$",
"title": "Code",
"type": "string"
},
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
}
},
"required": [
"code"
],
"title": "lookup_barcodeArguments",
"type": "object"
},
"name": "lookup_barcode",
"outputSchema": {
"$defs": {
"AirportPrice": {
"additionalProperties": false,
"description": "A product's price at one airport, in the requested currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"code",
"name",
"price"
],
"title": "AirportPrice",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
},
"ProductCard": {
"additionalProperties": false,
"description": "One product with its price at every airport that sells it (cheapest first).\n\n``lowest_price``/``highest_price`` span every comparable shop price, online shops included\n(``lowest_price_scope`` says where the lowest is); ``airports`` lists airport prices only. ``offer_count`` is the\nnumber of shop offers the API knows for the product (null where the answer does not say). ``size`` is the API's\nown measure (\"100 ml\"; null where the answer carries none).",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url"
],
"title": "ProductCard",
"type": "object"
}
},
"additionalProperties": false,
"description": "``lookup_barcode`` (an empty list: no catalogue product carries the code).",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"currency": {
"title": "Currency",
"type": "string"
},
"notice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Notice"
},
"products": {
"items": {
"$ref": "#/$defs/ProductCard"
},
"title": "Products",
"type": "array"
},
"view": {
"const": "product_list",
"default": "product_list",
"title": "View",
"type": "string"
}
},
"required": [
"code",
"currency",
"products",
"notice"
],
"title": "BarcodeResult",
"type": "object"
}
},
{
"description": "Search SkyBuyFly's price comparison of airport duty-free shops by product name, brand or category. Returns one card per product with its price at every airport shop that sells it (cheapest first, in the requested currency), its lowest price (an airport's or an online shop's), its product_id and a link to its SkyBuyFly page. Relevant when a traveller asks what something costs at airports, where it is cheapest, or whether an airport sells it. With airports (IATA codes) it returns only the products listed at every one of them, each card showing those airports' prices. Prices are the latest stored observations, each with its date; this tool does not check them live.",
"inputSchema": {
"properties": {
"airports": {
"anyOf": [
{
"items": {
"description": "An airport's 3-letter IATA code, e.g. VIE.",
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Up to 10 airport IATA codes, e.g. ['VIE', 'BER']: only products the catalogue lists at every one of these airports and with a current price at one of them at least; each card then shows the current prices at these airports only (an airport without a current price is left off the card). Leave it out, or pass [], to search every airport. list_airports has the airports SkyBuyFly compares.",
"title": "Airports"
},
"currency": {
"default": "USD",
"description": "A 3-letter ISO 4217 currency code, e.g. EUR (any case; default USD), that every price is shown in; list_currencies has every one.",
"pattern": "^[A-Za-z]{3}$",
"title": "Currency",
"type": "string"
},
"cursor": {
"anyOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The next_cursor of the previous answer, unchanged, to get the next page of the same search.",
"title": "Cursor"
},
"limit": {
"default": 8,
"description": "How many products to return: a whole number from 1 to 20.",
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"query": {
"description": "1-200 characters: what the traveller is looking for, a product name, brand, category or a mix of them, e.g. 'Chanel Coco Mademoiselle 100 ml', 'Lagavulin 16', 'sunscreen'.",
"maxLength": 200,
"minLength": 1,
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "searchArguments",
"type": "object"
},
"name": "search_products",
"outputSchema": {
"$defs": {
"AirportPrice": {
"additionalProperties": false,
"description": "A product's price at one airport, in the requested currency.",
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"price": {
"$ref": "#/$defs/Money"
}
},
"required": [
"code",
"name",
"price"
],
"title": "AirportPrice",
"type": "object"
},
"Money": {
"additionalProperties": false,
"description": "An amount in an ISO 4217 currency, rounded to cents.",
"properties": {
"amount": {
"title": "Amount",
"type": "number"
},
"currency": {
"title": "Currency",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"title": "Money",
"type": "object"
},
"ProductCard": {
"additionalProperties": false,
"description": "One product with its price at every airport that sells it (cheapest first).\n\n``lowest_price``/``highest_price`` span every comparable shop price, online shops included\n(``lowest_price_scope`` says where the lowest is); ``airports`` lists airport prices only. ``offer_count`` is the\nnumber of shop offers the API knows for the product (null where the answer does not say). ``size`` is the API's\nown measure (\"100 ml\"; null where the answer carries none).",
"properties": {
"airports": {
"items": {
"$ref": "#/$defs/AirportPrice"
},
"title": "Airports",
"type": "array"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category"
},
"highest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"lowest_price": {
"anyOf": [
{
"$ref": "#/$defs/Money"
},
{
"type": "null"
}
]
},
"lowest_price_scope": {
"anyOf": [
{
"enum": [
"airport",
"online_shop"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Lowest Price Scope"
},
"offer_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offer Count"
},
"price_observed_at": {
"anyOf": [
{
"description": "ISO 8601 timestamp (UTC)",
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Observed At"
},
"product_id": {
"title": "Product Id",
"type": "string"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size"
},
"skybuyfly_url": {
"title": "Skybuyfly Url",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"product_id",
"title",
"brand",
"category",
"image_url",
"size",
"lowest_price",
"lowest_price_scope",
"highest_price",
"offer_count",
"airports",
"price_observed_at",
"skybuyfly_url"
],
"title": "ProductCard",
"type": "object"
}
},
"additionalProperties": false,
"description": "``search_products`` (``notice``: set when tobacco or nicotine products were left out of this answer).",
"properties": {
"currency": {
"title": "Currency",
"type": "string"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next Cursor"
},
"notice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Notice"
},
"products": {
"items": {
"$ref": "#/$defs/ProductCard"
},
"title": "Products",
"type": "array"
},
"query": {
"title": "Query",
"type": "string"
},
"view": {
"const": "product_list",
"default": "product_list",
"title": "View",
"type": "string"
}
},
"required": [
"query",
"currency",
"products",
"next_cursor",
"notice"
],
"title": "ProductListResult",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c4c438a517e60d97049d8e7ee559982c105482532e515fdc0c4fe7d9cbe45b8c | sha256sum