Nutzen Sie WikiOO.org von Ihrem KI-Assistenten

WikiOO ist primär eine Kunstencyklopädie, die ohne Registrierung frei zugänglich ist – für Studierende und Forschende: Kunstwerke, Künstlerdaten, Epochen und Museen. Digitale Bilder, Drucke und Reproduktionen sind optional.

Was Ihr Assistent tun kann

Suchen Sie nach Kunstwerken, Künstlern, Museen und Artikeln, lesen Sie Details nach, entdecken Sie aktuelle Angebote und erhalten Sie Preise für Drucke oder handgemalte Ölschinken-Reproduktionen.

Der Katalog umfasst 612,379 Kunstwerke, 52,886 Künstler und 5,406 Museen.

Einschränkungen

Es kann keine Bestellungen aufgeben, Zahlungen entgegennehmen oder Änderungen in Ihrem Namen vornehmen. Es stellt Ihnen lediglich Links zur Verfügung: Sie bestellen und bezahlen direkt auf der Website in Ihrem Browser.

Voraussetzungen

Ein Assistent, der das Model Context Protocol (MCP) unterstützt. Sie benötigen weder ein Konto noch einen Key.

Der Server im Überblick

Servernamewikioo-art-search (WikiOO Art Encyclopedia, Version 1.1.0)
Adressehttps://direct.wikioo.org/mcp/
VersandStreamable HTTP: JSON-RPC 2.0 über POST, eine JSON-Antwort pro Anfrage, kein Event-Stream und keine Session
Protokollaktualisierung2025-06-18
AuthentifizierungKeine: kein Konto, kein Key, kein OAuth
PreisKostenlos nutzbar
Funktionen15 Tools, alle schreibgeschützt. Keine Ressourcen und keine Prompts.
KatalogDer Katalog umfasst 612,379 Kunstwerke, 52,886 Künstler und 5,406 Museen.
SprachenJedes Tool verwendet einen language-Parameter: 32 Seitensprachen, standardmäßig Englisch.
Begrenzung der Anfragerate30 Anfragen pro Sekunde und IP-Adresse, mit kurzen Spitzen von 20 zusätzlichen Anfragen. Darüber hinaus antwortet der Server mit HTTP 429.

Verbinden

Fügen Sie diese Adresse Ihrem Assistenten als Remote-MCP-Server oder benutzerdefinierten Connector hinzu:

https://direct.wikioo.org/mcp/

In einem Assistenten mit einem Einstellungsmenü, wie etwa Claude oder ChatGPT: Öffnen Sie die Connector-Einstellungen, fügen Sie einen benutzerdefinierten Connector hinzu, geben Sie die Adresse ein und lassen Sie das Feld für die Authentifizierung leer.

Mit Claude Code:

claude mcp add --transport http wikioo https://direct.wikioo.org/mcp/

In einem mit einer JSON-Datei konfigurierten Client:

{
  "mcpServers": {
    "wikioo-art-search": {
      "type": "http",
      "url": "https://direct.wikioo.org/mcp/"
    }
  }
}

Beispiel anfordern

  • Zeigen Sie mir die Biografie von Artemisia Gentileschi mit Links zu ihren Werken.
  • Welche Künstler lebten im Jahr 1500 in Florenz?
  • Was sagt das Lexikon über die Ursprünge des Kubismus aus?

Ablauf einer Anfrage

  1. Ihr Assistent durchsucht den Katalog und erhält eine Ergebnisliste, die jeweils eine Kennung (pk), eine Seitenadresse, eine Bildadresse und einen Relevanzwert enthält.
  2. Es liest die Details des gewünschten Ergebnisses aus: die Beschreibung, das Museum, in dem das Original aufbewahrt wird, sowie Links zu verwandten Seiten.
  3. Um einen Preis zu ermitteln, wird ein Angebot in Ihrer gewünschten Größe und Währung angefordert. Sie erhalten den Preis zusammen mit einem Link zu einem Bestellformular, das bereits mit der entsprechenden Größe und dem passenden Rahmen vorausgefüllt ist.
  4. Sie öffnen den Link, überprüfen Ihre Bestellung und schließen die Zahlung auf der Website ab.

