skkg_search_actors
skkg_search_actorsFind SKKG records for persons and groups by name, dates, places, roles, gender, nationality, and collection link; results show each actor's role counts.
Instructions
Search the persons and groups SKKG records, by name, dates, places and roles. Groups are firms, institutions, and families. Filters: query (names, including alternative names and GND names), kind, years of birth and death (for a group: formation and dissolution), the place or country of those events, gender, nationality, how the actor is linked to the collection (role_in_collection), and whether a GND or Wikidata id is recorded. Each result lists its roles with their counts. SKKG's anonymisation ("Privatperson", "Unbekannte:r Eigentümer:in") is never a result: never try to identify those persons. Actors SKKG records only by name, most of them authors, editors, and publishers of literature, are not listed; name_only counts those that match and names a few, each with the skkg_search_literature calls that list their publications (publisher for what it published, author for what it wrote or edited; one call each). For one actor's full record, with their objects and literature, use skkg_get_record with its id; for the objects of a creator, skkg_search_objects with creator; for labels of gender and the country codes, skkg_find_terms.
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_actors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | person, or group (a firm, institution, or family) | |
| 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 (the default with `query`), name (the default without), born_asc or born_desc (by the year of birth or formation; actors without it last) | |
| limit | No | Actors per page. Default 10 | |
| place | No | Place of birth, death, formation, or dissolution, as SKKG writes it, e.g. "Zürich", "Genf", "Paris". Each word matches the start of a word, ignoring case and accents; applied_filters lists the places matched | |
| query | No | Name: matched against all of the actor's names at once, so the words may come from different ones, e.g. "Anker", "Albert Anker", "Koll*". 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 | |
| gender | No | Gender, as SKKG records it, e.g. "männlich", "weiblich", or "unbekannt". A term id ("type/…") or a German label, matched exactly except for case. | |
| offset | No | ||
| born_to | No | Latest year of birth or formation; see born_from | |
| died_to | No | Latest year of death or dissolution; see died_from | |
| born_from | No | Earliest year of birth, or of a group's formation. Actors without that year never match | |
| died_from | No | Earliest year of death, or of a group's dissolution. Actors without that year never match | |
| nationality | No | Nationality, as an ISO country code, e.g. "CH", "DE", "FR", "IT". SKKG records a dual nationality as a term of its own, e.g. "CH/DE", which "CH" does not match. A term id ("type/…") or a German label, matched exactly except for case. | |
| has_authority | No | true: SKKG records a GND or Wikidata id for the actor; false: neither | |
| place_country | No | Country of the place of birth, death, formation, or dissolution, as SKKG records it: an ISO country code, e.g. "CH", "DE", "FR". A term id ("type/…") or a German label, matched exactly except for case. | |
| role_in_collection | No | How the actor is linked to the collection: creator (made objects), influence (objects were made after them or under their influence), acquired_from (SKKG acquired objects from them), provenance_owner (owned objects before SKKG), photographer or photo_right_holder (of published images), author, editor, or publisher (of literature), subject_of_literature |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | Yes | ||
| total | Yes | Persons and groups that match | |
| offset | Yes | ||
| results | Yes | ||
| has_more | Yes | ||
| returned | Yes | ||
| warnings | No | ||
| name_only | No | Actors SKKG records only by name that meet the same filters; they are not listed. examples gives up to five distinct names, each with one id for skkg_get_record and, for authors, editors, and publishers, its literature_filters | |
| data_as_of | No | ||
| next_offset | No | ||
| applied_filters | No |