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

Kvartiry-Phuket — русскоязычный справочник по недвижимости Пхукета. Здесь собраны машиночитаемые версии наших материалов: гайды, обзоры районов, датированные цены предложения и официальные оценочные ставки. Доступ бесплатный, регистрация и ключ не нужны. Используя данные, указывайте источник с активной ссылкой на страницу.

JSON API

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

АдресЧто внутриУсловия
/api/v1/index.jsonКаталог эндпоинтов, правила атрибуции, ссылки на OpenAPI и MCP—
/api/v1/articles.jsonИндексируемые гайды: заголовок, описание, рубрика, даты, разделы, ссылка на Markdownсо ссылкой на источник
/api/v1/articles/{slug}.jsonОдин гайд: вступление, разделы H2 со ссылками на фрагменты, вопросы FAQ, атрибуциясо ссылкой на источник
/api/v1/districts.jsonРайоны из раздела «Районы Пхукета»: расположение, инфраструктура, плюсы и минусысо ссылкой на источник
/api/v1/faq.jsonВопросы и ответы со страниц сайта: вопрос, ответ, URL источника, dateModifiedсо ссылкой на источник
/api/v1/climate.jsonКлиматические нормы Пхукета по месяцам за 2015–2025 (ERA5, море, станция аэропорта)CC BY 4.0
/api/v1/beaches.jsonПляжи Пхукета: сторона острова, длина, дорога из аэропорта, инфраструктура рядомODbL (© участники OpenStreetMap)
/api/v1/live-cams.jsonВеб-камеры Пхукета с честным статусом эфира из ежедневного чекерасо ссылкой на источник
/api/weather-now (живой)Погода на Пхукете сейчас и прогноз на 24 часа и до 10 дней (MET Norway); описание — /api/v1/weather-now.jsonCC BY 4.0
/api/sea-now (живой)Море сейчас: высота, направление и период волн, температура воды (Open-Meteo Marine)CC BY 4.0
/api/v1/prices.jsonДатированный срез цен предложения (asking prices) с методикой и размером выборкиCC BY 4.0
/api/v1/condo-assessment.jsonОфициальные оценочные ставки Казначейства Таиланда по кондоминиумам — не рыночная ценаусловия источника (Open Data Common)
/api/v1/openapi.jsonОписание API и MCP-эндпоинта в формате 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 и 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-страницу гайда.

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

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

MCP-сервер

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

ИнструментЧто возвращает
search_guidesпоиск по опубликованным гайдам: заголовок, URL, описание и дата обновления
get_guideгайд по slug: вступление и список разделов; с параметром section — текст раздела
list_districtsсписок районов с обзорными страницами и URL
get_districtобзор района: расположение, инфраструктура, плюсы и минусы, связанные гайды
get_asking_pricesдатированный срез цен предложения (asking prices) с размером выборки, в том числе по району
get_condo_assessmentофициальные оценочные ставки Казначейства Таиланда по кондоминиумам (не рыночная цена)
get_weather_nowпогода на Пхукете сейчас и прогноз MET Norway на 24 часа и до 10 дней
get_climateклиматические нормы Пхукета по месяцам за 2015–2025; параметр month — один месяц
search_faqпоиск по вопросам и ответам сайта со ссылками на страницы-источники
search_beachesпоиск по сравнению пляжей Пхукета: сторона острова, длина, инфраструктура
list_webcamsвеб-камеры Пхукета с честным статусом и ссылками на страницы камер

Подключение в 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 и leasehold в Таиланде: что это и какие права у иностранца — Kvartiry-Phuket</a>

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

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

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 weather by month (rain, sea temperature and air), Phuket beaches compared (coast side, length and drive times), Phuket condo asking prices and official condominium assessment rates.

Контакты

Нашли ошибку в данных или нужен другой формат? Напишите на hello@kvartiry-phuket.com или в Telegram @kvartiry_phuket.

Telegram