Serveur MCP

audioknihy.cz Catalog

cz.audioknihy/catalog
Commerce et retail Médias et contenu Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Searches a Czech audiobook catalog and compares retail offers, prices, discounts, rankings, price trends, authors, narrators, and publishers.

browse_genres
Browse Genres
List all 35 Czech audiobook genres with audiobook counts. Discovery entry point — agents enumerate genres before drilling into a specific one.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'description', 'audiobook_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'description': {'type': ['string', 'null']}, 'audiobook_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}
compare_all_offers
Compare All Offers
Full price comparison table across every active retail partner for one audiobook. Returns price + format + last-seen timestamp per partner — agents can rank or filter.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['author_slug', 'work_slug'], 'properties': {'work_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Work slug (lowercase, hyphenated). Example: "to".'}, 'author_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Author slug (lowercase, hyphenated). Example: "stephen-king".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['partner', 'price_czk', 'original_price_czk', 'format', 'url', 'last_seen'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'format': {'type': 'string'}, 'partner': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}}, 'additionalProperties': False}, 'last_seen': {'type': 'string'}, 'price_czk': {'type': ['number', 'null']}, 'original_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
find_cheapest_offer
Find Cheapest Offer
Lowest-price active offer for an audiobook across all affiliate partners. USP — only Czech site that compares audiobook prices across all major retail partners.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['author_slug', 'work_slug'], 'properties': {'work_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Work slug (lowercase, hyphenated). Example: "to".'}, 'author_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Author slug (lowercase, hyphenated). Example: "stephen-king".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['partner', 'price_czk', 'original_price_czk', 'format', 'url', 'last_seen'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'format': {'type': 'string'}, 'partner': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}}, 'additionalProperties': False}, 'last_seen': {'type': 'string'}, 'price_czk': {'type': ['number', 'null']}, 'original_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_audiobook
Get Audiobook Detail
Full audiobook detail by author + work slug — title, description, cover, runtime, ISBN, genres, narrator, publisher, and the full table of active offers across retail partners.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['author_slug', 'work_slug'], 'properties': {'work_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Work slug (lowercase, hyphenated). Example: "to". Combined with author_slug forms the canonical work URL.'}, 'author_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Author slug (lowercase, hyphenated). Example: "stephen-king". Discoverable via search_audiobooks results.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['slug', 'title', 'description', 'cover_url', 'year', 'rating_avg', 'rating_count', 'language', 'author', 'offers', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'year': {'type': ['number', 'null']}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name', 'bio', 'photo_url'], 'properties': {'bio': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}, 'photo_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['partner', 'price_czk', 'original_price_czk', 'format', 'url', 'last_seen'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'format': {'type': 'string'}, 'partner': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}}, 'additionalProperties': False}, 'last_seen': {'type': 'string'}, 'price_czk': {'type': ['number', 'null']}, 'original_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'language': {'type': 'string'}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'rating_avg': {'type': ['number', 'null']}, 'description': {'type': ['string', 'null']}, 'rating_count': {'type': ['number', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_audiobook_rankings
Audiobook Rankings
Catalog-wide audiobook rankings — cheapest, best-rated (databazeknih.cz, attributed), biggest price drops, or currently at price floor. Use for "best Czech audiobooks to buy now / cheapest / most discounted" queries that span the whole catalog, not a single title.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ranking'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of ranked audiobooks. 1–50, default 10.'}, 'ranking': {'enum': ['cheapest', 'best-rated', 'biggest-drops', 'price-floor'], 'type': 'string', 'description': 'Which catalog ranking to return: "cheapest" (lowest live price among genuinely reviewed audiobooks), "best-rated" (highest databazeknih.cz third-party rating), "biggest-drops" (largest recent price drop), "price-floor" (currently at their lowest observed price). Mirrors the four /zebricky pages.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'current_price_czk', 'url', 'drop_pct', 'at_floor', 'window_label', 'dbk_rating'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/items/properties/slug'}}, 'additionalProperties': False}, 'at_floor': {'type': 'boolean'}, 'drop_pct': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'dbk_rating': {'anyOf': [{'type': 'object', 'required': ['avg', 'count', 'source'], 'properties': {'avg': {'type': 'number'}, 'count': {'type': 'integer'}, 'source': {'type': 'string', 'const': 'databazeknih.cz'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'window_label': {'type': ['string', 'null']}, 'current_price_czk': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_author
Get Author Profile
Author profile + their audiobook works. Returns biography, photo, country, and the full list of audiobook editions where this person is credited as author / co-author / editor.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Author slug (lowercase, hyphenated). Discoverable via search_audiobooks results. Example: "stephen-king".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['slug', 'name', 'bio', 'photo_url', 'works', 'url'], 'properties': {'bio': {'type': ['string', 'null']}, 'url': {'$ref': '#/properties/value/anyOf/0/properties/works/items/properties/url'}, 'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'works': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'lowest_price_czk', 'partner_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}}, 'additionalProperties': False}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'partner_count': {'type': 'integer', 'minimum': 0}, 'lowest_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'photo_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_narrator
Get Narrator Profile
Narrator profile + audiobooks they have read. Czech audiobook listeners often choose by narrator (performance quality often matters more than the underlying text).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Narrator slug (lowercase, hyphenated). Example: "lukas-hlavica". Discoverable via search_audiobooks results or work detail offer.narrator references.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['slug', 'name', 'photo_url', 'works', 'url'], 'properties': {'url': {'$ref': '#/properties/value/anyOf/0/properties/works/items/properties/url'}, 'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'works': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'lowest_price_czk', 'partner_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}}, 'additionalProperties': False}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'partner_count': {'type': 'integer', 'minimum': 0}, 'lowest_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'photo_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_price_index
Audiobook Price Index
Cross-store price index for the whole Czech audiobook market: median/avg lowest price, average savings from comparing, which store is cheapest most often, and per-genre price stats. Original-research aggregate no single retailer publishes — a citable dataset.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'object', 'required': ['total_works', 'total_offers', 'total_stores', 'median_lowest_czk', 'avg_lowest_czk', 'multi_store_works', 'avg_savings_czk', 'cheapest_store', 'by_genre', 'data_as_of', 'generated_at'], 'properties': {'by_genre': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'works', 'avg_lowest_czk', 'min_price_czk'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'works': {'type': 'integer', 'minimum': 0}, 'min_price_czk': {'type': 'number'}, 'avg_lowest_czk': {'type': 'number'}}, 'additionalProperties': False}}, 'data_as_of': {'type': ['string', 'null']}, 'total_works': {'type': 'integer', 'minimum': 0}, 'generated_at': {'type': 'string'}, 'total_offers': {'type': 'integer', 'minimum': 0}, 'total_stores': {'type': 'integer', 'minimum': 0}, 'avg_lowest_czk': {'type': ['number', 'null']}, 'cheapest_store': {'anyOf': [{'type': 'object', 'required': ['name', 'wins'], 'properties': {'name': {'type': 'string'}, 'wins': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'avg_savings_czk': {'type': ['number', 'null']}, 'median_lowest_czk': {'type': ['number', 'null']}, 'multi_store_works': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_price_trend
Price Trend
Price history of an audiobook's currently-displayed cheapest offer: window min/max, current price, % drop, whether it is at its floor, and the raw points. Use to answer "is this a good price right now / has it dropped?". Returns null when there is no recorded history in the window.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['author_slug', 'work_slug'], 'properties': {'work_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Work slug (lowercase, hyphenated). Example: "netopyr".'}, 'author_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Author slug (lowercase, hyphenated). Example: "jo-nesbo".'}, 'window_days': {'type': 'integer', 'default': 90, 'maximum': 365, 'minimum': 1, 'description': 'Look-back window in days. 1–365, default 90.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['current_price_czk', 'window_min_czk', 'window_max_czk', 'drop_pct', 'at_floor', 'point_count', 'span_days', 'window_days', 'points'], 'properties': {'points': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'price_czk'], 'properties': {'date': {'type': 'string'}, 'price_czk': {'type': 'number'}}, 'additionalProperties': False}}, 'at_floor': {'type': 'boolean'}, 'drop_pct': {'type': 'integer'}, 'span_days': {'type': 'integer'}, 'point_count': {'type': 'integer'}, 'window_days': {'type': 'integer'}, 'window_max_czk': {'type': 'number'}, 'window_min_czk': {'type': 'number'}, 'current_price_czk': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_publisher
Get Publisher Profile
Publisher (nakladatelství) profile + their audiobooks. Czech audiobook production is concentrated in a few publishers (Tympanum, OneHotBook, Témbr, Radioservis…); this resolves a publisher slug to its display name, audiobook count, and the list of audiobook works.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Publisher slug (lowercase, hyphenated). Example: "tympanum". Discoverable via the /nakladatelstvi index page.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of works to return. 1–50, default 50.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'anyOf': [{'type': 'object', 'required': ['slug', 'name', 'audiobook_count', 'works', 'url'], 'properties': {'url': {'$ref': '#/properties/value/anyOf/0/properties/works/items/properties/url'}, 'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'works': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'lowest_price_czk', 'partner_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/anyOf/0/properties/slug'}}, 'additionalProperties': False}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'partner_count': {'type': 'integer', 'minimum': 0}, 'lowest_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'audiobook_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
list_partners
List Retail Partners
List active retail partners with audiobook counts. Required for transparency / disclosure when an agent needs to explain HOW audioknihy.cz monetises recommendations (we are an affiliate aggregator, not a retailer).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'homepage', 'audiobook_count'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'homepage': {'type': 'string', 'format': 'uri'}, 'audiobook_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_audiobooks
Search Audiobooks
Full-text + fuzzy search across 12 367 Czech audiobooks (title, author, narrator). Use when an agent needs to resolve a free-form query into one or more audiobook records.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return. 1–50, default 10.'}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Free-form search query. Matches against audiobook title, author name, and narrator name. Czech diacritics are normalized (so "skola" finds "škola"). 1–200 characters.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'lowest_price_czk', 'partner_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/items/properties/slug'}}, 'additionalProperties': False}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'partner_count': {'type': 'integer', 'minimum': 0}, 'lowest_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_by_filters
Search by Filters
Multi-facet search of audiobooks: combine genre, narrator, max price, year range. Use when an agent has structured constraints rather than a free-form query. V1 supports genre + narrator + price_max + year filters; partner filter coming in V2.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return. 1–50, default 20.'}, 'year_max': {'type': 'integer', 'maximum': 2100, 'minimum': 1900, 'description': 'Latest publication year (inclusive). V1 accepts but skips this filter.'}, 'year_min': {'type': 'integer', 'maximum': 2100, 'minimum': 1900, 'description': 'Earliest publication year (inclusive). V1 accepts but skips this filter.'}, 'genre_slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1, 'description': 'Genre slug to anchor the search. Discoverable via browse_genres. Example: "detektivky".'}, 'partner_slug': {'$ref': '#/properties/genre_slug', 'description': 'Reserved for V2 — partner-side filtering is not yet implemented and will throw if set.'}, 'narrator_slug': {'$ref': '#/properties/genre_slug', 'description': 'Narrator slug to anchor the search. Example: "lukas-hlavica".'}, 'price_max_czk': {'type': 'number', 'maximum': 10000, 'description': 'Maximum price in CZK applied as a post-filter on each result row.', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['value'], 'properties': {'value': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'author', 'cover_url', 'lowest_price_czk', 'partner_count', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https\\:\\/\\/audioknihy\\.cz\\/'}, 'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(-[a-z0-9]+)*$', 'maxLength': 120, 'minLength': 1}, 'title': {'type': 'string'}, 'author': {'type': 'object', 'required': ['slug', 'name'], 'properties': {'name': {'type': 'string'}, 'slug': {'$ref': '#/properties/value/items/properties/slug'}}, 'additionalProperties': False}, 'cover_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'partner_count': {'type': 'integer', 'minimum': 0}, 'lowest_price_czk': {'type': ['number', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Ajouté
get_price_index
17 September 2026 12:38
Ajouté
get_publisher
17 September 2026 12:38
Ajouté
get_price_trend
17 September 2026 12:38
Ajouté
get_audiobook_rankings
17 September 2026 12:38
Ajouté
list_partners
17 September 2026 12:38
Ajouté
get_narrator
17 September 2026 12:38
Ajouté
get_author
17 September 2026 12:38
Ajouté
search_by_filters
17 September 2026 12:38
Ajouté
browse_genres
17 September 2026 12:38
Ajouté
compare_all_offers
17 September 2026 12:38
Ajouté
find_cheapest_offer
17 September 2026 12:38
Ajouté
get_audiobook
17 September 2026 12:38
Ajouté
search_audiobooks
17 September 2026 12:38