Yevgen`s official homepage
Yevgen Somochkin
"ΞΣΣΘ"
CTO ESSO.DEV
Building the Future of AI, Automation & Web3 | Full-stack & DevOps Architect | Scalable, Data-driven Web & Mobile Apps
Hamburg, Germany
A shared vocabulary for what a business is
Every discovery platform reinvents its own category list, and no two of them agree — which is how Friseursalon, hair salon and
shop=hairdresserThe classification layer under Mapko and Botkontor was pulled out into its own repo, licensed MIT and published as a standard, instead of staying a table in one company's database.
NACE Rev.2 (Eurostat) as the statistical backbone, OpenStreetMap tags as the community vocabulary, Schema.org LocalBusiness subtypes for markup, Wikidata QIDs as cross-lingual anchors. Nothing was copied from Google, Yelp or Foursquare — deliberately, because the point is that anyone can use this without asking permission from anyone.
23 root categories → 353 subcategories → 1,333 service templates, each with names and synonyms in EN / UK / DE / RU. Templates carry typed attributes (price, duration, enums), an OSM tag at the most specific level that actually applies, and trigger/anti-trigger hints an LLM classifier can use to tell a neighbouring service apart from the one it is looking at.
Real Linked Data: SKOS concepts in JSON-LD, one file per node, 1,711 dereferenceable @ids under taxonomy.mapko.net/v1/ served as application/ld+json, with a sitemap so crawlers can find them. Follow an @id and you get the node, not a 404.
Shared vocabulary on top, a public business graph in the middle, and per-tenant private memory underneath that never leaves its tenant. Mapko and Botkontor are the first consumers; the vocabulary is deliberately not theirs alone.