skkg_find_terms
skkg_find_termsFind SKKG vocabulary terms by label prefix to retrieve filter values, IDs, hierarchy paths, usage counts, and applicable search filters.
Instructions
Find terms of SKKG's vocabularies by label, to use as filter values. Labels are German; English and French labels match where SKKG has them. Each word matches the start of a word in a label ("Radier" finds "Radierung"). Terms in use come first; among them, exact label matches, then the terms used most. Each term carries its id, its path in the hierarchy, its year range (epochs), its matches in GND, AAT, or Wikidata, how many objects use it (an image licence: objects whose primary image has it), and filters: every search parameter that takes it, each with its tool and the total that filter reports for the term (skkg_search_objects; skkg_search_provenance for the vocabularies of provenance periods; skkg_search_actors for gender, and for a country code both nationality and place_country; skkg_search_literature for literature types; skkg_search_exhibitions for the types, status, and "intern" or "extern" of exhibitions). Many vocabularies have no filter. Currency terms have none either: currency of skkg_search_provenance takes the codes of the prices ("CHF", "DEM") and SKKG's labels of them. With id, returns one term with its broader and narrower terms. With only vocabulary, lists that vocabulary. To search objects, use skkg_search_objects; its term filters take these labels or ids directly.
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_find_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A term id ("type/21087/140347") or its data.skkg.ch IRI: returns that term with its broader and narrower terms | |
| 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 |
| limit | No | Terms per page; with `id`, narrower terms per page | |
| query | No | Label words, e.g. "Radierung" or "Silber"; each matches as a prefix. 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 | |
| offset | No | ||
| vocabulary | No | Restrict to one vocabulary: object_type (object types, hierarchical ("Malerei" > "Ölmalerei")); material (materials, hierarchical); technique (techniques); epoch (epochs, with a year range); production_role (roles of creators ("Künstler:in", "Verlag")); attribution (attribution qualifiers ("zugeschrieben", "nach")); acquisition_type (how SKKG acquired an object); object_copyright (copyright status of objects); image_license (image licences); provenance_status (provenance research status); redaction_status (documentation status of records); date_basis (what a dating rests on ("datiert", "Expertise Fachperson")); condition (condition of objects ("Stabil", "Gut")); object_reference_type (kinds of links between objects); owner_type (kinds of owner in provenance periods); certainty (certainty of provenance periods); holding_kind (kinds of holding (ownership, custody)); transaction_type (how an owner acquired an object); source_type (sources of provenance periods); date_qualifier (qualifiers of provenance dates ("vor", "nach")); currency (currencies of prices); literature_type (kinds of publication); literature_place (places of publication, hierarchical); author_role (roles of authors of publications); exhibition_type (kinds of exhibition); exhibition_status (status of exhibitions); internal_external (SKKG's "intern" or "extern" for exhibitions); gender (gender of persons); country (countries, e.g. nationalities of persons). Default all, which includes SKKG's unnamed schemes | all |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | The term asked for with `id` | |
| total | Yes | ||
| offset | Yes | ||
| applied | Yes | ||
| broader | No | With `id`: the broader terms, top-level first | |
| results | No | The terms found; absent with `id` | |
| has_more | Yes | ||
| narrower | No | With `id`: the narrower terms, most used first; `total` counts them | |
| returned | Yes | ||
| warnings | No | ||
| data_as_of | No | ||
| next_offset | No |