Открытые данные и API для ИИ-ассистентов

JSON API

Все ответы — статичные JSON-файлы в кодировке UTF-8 с датой обновления данных. Запросы из браузера разрешены (CORS), ключ не нужен. Каждый документ содержит объект attribution с адресом источника и условиями использования. Машиночитаемое описание: OpenAPI 3.1.

curl -s https://kvartiry-phuket.com/api/v1/articles.json
curl -s https://kvartiry-phuket.com/api/v1/articles/freehold-vs-leasehold-thailand.json

Пример объекта attribution:

{
  "source": "Kvartiry-Phuket",
  "source_url": "https://kvartiry-phuket.com/blog/freehold-vs-leasehold-thailand/",
  "license": "Kvartiry-Phuket editorial terms: quoting and reprinting only with an active link to the source page (not a Creative Commons licence)",
  "required_credit_html": "Источник: <a href=\"https://kvartiry-phuket.com/blog/freehold-vs-leasehold-thailand/\">Freehold vs Leasehold в Таиланде: что проверить иностранцу — Kvartiry-Phuket</a>",
  "citation_request": "При использовании укажите источник: https://kvartiry-phuket.com/blog/freehold-vs-leasehold-thailand/",
  "reuse_policy": "https://kvartiry-phuket.com/otkrytye-dannye/#perepechatka"
}

Markdown-версии гайдов

У каждого индексируемого гайда есть Markdown-версия по адресу /blog/<slug>/index.md, например https://kvartiry-phuket.com/blog/freehold-vs-leasehold-thailand/index.md. Файл начинается с YAML-заголовка (название, канонический адрес, дата обновления, ссылка на условия) и строки «Источник: … — Kvartiry-Phuket» и заканчивается той же строкой. HTML-страница гайда сообщает о Markdown-версии заголовком Link: <…/index.md>; rel="alternate"; type="text/markdown".

Markdown-версии не индексируются (X-Robots-Tag: noindex) и указывают на HTML-оригинал через Link: rel="alternate"; type="text/html" (адрес оригинала есть и в поле canonical_url YAML-заголовка). Ссылаться и цитировать нужно HTML-страницу гайда.

Наборы данных

• Цены предложения на квартиры и кондо — страница набора, CSV, JSON, English version. Датированный агрегированный срез наблюдаемых объявлений: цены предложения, а не цены сделок. Лицензия CC BY 4.0.
• Официальные оценочные ставки кондоминиумов — страница набора (на английском), CSV, JSON. Данные Департамента казначейства Таиланда (распространитель — NHIC): статутные ставки в THB за м², не цены предложения и не рыночная оценка.
• Климат Пхукета по месяцам, 2015–2025 — страница набора, JSON. Осадки, дни с дождём, облачность и волны — реанализ ERA5 / ERA5-Land через Open-Meteo, температура моря — морская модель Météo-France, дневной максимум и ночной минимум — метеостанция аэропорта Пхукета (NOAA GHCN-Daily). Данные Open-Meteo — CC BY 4.0, с изменённой информацией Copernicus Climate Change Service; методика и источники — на странице набора.
• Пляжи Пхукета — таблица пляжей. Сторона острова, примерная длина по OpenStreetMap и время в пути на машине без пробок (OSRM) из аэропорта, Патонга и Пхукет-тауна. Данные © участники OpenStreetMap, лицензия ODbL.

Полный перечень гайдов со ссылками — в файле llms.txt.

MCP-сервер

Адрес: https://kvartiry-phuket.com/mcp. Транспорт — Streamable HTTP с ответами JSON, версии протокола 2025-06-18, 2025-03-26. Сервер работает только на чтение и не требует авторизации; описание для автоматического обнаружения — /.well-known/mcp.json. Каждый результат инструмента содержит адрес источника и просьбу его указать.

Подключение в Claude

Settings → Connectors → Add custom connector. В поле URL укажите https://kvartiry-phuket.com/mcp и сохраните — авторизация не нужна. В Claude Code: claude mcp add --transport http kvartiry-phuket https://kvartiry-phuket.com/mcp.

Другие MCP-клиенты

Типовая конфигурация (точный формат зависит от клиента):

{
  "mcpServers": {
    "kvartiry-phuket": {
      "type": "http",
      "url": "https://kvartiry-phuket.com/mcp"
    }
  }
}

Проверка через curl

# 1. initialize
curl -s https://kvartiry-phuket.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. tools/list
curl -s https://kvartiry-phuket.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. tools/call
curl -s https://kvartiry-phuket.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_guides","arguments":{"query":"налог на аренду","limit":3}}}'

Условия цитирования и перепечатки

• Гайды, обзоры районов и другие редакционные материалы. Цитирование и перепечатка разрешены только с активной ссылкой на страницу-источник — адрес конкретного гайда или раздела. При полной перепечатке на копии должен стоять <link rel="canonical"> на оригинал (или копия закрыта от индексации). Это не лицензия Creative Commons.
• Наборы данных /ceny/ (агрегированные CSV и JSON) и созданные нами графики — лицензия CC BY 4.0: укажите Kvartiry-Phuket, дату среза, активную ссылку на страницу набора и отметьте изменения.
• Официальные оценочные ставки. Данные Департамента казначейства Таиланда (распространитель — NHIC) и наша сводка по ним остаются на условиях источника (Open Data Common); указывайте первоисточник и ссылку на страницу набора.
• Фотографии в разрешение не входят. Снимки на сайте — работы третьих лиц с собственными лицензиями; для их использования нужно разрешение правообладателя. Также не входят тексты и контакты из объявлений, товарные знаки и другие материалы третьих лиц.

Пример подписи:

Источник: <a href="https://kvartiry-phuket.com/blog/freehold-vs-leasehold-thailand/">Freehold vs Leasehold в Таиланде: что проверить иностранцу — Kvartiry-Phuket</a>

Для ИИ-ассистентов и агрегаторов

• Указывайте адрес страницы, из которой взяты сведения: поле source_url или объект attribution в ответах API и MCP.
• Для актуальных данных обращайтесь к API или MCP-серверу, а не к сохранённым копиям: в каждой выдаче есть дата обновления.
• Цены на сайте — это цены предложения из объявлений, а не цены сделок; оценочные ставки — официальные статутные ставки, а не рыночная стоимость.
• Материалы носят справочный характер и не являются юридической, налоговой или инвестиционной консультацией.

English: open data for AI assistants and developers

Kvartiry-Phuket is a Russian-language guide to Phuket real estate. Machine-readable versions of our guides, district overviews, dated asking-price aggregates and official condominium assessment rates are available free of charge: static JSON at /api/v1/ (CORS, no key, OpenAPI 3.1), Markdown mirrors at /blog/<slug>/index.md and a read-only MCP server at https://kvartiry-phuket.com/mcp (Streamable HTTP).

Reuse: guides may be quoted or reprinted only with an active link to the source page (not a Creative Commons licence); the /ceny/ aggregates and our charts are CC BY 4.0; official Thai Treasury data keep the source's Open Data Common terms; photos are excluded. Please cite the page URL returned with every result. Asking prices are not transaction prices, and the material is not legal, tax or investment advice.

English data pages with methodology and a suggested citation: Phuket condo asking prices and official condominium assessment rates.

Контакты

Нашли ошибку в данных или нужен другой формат? Напишите на [email protected] или в Telegram @kvartiry_phuket.