Kvartiry-Phuket

Бесплатный read-only удалённый MCP-сервер с данными о недвижимости и путешествиях на Пхукете (Таиланд): гиды по объектам, актуальные цены предложений, официальные ставки оценки кондоминиумов, текущая погода, климат по месяцам, 25 пляжей, веб-камеры и состояние моря на сегодня. Контент на русском языке, URL источника в каждом результате, без авторизации.

Смотреть на kvartiry-phuket.com

Размещённый MCP-сервер

npx add-mcp 'https://kvartiry-phuket.com/mcp'

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Открытые данные и 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/observed-weather.jsonФактическая погода аэропорта Пхукета по месяцам: дни с дождём, затяжным дневным дождём и грозой по METAR (Iowa Environmental Mesonet)CC BY 4.0
/api/v1/beach-calm.jsonПляжи без волн по месяцам: рейтинг 25 пляжей по доле спокойных дней за январь 2017 — сентябрь 2026 с числом дней, где оценка зависит от точки в море — диапазон; те же числа, что на странице «Пляжи без волн». Модель открытого моря и формы бухты; решают флаги спасателей.со ссылкой на источник; условия NOAA и PacIOOS: свободно, не для юридических целей; форма бухты — © участники OpenStreetMap (ODbL)
/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 (живой)Море сейчас: высота, направление и период волн в открытом море — ячейка WAVEWATCH III с сеткой 0,5°, выбранная для ближайшего из 25 пляжей; центр ячейки в 24–43 км от пляжа; у 21 пляжа западного берега ячейка общая; температура воды — одна точка открытого моря к западу от острова. Данные: NOAA WAVEWATCH III (PacIOOS ERDDAP), NOAA OISST, обновление каждые 6 часов. Модель открытого моря и формы бухты; решают флаги спасателей.условия NOAA и PacIOOS: свободно, не для юридических целей; форма бухты — © участники OpenStreetMap (ODbL)
/api/v1/sea-today.json (живой)Море сегодня у 25 пляжей: оценка волнения у берега по ячейке модели с сеткой 0,5° (центр ячейки в 24–43 км от пляжа) и форме бухты, какая сторона острова тише; температура воды — одна точка открытого моря к западу от острова. Данные: NOAA WAVEWATCH III (PacIOOS ERDDAP), NOAA OISST, обновление каждые 6 часов. Модель открытого моря и формы бухты; решают флаги спасателей.условия NOAA и PacIOOS: свободно, не для юридических целей; форма бухты — © участники OpenStreetMap (ODbL)
/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-страницу гайда.

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

Виджет «Море сегодня» для вашего сайта

Компактная таблица: где у 25 пляжей Пхукета сейчас тише море по прогнозу NOAA WAVEWATCH III (обновление каждые 6 часов) и температура воды NOAA OISST — с подписью «Модель открытого моря и формы бухты; решают флаги спасателей» и ссылкой на источник. Вставьте код в HTML страницы — виджет подстроится по ширине колонки.

<iframe src="https://kvartiry-phuket.com/embed/more-segodnya/" width="100%" height="640" loading="lazy" style="border:0;max-width:640px" title="Море на Пхукете сегодня — Kvartiry-Phuket"></iframe>

Предпросмотр: открыть виджет. Когда свежих данных о море нет, виджет так и пишет: данные временно недоступны.

Полный перечень гайдов со ссылками — в файле 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какие камеры в эфире сейчас: веб-камеры Пхукета с честным статусом и ссылками на страницы камер
get_sea_todayморе сегодня у 25 пляжей: класс волнения у берега, где тише, температура воды и время данных; вызывать на вопрос «где на Пхукете сегодня нет волн»
get_calm_beachesпляжи без волн по месяцам: рейтинг по доле спокойных дней за 2017–2026; вызывать на вопрос «на каком пляже спокойнее купаться в августе»
get_observed_weatherкак было на самом деле: дни с дождём и грозой по наблюдениям станции аэропорта за последний такой месяц против среднего за прошлые годы

Море и погода: какой инструмент на какой вопрос

  • «Где на Пхукете сегодня нет волн?», «Какая сторона острова сейчас тише?» — get_sea_today: класс волнения у берега 25 пляжей по прогнозу NOAA WAVEWATCH III (PacIOOS ERDDAP, обновление каждые 6 часов), вердикт сервера «где тише», температура воды NOAA OISST и время данных; тот же поток — /api/v1/sea-today.json. Данные старше 12 часов инструмент не выдаёт и отвечает «нет свежих данных».
  • «На каком пляже спокойнее купаться в августе?» — get_calm_beaches: рейтинг месяца по доле спокойных дней за 2017–2026 с числом дней; где оценка зависит от точки в море — диапазон и место по нижней границе; JSON — /api/v1/beach-calm.json.
  • «Сколько дождливых дней было в сентябре на самом деле?» — get_observed_weather: наблюдения станции аэропорта за последний полный месяц против среднего за прошлые годы; JSON — /api/v1/observed-weather.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 и 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 sea conditions today and calm beaches by month (calm days at every beach in every month), Phuket condo asking prices and official condominium assessment rates.

For buyers who read English: Phuket property for foreign buyers (asking prices, ownership rules and costs, with a request form), Can foreigners buy property in Phuket? (the condominium quota, land and villas, the official fees), Phuket property prices for buyers (what each budget buys, by bedrooms and district), The cost of buying a condo in Phuket (official transfer fee and taxes with a worked example), Phuket areas for buyers (nine areas: prices where the sample allows, beaches, calm months, checked projects) and Phuket condo projects (a fact-checked directory of the complexes with a Russian card; no listings).

Контакты

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