Testen Sie es über ein Terminal

Verbinden Sie sich mit dem Server, um seinen Namen und die Anweisungen abzurufen:

curl -s https://direct.wikioo.org/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize"}'

Listen Sie die Tools mit ihren vollständigen Input-Schemas auf:

curl -s https://direct.wikioo.org/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Ein Tool aufrufen:

curl -s https://direct.wikioo.org/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "search_artworks", "arguments": {"query": "Artemisia Gentileschi", "limit": 3}}}'

Verfügbare Tools

Diese Liste wird aus den Antworten des Servers auf tools/list generiert und stimmt daher stets mit dem Server überein. Die Beschreibungen sind diejenigen, die Ihr Assistent liest, und sind in englischer Sprache verfasst.

Welches Suchwerkzeug Sie nutzen sollten:

  • search_fts: Sie kennen einen Namen oder Schlagworte und suchen die passenden Kunstwerke, Künstler, Museen und Artikel.
  • search_artworks, search_artists, search_museums, search_articles: Sie suchen gezielt nach einer bestimmten Objektart mit den dazugehörigen Filtern wie Stadt, Land oder Artikelkategorie.
  • search_sections_semantically: Sie haben eine Frage und möchten die entsprechenden Textpassagen finden.
  • search_objects_semantically: Sie haben einen Text und möchten die darin enthaltenen Kunstwerke, Künstler, Museen oder Artikel finden.
  • find_artwork_in_catalog: Sie erinnern sich nur vage an ein Werk (einen Titel, einen Künstler, eine Beschreibung) und möchten mit nur einem Aufruf wissen, ob es im Katalog enthalten ist.

Alle verfügbaren Tools:

search_artworks

Search artworks · schreibgeschützt

Keyword search of ONE model, the artworks: words of the title, the artist name and the description. Use it when you are looking for a work (a painting, a drawing, a sculpture). When the words may name an artist, a museum or an article instead, use search_fts, which searches the four models in one call; when you have a sentence or a paragraph and no name, use search_objects_semantically. Optional artist: only the works of that artist, the query words matched against ALL of them (artist_artworks_count says how many) - without query, his most popular works. To find out whether a half-remembered work is in the catalog, use find_artwork_in_catalog (one call) rather than many searches with title variants. Returns only good-confidence matches with pk, artist_name, title, url, image_url (absolute URL of the large artwork image, null when the artwork has no image) and relevance score.

Parameter Typ Erforderlich Beschreibung
query string nein Words from the artwork title, artist name and/or description (optional when artist is given).
artist string nein Optional artist name: search only his works.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of results (1-10, default 10).

search_museums

Search museums · schreibgeschützt

Keyword search of ONE model, the museums, by name, with two filters no other search tool has: city and country. Use it when you are looking for a museum or for the museums of a place; when the words may name something else than a museum, use search_fts. Returns only good-confidence matches with pk, name, url, image_url (absolute URL of the large museum image, null when there is none), city, country and relevance score.

Parameter Typ Erforderlich Beschreibung
query string ja Museum name or words from it.
city string nein Optional city to narrow the search.
country string nein Optional country to narrow the search.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of results (1-10, default 10).

search_artists

Search artists · schreibgeschützt

Keyword search of ONE model, the artists, by name and biography, with three filters no other search tool has: birth city, birth country and a year the artist was alive (born <= year <= died, or born + 80 years when the death year is unknown). Use it when you are looking for a person; when the words may name a work, a museum or an article, use search_fts. Returns pk, artist_name, url, image_url (absolute URL of the large artist portrait, null when there is none), city, country, date_born, date_death and score.

Parameter Typ Erforderlich Beschreibung
query string ja Artist name or words from the biography.
city string nein Optional birth city.
country string nein Optional birth country.
alive_in_year integer nein Optional year the artist was alive, e.g. 1503.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of results (1-10, default 10).

search_articles

Search articles · schreibgeschützt

Keyword search of ONE model, the articles of the website, with a category filter no other keyword search has. Use it to LIST the articles on a subject; to get the passages that answer a question, use search_sections_semantically. Returns pk, title, url, image_url (absolute URL of the large article image, null when there is none), category_code, meta_description and relevance score.

