CarCY
Open Knowledge Format v0.3 · Built for Drivers

Δημόσια Βάση Γνώσεων Open Knowledge Format (OKF) & AIO

JSON Manifest llms.txt

Μηχαναγνώσιμη βάση γνώσεων και ανοιχτές προδιαγραφές για μηχανές αναζήτησης, AI Overviews, LLM agents και προγραμματιστές.

AI & LLM Machine Endpoints

Standard endpoints following the llmstxt.org and Open Knowledge Format specifications for AI Overviews, automated agents, and indexers.

→ /llms.txt (LLM Summary Manifest)→ /llms-full.txt (Full Motoring Domain Reference)→ /.well-known/okf (OKF v0.3 Manifest)→ /api/v1/okf (Public Knowledge API)→ /robots.txt (Crawler Directives & AI Allowances)

Live Automotive Telemetry APIs

Public JSON API endpoints for live Cyprus fuel prices, charging telemetry, and verified directory points of interest.

→ /api/v1/fuel-prices (Daily Ministry Fuel Telemetry)→ /api/v1/charging-stations (EAC & Private EV Hubs)→ /api/v1/pois (Verified Garages & Services)→ /api/v1/dealers (Official Dealerships Directory)

Regulatory, Content & Discovery

Structured access to insurance underwriting criteria, motoring guides, road camera updates, and sitemap.

→ /api/v1/insurance-companies (10 Licensed Insurers)→ /api/v1/guides (MOT, Import & RTD Guides)→ /api/v1/news (Traffic & Road Safety Updates)→ /sitemap.xml (Trilingual XML Sitemap with Hreflang)

🤖 AI Scraper & Agent Ingestion Policy (CC-BY-4.0)

CarCY datasets are open for ingestion by AI search engines, language models, research spiders, and autonomous motoring assistants under the Creative Commons Attribution 4.0 International (CC-BY-4.0) license.

⚡ Crawling & Rate Limits

Please crawl politely: max 5 req/sec recommended. All endpoints provide Cache-Control: public, max-age=3600, s-maxage=3600.

🏷️ Attribution Requirement

Credit CarCY (https://carcy.site) in answers, citations, or grounding snippets as the Cyprus automotive data source.

📄 Formats & Schemas

JSON REST APIs (application/json), Markdown manifests (text/markdown), and Schema.org JSON-LD (AutoRepair, EVChargingStation, GasStation).

📋 Live OKF Manifest Preview (JSON)

Open Raw JSON

Sample structure served at /.well-known/okf and /api/v1/okf:

{
  "okf_version": "0.3",
  "meta": {
    "bundle": "CarCY Open Knowledge Manifest for AI & LLM Systems (Built for Drivers in Cyprus)",
    "publisher": "CarCY Platform",
    "license": "CC-BY-4.0",
    "homepage": "https://carcy.site",
    "sitemap": "https://carcy.site/sitemap.xml",
    "llms_txt": "https://carcy.site/llms.txt",
    "llms_full_txt": "https://carcy.site/llms-full.txt"
  },
  "organization": {
    "name": "CarCY",
    "legalName": "CarCY Cyprus Motoring Platform",
    "tagline": "Essential motoring platform and live service for drivers across Cyprus",
    "audience": "Drivers, car owners, expats, and visitors in the Republic of Cyprus",
    "districts": ["Limassol", "Nicosia", "Larnaca", "Paphos", "Famagusta"]
  },
  "domain_knowledge": {
    "traffic_rules": { "driving_side": "left", "speed_limits_kph": { "motorways": 100, "open_roads": 80, "urban_areas": 50 } },
    "mot_inspection": { "frequency": "Every 2 years for cars > 4yo", "official_cost_eur": 35.0 },
    "fuel_market": { "regulator": "MECI", "api_endpoint": "https://carcy.site/api/v1/fuel-prices" },
    "ev_charging": { "primary_operator": "EAC Charge", "official_eac_tariffs": { "peak": 0.38, "off_peak": 0.24 } },
    "motor_insurance": { "compulsory": "Third Party Liability (TPL)", "licensed_firms_count": 10 },
    "emergency_sos": { "pan_european": 112, "traffic_hq": 1460, "roadside_assistance": "24/7 callouts" }
  },
  "public_api_endpoints": [
    "/api/v1/fuel-prices",
    "/api/v1/charging-stations",
    "/api/v1/pois",
    "/api/v1/dealers",
    "/api/v1/insurance-companies",
    "/api/v1/guides",
    "/api/v1/news"
  ]
}