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-1001The 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||NLExample with real cards.
The layers
An assistant steps down. Each step gives more, and costs more.
| 01 | Inventory | Counts per type and colour, no individual objects. |
| 02 | Nanocard | One short line per object, to choose. |
| 03 | Microcard | The same line with more columns. |
| 04 | Full card | Everything about one object, with the seller's link. |
| 05 | Status | Right before answering: is it still there? |
The columns
| Column | Meaning | in nanocard |
|---|---|---|
| id | Card number, starts with TKR-. Never changes. | ● |
| type | Kind of object (fixed code). | ● |
| title | Title as the seller writes it, shortened. The full title is on the full card. | ● |
| real | 1 = real full-size object, 0 = scale model or toy. | |
| brand | Brand or manufacturer, as the seller writes it. | ● |
| model | Model, as the seller writes it. | ● |
| designer | Designer or maker. | ● |
| year_or_period | Year, or a period such as 1980-1990. | ● |
| material | Material, as the seller states it. | |
| quantity | Number of pieces in this single lot or listing. | |
| hours | Operating hours (machinery). | |
| hp | Power in hp (machinery). | |
| color | Colour(s) as stated by the seller, comma-separated (fixed codes). | ● |
| trim_color | Trim colour, such as rims (fixed code). | |
| status | Sale type: for_sale, auction, after_sale (unsold at auction, still offered by the house), price_on_request or sold. | |
| price_eur | Asking price in euro, excluding VAT. Empty for an auction: the bid is on the seller's page. | ● |
| estimate_eur | Estimate as the seller shows it, as a range. | |
| country | Country where the object is (ISO 3166-1 alpha-2). | ● |
| city | City where the object is. | |
| auction_planned_end | Planned 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, unknownThe 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|agentData 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" } ] } ] }Endpoints
Connection for assistants (MCP), search over HTTP, the status card, the guide and this specification as data.