Parameter Typ Erforderlich Beschreibung
query string ja Words to search in the article texts.
category_code string nein Optional article category filter. (Video, Blog, Testimonial, Top10, Top25, Top10Versus, Top, Ebook, Support, Misc, Menu, Website, Compare, QuestionAnswer, ArtVsArt)
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of results (1-10, default 10).

search_sections_semantically

Search passages by meaning (articles, museums, artists, artworks) · schreibgeschützt

Search by MEANING that returns TEXT PASSAGES, not objects: the sections of our texts that answer a question best, whatever words they use, each WHOLE (section_text is never cut), from the requested models - "article" (our articles: how reproductions are made, policies, art history), "museum", "artist", "artwork" (their descriptions / biographies); default all models indexed on this server. Each result: model, object_pk (use it with the matching get_detail_* tool), object_title, object_url, category_code (articles), section_heading, section_text, is_faq_question, score (cosine; higher is closer). Ask in a full sentence; any language works (the texts are in English). Sections are packed best first into about 9,000 characters: sections_omitted_for_size says how many more matched. Use it to answer a question from what our texts say; to find a work, artist or museum by name or keywords, use search_fts; to find the objects a text is about, use search_objects_semantically. Error index_unavailable: fall back to the search_* full-text tools.

Parameter Typ Erforderlich Beschreibung
query string ja The question or text to find passages for (up to 2000 characters).
models array nein Which texts to search (default: every model indexed on this server).
category_code string nein Optional article category filter (Support / Website for service and policy questions); applies to articles only. (Video, Blog, Testimonial, Top10, Top25, Top10Versus, Top, Ebook, Support, Misc, Menu, Website, Compare, QuestionAnswer, ArtVsArt)
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of sections (1-10, default 5).

search_objects_semantically

Find artworks, artists, museums or articles by meaning · schreibgeschützt

