takaros / nanocardsopenbaar

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-1001

De 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||NL

Voorbeeld met echte kaarten.

De lagen

Een assistent daalt af in stappen. Elke stap geeft meer, en kost meer.

01OverzichtAantallen per soort en kleur, geen losse objecten.
02NanocardEén korte regel per object, om te kiezen.
03MicrocardDezelfde regel met meer kolommen.
04Volledige kaartAlles over één object, met de link naar de aanbieder.
05StatusVlak voor het antwoord: is het er nog?

De kolommen

KolomBetekenisin nanocard
idKaartnummer, begint met TKR-. Verandert nooit.●
typeSoort object (vaste code).●
titleTitel zoals de aanbieder hem schrijft, ingekort. De volledige titel staat op de volledige kaart.●
real1 = echt object op ware grootte, 0 = schaalmodel of speelgoed.
brandMerk of fabrikant, zoals de aanbieder het schrijft.●
modelModel, zoals de aanbieder het schrijft.●
designerOntwerper of maker.●
year_or_periodBouwjaar, of een periode zoals 1980-1990.●
materialMateriaal, zoals de aanbieder het opgeeft.
quantityAantal stuks in dit ene kavel of deze ene advertentie.
hoursDraaiuren (machines).
hpVermogen in pk (machines).
colorKleur(en) volgens de aanbieder, gescheiden door komma's (vaste codes).●
trim_colorBijkleur, zoals velgen (vaste code).
statusVerkoopvorm: for_sale, auction, after_sale (onverkocht op de veiling, nog te koop bij het huis), price_on_request (prijs op aanvraag) of sold.
price_eurVraagprijs in euro, exclusief btw. Leeg bij een veiling: het bod staat bij de aanbieder.●
estimate_eurSchatting zoals de aanbieder die toont, als bereik.
countryLand waar het object staat (ISO 3166-1 alpha-2).●
cityPlaats waar het object staat.
auction_planned_endGeplande 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, unknown

De 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|agent

Regels 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" } ] } ] }

Naar de Search Console

Ingangen

Koppeling voor assistenten (MCP), zoeken via HTTP, de statuskaart, de wegwijzer en deze specificatie als gegevens.

MCPhttps://www.takaros.com/kaart/mcp
HTTPhttps://www.takaros.com/kaart/zoek?kleur=geel&vorm=regels
Statushttps://www.takaros.com/kaart/status?ids=TKR-1001,TKR-1002
llms.txthttps://www.takaros.com/llms.txt
spec.jsonhttps://www.takaros.com/spec.json