skkg_search_objects
skkg_search_objectsRead-onlyIdempotent
Search SKKG objects by German keywords and filters; results include IDs, website URLs, and separate image and object rights, with full records available via object lookup.
Instructions
Search SKKG objects by German keywords and filters; the main entry point. The data is German: translate the user's words ("Stillleben", not "still life"). Term filters take a German label or a term id; an unknown label is refused, with similar labels if there are any and the skkg_find_terms call that lists them all. Each result carries its id, website_url, image_license (the primary image) and object_copyright (the object itself): quote both, they are separate rights. For the full record of one object (production, acquisition, provenance chain, images), use skkg_get_object. A search with neither query nor filter is refused.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "skkg_search_objects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of vocabulary labels. Most vocabularies, materials and object types among them, have German labels only, which are returned whatever the language; titles and texts stay as recorded | de |
| sort | No | relevance (default with a query), inventory_number (default without), date_asc, date_desc, or acquisition_date (oldest SKKG acquisition first) | |
| epoch | No | Epoch label as SKKG dates objects, e.g. "19. Jh.", "1. Hälfte 20. Jh.". A term id ("type/…") or a German label, matched exactly except for case. | |
| limit | No | ||
| query | No | German keywords over titles, inscriptions, object texts, and inventory numbers. Every word must occur; "a phrase" matches in order; a trailing * matches a prefix; OR between two words matches either; NOT before a word excludes it. Umlauts may be written ä or ae | |
| scope | No | Where the query matches: all (default), title, inscription, text (descriptions), or inventory_number | all |
| offset | No | ||
| creator | No | Creator: an actor id ("person/41") or a name ("Anker", "Albert Anker"). A name matches every person whose name contains all its words; applied_filters lists them | |
| date_to | No | Latest year of production; see date_from | |
| part_of | No | Object id (its parts) or object group id (its members) | |
| material | No | Material, e.g. "Holz", "Papier", "Silber". A term id ("type/…") or a German label, matched exactly except for case. | |
| date_from | No | Earliest year of production. Matches objects whose dating overlaps the range; undated objects never match | |
| has_image | No | Only objects with (true) or without (false) a published image | |
| technique | No | Technique, e.g. "bemalt", "vergoldet", "geschnitzt". A term id ("type/…") or a German label, matched exactly except for case. | |
| exhibition | No | Exhibition id: only objects shown in it | |
| literature | No | Literature id: only objects it refers to | |
| attribution | No | Attribution qualifier, e.g. "zugeschrieben", "nach", "Kopie nach". Applies to the same creator row as `creator`. A term id ("type/…") or a German label, matched exactly except for case. | |
| object_type | No | Object type, e.g. "Zeichnung" or "Malerei". A term id ("type/…") or a German label, matched exactly except for case. | |
| creator_role | No | Role of the creator, e.g. "Künstler:in", "Verlag", "Stecher:in". Applies to the same creator row as `creator`. A term id ("type/…") or a German label, matched exactly except for case. | |
| acquired_from | No | Who SKKG acquired the object from: an actor id or a name, as for `creator` | |
| image_license | No | Licence of the object's primary image: "CC0 1.0", "CC BY 4.0", or "©". A term id ("type/…") or a German label, matched exactly except for case. | |
| acquisition_type | No | How SKKG acquired the object, e.g. "Auktion", "Ankauf", "Schenkung". A term id ("type/…") or a German label, matched exactly except for case. | |
| include_narrower | No | Term filters also match narrower terms, e.g. "Malerei" includes "Malerei auf Papier". Default true | |
| object_copyright | No | Copyright status of the object itself: "gemeinfrei" or "Copyright". A term id ("type/…") or a German label, matched exactly except for case. | |
| provenance_status | No | Provenance research status: "klar", "geklärt", or "ungeklärt". A term id ("type/…") or a German label, matched exactly except for case. | |
| acquisition_year_to | No | Latest year of SKKG's acquisition | |
| exclude_attributions | No | Attribution labels or ids; leaves out objects with a creator so attributed. With `creator`, `creator_role`, or `attribution`, only the creator row those match counts, e.g. ["nach", "Kopie nach"] for works by the creator rather than after them | |
| has_provenance_chain | No | Only objects with (true) or without (false) a provenance chain before SKKG | |
| acquisition_year_from | No | Earliest year of SKKG's acquisition |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | Yes | ||
| total | Yes | ||
| offset | Yes | ||
| results | Yes | ||
| has_more | Yes | ||
| returned | Yes | ||
| warnings | No | ||
| data_as_of | No | ||
| next_offset | No | ||
| applied_filters | No |