takaros / nanocardspublic

TKR-SPEC · Version v1 · 2026-11-20

TKR specification v1

A TKR card describes one object that exists once, in a form an AI assistant can read. This page explains how the card is built. Anyone may create cards in this format. The status and the confirmation of a number come only from takaros.com.

The number

Every card has a fixed number that starts with TKR, followed by digits: TKR-1001. The number says nothing about the object and never changes, not even when the object moves or changes seller. The official form is the number with the address in front: takaros.com/TKR-1001. Anyone can write TKR-1001; it is only genuine if that address exists.

TKR-1001 takaros.com/TKR-1001

The header line

Every list of cards starts with one header line: the format version, the base address and the columns. Below it, one line per object, separated by a vertical bar. An empty field means: not stated by the seller.

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

Example with real cards.

The layers

An assistant steps down. Each step gives more, and costs more.

01InventoryCounts per type and colour, no individual objects.
02NanocardOne short line per object, to choose.
03MicrocardThe same line with more columns.
04Full cardEverything about one object, with the seller's link.
05StatusRight before answering: is it still there?

The columns

ColumnMeaningin nanocard
idCard number, starts with TKR-. Never changes.●
typeKind of object (fixed code).●
titleTitle as the seller writes it, shortened. The full title is on the full card.●
real1 = real full-size object, 0 = scale model or toy.
brandBrand or manufacturer, as the seller writes it.●
modelModel, as the seller writes it.●
designerDesigner or maker.●
year_or_periodYear, or a period such as 1980-1990.●
materialMaterial, as the seller states it.
quantityNumber of pieces in this single lot or listing.
hoursOperating hours (machinery).
hpPower in hp (machinery).
colorColour(s) as stated by the seller, comma-separated (fixed codes).●
trim_colorTrim colour, such as rims (fixed code).
statusSale type: for_sale, auction, after_sale (unsold at auction, still offered by the house), price_on_request or sold.
price_eurAsking price in euro, excluding VAT. Empty for an auction: the bid is on the seller's page.●
estimate_eurEstimate as the seller shows it, as a range.
countryCountry where the object is (ISO 3166-1 alpha-2).●
cityCity where the object is.
auction_planned_endPlanned end of the auction (ISO 8601). An auction can extend.

The codes

Type and colour are fixed English codes, so every assistant understands them, whatever language the user asks in.

Type: tractor, excavator, wheel_loader, forklift, chair, bar_stool, car, other Colour: yellow, green, red, blue, orange, white, black, grey Sale type: for_sale, auction, after_sale, price_on_request, sold Availability: available, not_available, unknown

The status

The status has three states: available, not_available and unknown. A report from the seller's status agent is valid for 6 hours. Without a new one, the status becomes unknown. Silence is never a yes. The source is given: agent (seen on the seller's own page, signed) or card (only what the card says).

id|availability|last_seen|source TKR-1001|available|2026-11-19T20:15:13Z|agent

Data rules

  • All facts come one to one from the seller. Takaros adds nothing.
  • Allowed: changing the form. A word becomes a code, inches become centimetres.
  • Not allowed: adding a judgement. A condition score, a statement about authenticity, an estimate the seller did not give.
  • An empty field means: not stated. Never guess.
  • The current bid of an auction is only on the seller's page.
  • What you put on your site never needs renewing. The verification code does not expire, and the name takaros-verificatie and the address /.well-known/tkr.json do not change. When a new version of the format arrives, the old one keeps being read at the same address; the version is in the file.

Publishing your stock

If you have your own website, you publish your stock yourself. Register your domain in the Search Console, prove it is yours with a DNS record, a file or a line in the head of your home page, and put your objects in /.well-known/tkr.json. Takaros fetches that file every hour. For each object you give your own id, the link to its page on your site, the type, the availability and the country. Every other attribute goes into attributes: name and value as you write them, optionally with a fixed key, a number and a unit. There is no limit to what you can state, and every attribute is searchable.

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

Go to the Search Console

Endpoints

Connection for assistants (MCP), search over HTTP, the status card, the guide and this specification as data.

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