Search by MEANING that returns OBJECTS, not passages: the artworks, artists, museums or articles whose texts are closest in meaning to a text (a description, a paragraph, a section of an article), e.g. "a woman reading by a window in soft morning light". The query is a text, not a name. Each result: model, object_pk (use it with the matching get_detail_* tool), object_title, object_url, best_score (cosine of the object's single best passage; higher is closer), score_sum (its matching passages added up) and matched_vectors_count. rank_by "score_sum" (default) favours objects matching in many passages; "best_score" favours the one passage closest to the text - use it to find the exact work a text is about. Any language works (the texts are in English). Use it when you have a text and want the objects it is about; with a name or keywords, use search_fts; for the passages that answer a question, use search_sections_semantically. Error index_unavailable: fall back to the search_* full-text tools.

Parameter Typ Erforderlich Beschreibung
query string ja The text to find objects for (up to 2000 characters).
models array nein Which objects to search (default: artwork, artist, museum).
rank_by string nein Ranking: sum of the matching passages (default) or the single best one. (score_sum, best_score)
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".
limit integer nein Maximum number of objects (1-20, default 10).

search_fts

Find artworks, artists, museums and articles by name or keywords · schreibgeschützt

Keyword search of the FOUR models in one call: artworks, artists, museums and articles (maximum 10 results per model, merged by relevance; each result names its model). It is the first search to try when you have a name or keywords and do not know which kind of object they name ("Monet", "Orsay", "Water Lilies"). It has no filter: once you know the model, search_artworks / search_artists / search_museums / search_articles search that model alone, with its filters (city, country, year alive, category). It matches WORDS: for a sentence or a paragraph without a name, use search_objects_semantically (the objects a text is about) or search_sections_semantically (the passages that answer a question). Each result carries pk, model, title, artist_name, city, country, date_born, date_death, url, image_url (absolute URL of the large image, null when there is none), meta_description and score.

Parameter Typ Erforderlich Beschreibung
query string ja Words to search across all four catalogs.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_detail_artwork

Get artwork details · schreibgeschützt

Full data of ONE artwork identified by pk (use a search tool first to find the pk). Always returns: pk, title, meta_description, meta_keywords (first 5), description_html (the artwork description as HTML), url (the artwork page), image_url, and "links" — up to 5 ready-to-give absolute URLs of the most useful related pages (download_page, buy_print_page, buy_oil_painting_page (only for channels on sale), student_guide_page, similar_artworks_page, preview_in_room_page). Also for every caller: "museum" - where the original is kept (pk, name, url of its page on this site, city, country), null when unknown. artwork_not_found when no such artwork is published. The result is capped at 25000 characters: when description_html had to be shortened to fit, "truncated" is true.

Parameter Typ Erforderlich Beschreibung
pk integer ja The object pk, as returned by a search tool.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_detail_artist

Get artist details · schreibgeschützt

Full data of ONE artist identified by pk (use a search tool first to find the pk). Always returns: pk, title, meta_description, meta_keywords (first 5), description_html (the artist biography as HTML), url (the artist page), image_url, and "links" — up to 5 ready-to-give absolute URLs of the most useful related pages (artwork_timeline_page, all_artworks_page, chronicle_page, subject_atlas_page, mood_room_page). artist_not_found when no such artist is published. The result is capped at 25000 characters: when description_html had to be shortened to fit, "truncated" is true.

Parameter Typ Erforderlich Beschreibung
pk integer ja The object pk, as returned by a search tool.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_detail_museum

Get museum details · schreibgeschützt

Full data of ONE museum identified by pk (use a search tool first to find the pk). Always returns: pk, title, meta_description, meta_keywords (first 5), description_html (the museum description as HTML), url (the museum page), image_url, and "links" — up to 5 ready-to-give absolute URLs of the most useful related pages (city_museums_page, museums_by_country_page, official_website, all_museums_page). museum_not_found when no such museum is published. The result is capped at 25000 characters: when description_html had to be shortened to fit, "truncated" is true.

Parameter Typ Erforderlich Beschreibung
pk integer ja The object pk, as returned by a search tool.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_detail_article

Get article details · schreibgeschützt

Full data of ONE article identified by pk (use a search tool first to find the pk). Always returns: pk, title, meta_description, meta_keywords (first 5), description_html (the full article content as HTML), url (the article page), image_url, and "links" — up to 5 ready-to-give absolute URLs of the most useful related pages (articles_by_category_page, all_articles_page, rss_feed). article_not_found when no such article is published. The result is capped at 25000 characters: when description_html had to be shortened to fit, "truncated" is true.

Parameter Typ Erforderlich Beschreibung
pk integer ja The object pk, as returned by a search tool.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_quotation

Get a reproduction price quotation · schreibgeschützt

Price quotation for a reproduction of an artwork, as an art print or a hand-painted oil painting, at a given size and in a given currency. Leave type out to get BOTH in one call: the result then holds "quotations" (one full quotation per type the artwork sells, each with its own price, buy_url and offer_text) and "types_not_available". Every quotation carries offer_text, one ready-to-paste line (type, size, frame, price, order link): give it to the user as is, translating its words if needed but never changing its numbers or link. Optional frame_code adds the frame price to quotation_price ("WhiteWrap" = stretched on stretcher bars, "default" = a decorative frame chosen for the artwork, or a catalog code); optional senior_artist (oil painting only) adds the "Elite Senior Artist" upgrade — more detail and finesse, extra production time — to quotation_price. Identify the artwork by pk, or by title and/or artist_name (an exact title match wins; otherwise the first good-confidence search match is used, and its relevance is returned in "score"). A fuzzy match can be a different painting than the one asked for: when the result carries a "warning", verify the returned title before using the price, as the warning instructs. width/height need not match the artwork's own proportions: when its aspect ratio is known, the quoted size is snapped to that ratio while keeping the same surface area (width x height) you requested, so the reproduction is never stretched or distorted; the actual quoted size is returned as width_cm/height_cm (vs. your original requested_width_cm/requested_height_cm), with size_ratio_adjusted set to true when this happened. Give only width OR only height (e.g. "25 cm high", "smallest side 25 cm") to keep that side exactly: the other side is then derived from the artwork's aspect ratio and size_derived_from names the side you gave (fails with invalid_size when the ratio is unknown - then give both). Each side must be 25-250 cm (about 10-98 inches): a size outside that range is NOT refused but quoted at the nearest valid size with the same proportions, with size_adjusted_to_minimum / size_adjusted_to_maximum set to true; whenever the quoted size differs from the request, size_note says in one sentence what changed and why - repeat it to the user. invalid_size only comes back when no size of these proportions can fit the range. Returns pk, artist_name, title, meta_description, quotation_price, currency, frame_code (+ frame_description, frame_delivery), url (catalog page) and buy_url. buy_url is a ready-to-open, fully-parameterised buy form: reproduction medium, size and frame are all set from the query string, so the page opens showing exactly quotation_price. Give it to the user as the link to order the artwork at the quoted configuration. When the artwork ITSELF is for sale right now (a ready-made oil painting in stock, an open auction lot, an original, a studio collectible), the result also carries available_now (offers with price, stock quantity and offer_text, plus a note): tell the customer about the real object in the same answer — a quotation is a copy made to order. An artwork sold only as such an object answers with quotations empty and available_now set, not with channel_not_available.

Parameter Typ Erforderlich Beschreibung
pk integer nein Artwork pk (from a search tool).
title string nein Artwork title (used when pk is not given).
artist_name string nein Artist name (used when pk is not given).
type string nein Reproduction type: "print" (art print) or "oil painting" (hand-painted). Omit to quote both at once. (print, oil painting)
width number nein Width in the given unit. Omit to derive it from height.
height number nein Height in the given unit. Omit to derive it from width.
unit string ja Unit of width/height. (inches, cm)
currency string ja ISO currency code, e.g. "USD", "EUR", "GBP".
frame_code string nein Optional frame; when set, quotation_price includes it. Omit it (or "NoFrame") for the canvas rolled in a tube. "WhiteWrap" = the canvas stretched on wooden stretcher bars, white edges, no outer frame (use it for any request for a stretcher, stretcher bars, a stretched canvas or a canvas ready to hang without a frame); "BlurSideWrap" / "ExtendedWrap" = the same with the image blurred / continued around the edges. "default" = a decorative outer frame chosen for you (the frame recommended for the artwork when it has one, else our best-selling frame) — use it to quote a framed option without knowing the catalog. Any other catalog code (e.g. "P118B", "P919G", "W316G", "H24-GOLD-Portrait") is that specific decorative frame. The result then carries frame_description, frame_delivery (assembled, or a disassembled kit over 105 cm) and, for "default", frame_chosen_by. buy_url prefills the frame.
senior_artist boolean nein Oil painting only: have an Elite Senior Artist paint it (more detail, finesse and extra production time). When true, quotation_price includes the upgrade and buy_url pre-selects it.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_custom_reproduction_quotation

Get a custom reproduction price quotation (no catalog artwork needed) · schreibgeschützt

Price quotation for a CUSTOM reproduction — one made from an image the customer supplies (their own photo, or an artwork that is not in the catalog) — as an art print or a hand-painted oil painting. No artwork identification is needed or accepted: the price depends only on the size, the reproduction type and the currency. Use this whenever the artwork cannot be found in the catalog (the search tools return nothing relevant, or get_quotation fails with artwork_not_found), or the customer wants their own picture reproduced. Optional frame_code ("WhiteWrap" = stretched on stretcher bars, "default" = a decorative frame chosen for you, or a catalog code) adds the frame price to quotation_price; optional senior_artist (oil painting only) adds the "Elite Senior Artist" upgrade — more detail and finesse, extra production time. Each side must be 25-250 cm (about 10-98 inches). Returns quotation_price (the base price: options chosen on the order form, like varnish or urgent delivery, cost extra — see "notes"), currency, frame_code (+ frame_description, frame_delivery), width_cm/height_cm, notes, and order_page_url — the page where the customer uploads their image and orders the reproduction. Give order_page_url to the user as the link to place this order. For a hand-painted portrait the price covers up to 3 faces; the per-extra-face surcharge is stated in notes.

Parameter Typ Erforderlich Beschreibung
type string ja Reproduction type: "print" (art print) or "oil painting" (hand-painted). (print, oil painting)
width number nein Width in the given unit.
height number nein Height in the given unit.
unit string ja Unit of width/height. (inches, cm)
currency string ja ISO currency code, e.g. "USD", "EUR", "GBP".
frame_code string nein Optional frame; when set, quotation_price includes it. Omit it (or "NoFrame") for the canvas rolled in a tube. "WhiteWrap" = the canvas stretched on wooden stretcher bars, white edges, no outer frame (use it for any request for a stretcher, stretcher bars, a stretched canvas or a canvas ready to hang without a frame); "BlurSideWrap" / "ExtendedWrap" = the same with the image blurred / continued around the edges. "default" = a decorative outer frame chosen for you (the frame recommended for the artwork when it has one, else our best-selling frame) — use it to quote a framed option without knowing the catalog. Any other catalog code (e.g. "P118B", "P919G", "W316G", "H24-GOLD-Portrait") is that specific decorative frame. The result then carries frame_description, frame_delivery (assembled, or a disassembled kit over 105 cm) and, for "default", frame_chosen_by. The customer selects that frame on the order form (notes says which).
senior_artist boolean nein Oil painting only: have an Elite Senior Artist paint it (more detail, finesse and extra production time). When true, quotation_price includes the upgrade; the customer selects the option on the order form.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

get_artwork_availability

Is this artwork available now, and at what price (stock, auction, originals, collectibles) · schreibgeschützt

Every way to buy ONE artwork right now, on every sales channel it sells: the physical objects first — a ready-made oil painting in stock ("Stock Discount Oil Painting", a real canvas that ships within 48 hours), an auction lot (current bid, minimum next bid, closing time), an original sold by its owner, a studio collectible — each with available_now, stock_quantity, price (fixed, shipping included) in your currency, size, buy_url and offer_text (one ready-to-paste line: give it to the customer as is, numbers and link untouched); then the made-to-order channels (hand-painted oil reproduction, art print: price by size through get_quotation) and the digital image licence. available_now is true only when the artwork ITSELF can be bought or bid on today; available_now_summary says it in one sentence. Call it whenever a customer asks whether something is available, in stock, ready to ship, discounted, on auction, or what it costs as a real object — and before any "yes, it is available". Identify the artwork by pk, or by title and/or artist_name (exact title first, then a surname-guarded search whose relevance comes back in "score"; a "warning" means check the returned title). Without pk or title, give channel to LIST the objects of that channel for sale now (cheapest first; optional artist_name, query words from the title, max_price in your currency, limit 1-10): "what do you have in stock under 200 euros?", "which auctions are open?". Prices follow the strict no-fallback currency rule of the quotation tools.

Parameter Typ Erforderlich Beschreibung
pk integer nein Artwork pk (from a search tool or the page).
title string nein Artwork title (used when pk is not given).
artist_name string nein Artist name: with title/pk it identifies the artwork; in the list mode it filters the objects by artist.
channel string nein List mode (no pk, no title): which physical channel to list — PaintingReady (ready-made oil paintings in stock), ProductAuction (auction lots), SellerProduct (originals sold by their owner), FactoryProduct (studio collectibles). With pk/title it narrows the offers to that channel. (ProductAuction, SellerProduct, FactoryProduct, PaintingReady)
query string nein List mode: words from the title (e.g. "flowers", "sunset").
max_price number nein List mode: highest price, in the given currency.
limit integer nein List mode: how many objects (default 10).
currency string ja ISO currency code, e.g. "USD", "EUR", "GBP".
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

find_artwork_in_catalog

Is this artwork in the catalog? (title from memory, artist, description) · schreibgeschützt

ONE call that says whether a work is in our catalog, for a visitor who cannot name it exactly: a half-remembered or translated title, an artist, a description of the picture — or several of them. It matches the title words against EVERY work of the artist (not only 10 search results) and runs the full-text search in the visitor's language and English; a description goes through the meaning index. Returns verdict ("found", "candidates", "possible_matches_by_meaning", "artist_works_listed" or "not_in_catalog"), next_step (what to do now — follow it), candidates (at most 5, best first: pk, artist_name, title, year, url, image_url), and, when an artist was recognised, artist (pk, url, artworks_count, all_artworks_page) and artist_works (the titles of his works, to spot the same work under another title). Use it FIRST, instead of a series of search_artworks with title variants. When you learn the work's real title (from the encyclopedia or the visitor), call it once more with alternative_titles; after that, do not search again.

Parameter Typ Erforderlich Beschreibung
title string nein The title as the visitor gave it (from memory, any language).
alternative_titles array nein Other titles of the same work: the English title, the real title found in the encyclopedia (e.g. "Pêcheur à la coquille" for "le sourire napolitain").
artist string nein Artist name, when the visitor gave one.
description string nein What the picture shows, when the visitor describes it.
language string nein Site language code (2 letters, e.g. "en", "fr"). Default "en".

Gut zu wissen

  • Die Suche umfasst den gesamten Katalog unserer verschiedenen Seiten und nicht nur das Spezialgebiet dieser Seite, sodass Suchergebnisse auch außerhalb des aktuellen Bereichs liegen können.
  • Jede Adresse in einer Antwort ist absolut und verweist auf diese Website.
  • Jede Seite einer Reproduktion muss zwischen 25 und 250 cm groß sein. Maße außerhalb dieses Bereichs werden auf die nächste gültige Größe gerundet, wobei die Antwort die entsprechende Änderung angibt.
  • Ein Angebot bezieht sich auf den Preis für eine Auftragsanfertigung. Wenn das Kunstwerk selbst zum Verkauf steht, wird dies ebenfalls mit dem Preis und dem aktuellen Bestand angegeben.
  • Eine semantische Suche kann index_unavailable beantworten: Der Assistent greift dann auf die Volltextsuche-Tools zurück.

Fehlermeldungen

JSON-RPC-Fehlercode Bedeutung
-32700Der Request-Body ist kein gültiges JSON.
-32600Die Nachricht ist keine gültige JSON-RPC 2.0-Nachricht. Batches werden nicht akzeptiert.
-32601Die Methode wird nicht unterstützt. Der Server antwortet mit initialize, ping, tools/list und tools/call.
-32602Unbekanntes Tool oder ungültige Argumente. Die Fehlermeldung gibt an, worum es sich handelt.
-32603Ein Fehler ist auf unserer Seite aufgetreten. Bitte versuchen Sie es erneut oder kontaktieren Sie uns.

Datenschutz

Der Server benötigt weder einen Namen noch ein Konto oder einen Schlüssel; zudem greifen diese Tools ausschließlich auf öffentliche Katalogdaten zu.

Was wir erfassen. Für jeden Tool-Aufruf protokollieren wir den Namen des Tools, die Sprache, die Website, den Zeitpunkt, den User-Agent des Clients sowie einen gesalzenen Hash seiner IP-Adresse. Ihre Suchbegriffe sind nicht Bestandteil dieser Aufzeichnung. Unser Webserver führt zudem standardmäßige Zugriffsprotokolle, die IP-Adressen enthalten.

Warum. Zur Messung der Servernutzung sowie zur Gewährleistung von Sicherheit und Funktionalität.

Empfänger Diese Daten verbleiben auf den Servern unseres Hosting-Anbieters. Wir verkaufen sie nicht und geben sie nicht an Werbetreibende weiter. Der Anbieter Ihres Assistenten verarbeitet Ihre Konversation gemäß dessen eigenen Nutzungsbedingungen.

Wie lange Höchstens ein Jahr, danach werden die Datensätze automatisch gelöscht. Sicherungskopien können einige Wochen länger aufbewahrt werden.

Ihre Einstellungen. Sie können den Server auch ohne Konto nutzen und ihn jederzeit aus Ihrem Assistenten entfernen. Diese Datensätze enthalten keine Namen. Um eine Frage zu stellen oder die Löschung zu beantragen, schreiben Sie bitte an die unten aufgeführte Support-Adresse und geben Sie dabei Ihre IP-Adresse sowie die betreffenden Daten an.

Datenschutzerklärung dieser Website lesen

Support

Haben Sie eine Frage oder ein Problem mit dem Server? Schreiben Sie uns: [email protected]