TKR-SPEC · Versie v1 · 2026-11-20
TKR-specificatie v1
Een TKR-kaart beschrijft één object dat één keer bestaat, in een vorm die een AI-assistent kan lezen. Deze pagina legt uit hoe de kaart in elkaar zit. Iedereen mag kaarten in dit formaat maken. De status en de bevestiging van een nummer komen alleen van takaros.com.
Het nummer
Elke kaart heeft een vast nummer dat begint met TKR, gevolgd door cijfers: TKR-1001. Het nummer zegt niets over het object en verandert nooit, ook niet als het object verhuist of van verkoper wisselt. De officiële vorm is het nummer met het adres ervoor: takaros.com/TKR-1001. Iedereen kan TKR-1001 opschrijven; echt is het alleen als dat adres bestaat.
TKR-1001
takaros.com/TKR-1001De kopregel
Elke lijst kaarten begint met één kopregel: de versie van het formaat, het basisadres en de kolommen. Daaronder één regel per object, gescheiden door een verticale streep. Een leeg veld betekent: niet opgegeven door de aanbieder.
TKR-SPEC: v1 | BASE: https://takaros.com/ | SCHEMA: id|type|title|brand|model|designer|year_or_period|color|price_eur|country
TKR-1001|bar_stool|Matteo Grassi - Tito Agnoli - Kruk (3) - Leder|Matteo Grassi||Tito Agnoli|1980-1990|yellow||NL
TKR-1002|chair|Matteo Grassi - Tito Agnoli - Stoel (2) - Leder|Matteo Grassi||Tito Agnoli|1980-1990|yellow||NL
TKR-1003|chair|Lammhults - Johannes Foersom & Peter Hiort-Lorenzen - Stoel (3) - Campus - Hout…|Lammhults|Campus|Johannes Foersom & Peter Hiort-Lorenzen|1990-2000|grey,orange,red||NLVoorbeeld met echte kaarten.
De lagen
Een assistent daalt af in stappen. Elke stap geeft meer, en kost meer.
| 01 | Overzicht | Aantallen per soort en kleur, geen losse objecten. |
| 02 | Nanocard | Eén korte regel per object, om te kiezen. |
| 03 | Microcard | Dezelfde regel met meer kolommen. |
| 04 | Volledige kaart | Alles over één object, met de link naar de aanbieder. |
| 05 | Status | Vlak voor het antwoord: is het er nog? |
De kolommen
| Kolom | Betekenis | in nanocard |
|---|---|---|
| id | Kaartnummer, begint met TKR-. Verandert nooit. | ● |
| type | Soort object (vaste code). | ● |
| title | Titel zoals de aanbieder hem schrijft, ingekort. De volledige titel staat op de volledige kaart. | ● |
| real | 1 = echt object op ware grootte, 0 = schaalmodel of speelgoed. | |
| brand | Merk of fabrikant, zoals de aanbieder het schrijft. | ● |
| model | Model, zoals de aanbieder het schrijft. | ● |
| designer | Ontwerper of maker. | ● |
| year_or_period | Bouwjaar, of een periode zoals 1980-1990. | ● |
| material | Materiaal, zoals de aanbieder het opgeeft. | |
| quantity | Aantal stuks in dit ene kavel of deze ene advertentie. | |
| hours | Draaiuren (machines). | |
| hp | Vermogen in pk (machines). | |
| color | Kleur(en) volgens de aanbieder, gescheiden door komma's (vaste codes). | ● |
| trim_color | Bijkleur, zoals velgen (vaste code). | |
| status | Verkoopvorm: for_sale, auction, after_sale (onverkocht op de veiling, nog te koop bij het huis), price_on_request (prijs op aanvraag) of sold. | |
| price_eur | Vraagprijs in euro, exclusief btw. Leeg bij een veiling: het bod staat bij de aanbieder. | ● |
| estimate_eur | Schatting zoals de aanbieder die toont, als bereik. | |
| country | Land waar het object staat (ISO 3166-1 alpha-2). | ● |
| city | Plaats waar het object staat. | |
| auction_planned_end | Geplande sluiting van de veiling (ISO 8601). Een veiling kan verlengen. |
De codes
Soort en kleur zijn vaste Engelse codes, zodat elke assistent ze begrijpt, in welke taal de gebruiker ook vraagt.
Soort: tractor, excavator, wheel_loader, forklift, chair, bar_stool, car, other
Kleur: yellow, green, red, blue, orange, white, black, grey
Verkoopvorm: for_sale, auction, after_sale, price_on_request, sold
Beschikbaarheid: available, not_available, unknownDe status
De status heeft drie standen: available, not_available en unknown. Een melding van de statusagent van de aanbieder geldt 6 uur. Komt er geen nieuwe, dan wordt de status unknown. Stilte is nooit een ja. De bron staat erbij: agent (gezien op de eigen pagina van de aanbieder, ondertekend) of card (alleen wat de kaart zegt).
id|availability|last_seen|source
TKR-1001|available|2026-11-19T20:15:13Z|agentRegels voor de gegevens
- Alle feiten komen één op één van de aanbieder. Takaros voegt niets toe.
- Wel toegestaan is de vorm veranderen: een woord wordt een code, inches worden centimeters.
- Niet toegestaan is een oordeel toevoegen: een conditiescore, een uitspraak over echtheid, een schatting die de aanbieder niet gaf.
- Een leeg veld betekent: niet opgegeven. Nooit raden.
- Het actuele bod van een veiling staat alleen bij de aanbieder.
- Wat je op je site zet, hoef je nooit te vernieuwen. De bewijscode verloopt niet, en de naam takaros-verificatie en het adres /.well-known/tkr.json veranderen niet. Komt er een nieuwe versie van het formaat, dan blijft de oude gelezen worden op hetzelfde adres; de versie staat in het bestand.
Je aanbod publiceren
Heb je een eigen website, dan publiceer je je aanbod zelf. Meld je domein aan in de Search Console, bewijs met een DNS-record, een bestand of een regel in de kop van je homepage dat het van jou is, en zet je objecten in /.well-known/tkr.json. Takaros haalt dat bestand elk uur op. Per object geef je een eigen id, de link naar de pagina op je site, de soort, de beschikbaarheid en het land. Alle andere kenmerken zet je in attributes: naam en waarde zoals jij ze schrijft, met desgewenst een vaste sleutel, een getal en een eenheid. Er is geen bovengrens aan wat je opgeeft, en op elk kenmerk kan gezocht worden.
https://<domein>/.well-known/tkr.json
{ "spec": "TKR-SPEC", "version": "v1", "seller": { "name": "..." },
"items": [ { "id": "...", "url": "https://<domein>/...", "title": "...",
"type": "car", "availability": "available", "country": "NL",
"attributes": [ { "name": "Cilinderinhoud", "value": "2998 cc", "key": "engine_cc", "number": 2998, "unit": "CMQ" } ] } ] }Ingangen
Koppeling voor assistenten (MCP), zoeken via HTTP, de statuskaart, de wegwijzer en deze specificatie als gegevens.