Evan-Crx/permisapi-mcp

Сопоставляет список, предоставленный пользователем (макс. 1000 строк), с разрешениями на строительство во Франции, чтобы получить за 1 запрос: разрешения рядом + оценку перспективности + риски + зонирование + кадастровый участок. Только для плана Business+, стоимость = 1 единица квоты на строку. Сценарий использования: обогатить список лидов/объектов недвижимости. 3 режима на строку: (широта+долгота) или (адрес) или (коммуна+секция+номер). Поле 'ref' идентифицирует каждую строку в ответе.

Возвращает top N транзакций недвижимости DVF, соседних с разрешением (12 скользящих лет: объединённые Geo-DVF Etalab 2021-2025 + Cerema DVF+ 2014-2020). Поведение: вызывает GET /v1/permits/{num_pa}/dvf, который выполняет пространственное соединение через координаты GPS разрешения и возвращает прошлые продажи близких объектов с их ценой, датой, типом (дом/квартира/зависимость/коммерческое помещение), площадью, количеством комнат и расстоянием в метрах. Фильтрует на стороне сервера транзакции < 1000 EUR (пожертвования DGFiP). Новый спринт 15: полезная нагрузка теперь содержит dvf_median_price_per_m2 (сырая медиана в EUR/м², вычисленная по возвращённым совпадениям после фильтров) и dvf_median_sample_size (размер выборки, может быть меньше len(matches), если некоторые продажи - это пустые участки или имеют отсутствующую площадь). Полезно для прямого ответа на вопрос «какая цена за м² в этом районе?» без пересчёта на стороне клиента. Цель: оценить цену за м² в районе для торговца недвижимостью, откалибровать предложение о покупке, проверить согласованность DVF с заявленной ценой. Рекомендация по использованию: limit=3 обычно достаточно для быстрой проверки; limit=5 для более устойчивого среднего. Фильтр type_local=1,2 для исключения зависимостей/коммерческих помещений, если пользователь нацелен на жилую недвижимость. Стоимость: 1 единица квоты. Только план Pro+ (Free/Explorer получают 402).

Выполняет нечёткий поиск по свободному тексту адресов (улица, город, населённый пункт). Использует pg_trgm на стороне БД: нечувствителен к диакритическим знакам и регистру, устойчив к опечаткам. Идеален для поиска разрешения, когда известен приблизительный адрес, но неизвестны точный почтовый индекс или код коммуны INSEE. Все планы (с учётом географического охвата). Стоимость квоты = количество возвращённых результатов (макс. limit, мин. 1). Защита от утечки данных с 2026-05-16 (согласуется с search_permits). Пример: 'rue victor hugo paris', 'cours de l ile bordeaux'.

Макрос статистики городской плотности для одной коммуны за один вызов: количество кадастровых участков DGFiP + общая площадь + количество кадастровых зданий (капитальные / лёгкие / прочие) + количество исторических разрешений на строительство 2014-2026 с разбивкой по годам, по типу (PC_LOGEMENT, PC_LOCAUX, PA, PD, DP) и по распределению Score MDB v0.3 (low / medium / high / premium) + показатель плотности (зданий на км² + категория tres_dense / dense / moyen / faible). Варианты использования: программное SEO для 35 000 коммун по всей Франции, макроаналитика для торговцев недвижимостью / застройщиков / банков при мониторинге рынка, сравнение зон перед принятием земельного решения. Автоматическое сопоставление PLM: для округов Парижа (75101-75120), Лиона (69381-69389), Марселя (13201-13216) разрешения Sitadel, хранящиеся на материнском городе, агрегируются автоматически. Только тариф Business+ (агрегированная BI, не подпадает под географический охват Free/Explorer). Стоимость квоты: 3 составные единицы. Источники: cadastre.data.gouv.fr Etalab + Sitadel SDES.

Местные строительные компании вокруг разрешения: «кто электрики / сантехники / каменщики в радиусе X км от этой стройки?». Нативная интеграция с get_economics: для каждой позиции breakdown_by_lot (общестроительные работы, сантехника, электрика и т.д.) передаёт коды NAF этой позиции в данный инструмент для поиска местных квалифицированных компаний. Поведение: вызывает GET /v1/permits/{num_pa}/contractors, который опрашивает базу SIRENE INSEE с фильтром по кодам NAF 41/42/43 (BTP), загружаемую ежемесячно, 1 086 952 активных заведений во Франции, из которых 830 860 геолоцированы в WGS84 (76,4% покрытия). Поиск через PostGIS ST_DWithin по официальным координатам Lambert93, конвертированным в WGS84. Сортировка по возрастанию расстояния. Пагинация через has_more. Опциональные фильтры: (1) naf_codes CSV (например, 43.21A,43.21B электрика), ограниченный кодами 41/42/43 BTP, принимает компактный формат 4321A; (2) radius_m от 500 до 50 000 м (по умолчанию 5 000 м); (3) limit 1-100 (по умолчанию 20); (4) effectif_min нижняя граница диапазона численности INSEE (по умолчанию 0 = все размеры); (5) include_inactive булев (по умолчанию false = только административно активные). Возвращает для каждой компании: siren / siret / raison sociale / enseigne / код NAF + наименование / признак головного офиса да-нет / диапазон численности (00-53 INSEE) + границы числа сотрудников / стаж в годах / полный адрес / населенный пункт / расстояние в метрах. Кейс использования для торговцев недвижимостью / PropTech / застройщиков: «я нашёл разрешение в Париже, кто электрики с кодом NAF 43.21A в радиусе 5 км с числом сотрудников не менее 10?». Стоимость: 5 единиц составной квоты (защита от злоупотреблений). Только тариф Pro+ (Free / Explorer получают 402). 422, если разрешение не геолоцировано или коды NAF вне области BTP.

Оценивает бюджет строительства по разрешению: «сколько будет стоить этот проект?» с нижней / средней / верхней границей (EUR), детализацией на м², определяемым сценарием (новое строительство, капитальный / косметический ремонт, снос, благоустройство). Поведение: вызывает GET /v1/permits/{num_pa}/economics, который объединяет 3 источника: (1) заявленные застройщиком площади в разрешении Sitadel (SURF_HAB_CREEE + SURF_LOC_CREEE + преобразования) с резервным соотношением на участок, если они отсутствуют; (2) статический тариф, калиброванный по публичным данным Capeb / FFB / Anjou Construction 2024 (стоимость за м² по типу проекта, с поправкой на департамент: Париж +25%, Лазурный Берег +20%, региональные метрополии +5%; и по размеру: микрообъекты +20%, крупные программы -15%); (3) официальный модулятор INSEE ICP-BT (Индекс стоимости строительства, база 2015), который актуализирует реальную инфляцию затрат (декабрь 2025 = 114,9 = +14,9% с 2015). Также возвращает confidence 0.0–1.0 (высокая, если есть заявленная площадь + INSEE, низкая — если резерв по участку), применённые модуляторы для прозрачности (audit-friendly) и контекстные заметки на французском. Типичный случай применения: MDB калибрует оферту на покупку («стройка оценена в 500–700k, выкупаю участок за 400k = валовая маржа X»), PropTech отвечает на тендер, банк проверяет досье («застройщик заявляет 600k, наша оценка 750–1M = недооценка, стоит разобраться»). Стоимость: 3 единицы квоты. Только план Pro+ (Free/Explorer получают 402). Начиная со спринта 16 дня 1, также возвращает breakdown_by_lot (черновые работы 38%, сантехника 11%, электрика 9% и т.д. по сценарию) с привязанными кодами NAF SIRENE — их затем передаёте в фильтр get_contractors, чтобы найти местные квалифицированные компании по каждому виду работ.

Перечисляет уже построенные кадастровые здания на участке разрешения (permit).КРИТИЧЕСКИЙ сценарий для торговца недвижимостью: различать голый участок (настоящее новое строительство, максимальная добавленная стоимость) и застроенный участок (расширение/реновация, меньшая добавленная стоимость).Возвращает nb_batiments (общее количество) + разбивку по типу (капитальная застройка / легкая застройка / прочее) + флаг parcelle_nue (логический) + детали по каждому зданию (идентификатор Etalab, типовая метка FR, центроид, даты создания и обновления кадастра).Источник: cadastre.data.gouv.fr через Etalab (DGFiP).Только для тарифа Pro+. Стоимость: 1 единица квоты.404, если у разрешения нет доступного кадастрового полигона (редко, ~15% разрешений).

Вычисляет (или получает из ежедневно материализованного кэша) Score Opportunité Marchand de Biens v0.3 для разрешения. Поведение: вызывает GET /v1/permits/{num_pa}/score, который возвращает оценку 0-100 + tier (low / medium / high / premium) + разбивку 11 взвешенных сигналов (dvf_density, dvf_value, plu_constructible, plu_zone_type, risk_score, sirene_quality, building_density, surface, type_permit, etat_admin, dep_focus) с их весом и вкладом в итоговую оценку. Включает version: "v0.3", method: "materialise (precomputed)", когда оценка берётся из cron daily 04h UTC (типичный случай), или live, когда пересчитана по запросу. Цель: помочь торговцу недвижимостью составлять шорт-лист разрешений с высоким потенциалом добавленной стоимости без ручного просмотра каждого разрешения. Рекомендации по использованию: оценка >= 70 обычно стоит изучения, >= 85 - top-tier (premium). Комбинируйте с find_dvf_neighbors для проверки обоснования цены земли. Стоимость: 1 единица квоты. Только план Pro+ (Free/Explorer получают 402).

Возвращает соседние кадастровые участки для разрешения на строительство в настраиваемом радиусе (10-2000 м, по умолчанию 200 м) и их историю разрешений (максимум 5 на участок). Кейс-убийца для Marchand de Biens: паттерн локальной активности вокруг идентифицированного разрешения. Позволяет обнаружить зону в процессе изменений (несколько недавних разрешений на соседних участках), смежные возможности (соседние участки без недавней активности), уплотнение (уже застроенные соседние участки против свободных). Метод: центроид исходного разрешения через permits.geom, приоритетно геокод BAN, иначе ST_Centroid(cadastre_geom). Поиск PostGIS ST_DWithin по 35 млн участков Франции с предварительным фильтром commune_code для использования индекса. Расстояние вычисляется в geography для точных метров. Исходный участок разрешения исключается из соседей (без само-ссылки). Только тариф Pro+. Стоимость квоты: 1 + количество возвращённых соседей (составная стоимость, согласованная с /360 и /v1/parcelles/{id}). Ответ: permit_commune_code + permit_center lat/lng + search_radius_m + neighbors_count + neighbors (список, отсортированный по возрастанию расстояния). Каждый сосед содержит: id_parcelle (14 символов) + section + numero + distance_m (точное) + contenance_m2 (DGFiP) + centroid lat/lng + permits_count + permits[] (максимум 5 элементов: num_pa + type + annee + etat + surface). Полный кейс: (1) search_permits для поиска целевого разрешения, (2) get_neighbor_parcels(num_pa=X, radius_m=200) для сканирования окружения, (3) get_mdb_score по num_pa интересующих соседей. Ошибка 422, если исходное разрешение не имеет ни геокода, ни cadastre_geom (~11% разрешений Sitadel).

Выполняет прямой поиск в кадастре DGFiP по идентификатору Etalab длиной 14 символов: возвращает за 1 вызов полный контекст участка без обращения к разрешению. Ответ: центроид (широта/долгота), официальная площадь DGFiP в м², коммуна (код INSEE + название), департамент, секция + кадастровый номер + префикс, полигон GeoJSON Polygon при наличии (получается из первого связанного разрешения с cadastre_geom), счётчик существующих зданий при наличии полигона (ST_Within), флаг parcelle_nue (булевый, удобно для продавцов недвижимости). Вариант использования: «я видел участок 75104000AA0123, покажи всё, что о нём известно, и все связанные исторические разрешения». Работает аналогично /v1/permits/{num_pa}/parcelle, но в обратном направлении поиска (участок -> разрешения), а не (разрешение -> участок). Связанные разрешения возвращаются с сопоставлением по коммуне + секции + номеру, отсортированы по году подачи (от новых к старым), лимит — 50 штук. Для Парижа, Лиона и Марселя округ автоматически сопоставляется с городом-метрополией. Только тариф Pro+. Стоимость по квоте: 1 (участок) + 1 за каждое возвращённое разрешение (составная логика согласована с шаблоном bulk_enrich_list и /360). Источник: Etalab DGFiP, 35 миллионов участков по всей Франции, обновляется ежемесячно. 404, если id_parcelle не существует (проверьте формат: 14 символов, заглавные буквенно-цифровые, например «75104000AA0123»).

Возвращает точную геометрию участка кадастра DGFiP по разрешению (через открытые данные Etalab). Возвращает GeoJSON Polygon WGS84, измеренную площадь в м² и идентификатор Etalab. Отображает точный полигон участка на карте (а не просто точку lat/lng адреса). Только для тарифа Pro+. Возвращает 404, если коммуна ещё не в кэше (редко, за пределами покрытия Etalab для очень новых DOM).

Получает ВСЕ известные детали разрешения по его идентификатору Sitadel num_pa. Поведение: вызывает GET /v1/permits/{num_pa}, который возвращает полный почтовый адрес, коммуну INSEE, код департамента, даты (подача, фактическое решение об авторизации, DAACT), площадь участка в м², административный статус (Accordé / Tacite / Refusé...), тип разрешения (PC_LOGEMENT, DP_LOCAUX, PA, PD...), геокодированные координаты GPS широта/долгота и кадастровую ссылку (sec_cadastre1 + num_cadastre1). Назначение: использовать, когда пользователь предоставляет конкретный num_pa и хочет узнать всё о нём за 1 вызов. Руководство по использованию: предпочитайте этот инструмент search_permits, когда идентификатор известен (1 единица квоты вместо N). Стоимость: 1 единица квоты. План Free подходит (в географическом охвате пользователя).

Vue 360: полный обзор разрешения за один вызов — детали + SIRENE + DVF + score MDB + zonage PLU + риски. Самый эффективный способ анализа разрешения, когда нужно всё сразу, а не вызывать 6 отдельных инструментов. Стоимость: 6 единиц квоты Pro+ (по 1 за подфункцию, как 6 отдельных вызовов). Для Free / Explorer возвращает только детали (стоимость 1 единица). В случае сбоя подфункции (например, таймаут PLU) поле равно null, а ошибка указывается в fetch_errors. Типичная задержка: 5–7 секунд.

Возвращает градостроительное зонирование PLU/POS по геокодированным GPS-координатам разрешения на строительство. Поведение: вызывает GET /v1/permits/{num_pa}/plu, который опрашивает Géoportail de l'Urbanisme (apicarto.ign.fr) или возвращает локальный кеш, если уже запрошен. Возвращает: raw zonage.code (например, UAa, UG, AU1, Nh...), читаемый zonage.libelle (например, Zone urbaine centrale), нормализованный zonage.type_zone (U — урбанизированная, застроенная / AU — подлежащая застройке / A — сельскохозяйственная, незастроенная / N — природная, незастроенная), zonage.constructible — логическое значение с юридическим обоснованием, zonage.plu_revision_date — дата последней ревизии PLU. Назначение: проверить, что проект может быть построен до любых инвестиций, выявить зоны, подлежащие застройке (AU), для упреждающего инвестирования. Рекомендации по использованию: если has_plu=false, муниципалитет ещё не оцифровал свой PLU (20% французских муниципалитетов в 2026 году, в основном сельские); в этом случае по умолчанию применяется RNU. Стоимость: 1 квота. Только для тарифа Pro+ (Free/Explorer получают 402).

Возвращает известные природные и технологические риски на коммуне разрешения по данным Géorisques BRGM. Поведение: вызывает GET /v1/permits/{num_pa}/risks, который возвращает агрегированный балл 0-100 (risk_score), качественный уровень (risk_tier: low / moderate / high / critical) и список обнаруженных рисков с их кодом Géorisques. Возможные коды: INONDATION (зона затопления PPRi), MVT (движение грунта / глина), SEISME (сейсмическая зона 2-5), CYCLONE (заморские департаменты), INDUSTRIEL (ICPE / Seveso поблизости), RADON (потенциал радона категории 3), FEUX_FORET (PPR пожаров), AVALANCHE, NUCLEAIRE (близость PPI INB). Каждый риск включает has_ppr (обязательный к исполнению Plan de Prévention des Risques) и ppr_type (Inondation / Mouvement / Technologique / и т.д.). Назначение: информировать покупателя/застройщика о нормативных рисках, которые могут повлиять на стоимость или возможность застройки, служить основой для обязательного IAL (Information Acquéreur Locataire) с 2006 года. Сценарий использования для торговца недвижимостью: исключать разрешения в зоне затопления или Seveso. Рекомендация по использованию: risk_tier=high указывает на 3+ крупных риска с действующим PPR, проверить eligibility страхования. Источник: api-prim.developpement-durable.gouv.fr (официальный Géorisques BRGM). Стоимость: 1 единица квоты. Только план Pro+ (Free/Explorer получают 402).

Прозрачное объяснение Score Opportunité Marchand de Biens v0.3 для разрешения. Поведение: вызывает GET /v1/permits/{num_pa}/score/explain, который возвращает оценку 0-100 + tier + 11 взвешенных сигналов, для каждого: его название на французском, его доктрину (как он в общем рассчитывается), его вес в итоговой оценке, его рассчитанное значение 0-100 для ЭТОГО разрешения, итоговый вклад (значение × вес) и контекстуализированную интерпретацию на французском ('Чистый снос (PD): топ-сигнал MDB', '850 м² в sweet spot MDB', 'Критический риск: недопустимо' и т.д.). Также включает топ-3 драйверов (сигналы, которые тянут оценку вверх относительно нейтрального 50) и топ-3 тормозов (сигналы, которые тянут её вниз) с их delta_vs_neutral. Плюс все использованные конкретные входные данные (полная прозрачность: permit_type, superficie_terrain, dep_code, denom_dem, density_class, plu_zone_type, plu_constructible, risk_tier, sirene_naf_prefix, nb_batiments_in_parcelle и т.д.). Назначение: аудит оценки 'почему этому разрешению присвоен балл 87?', обоснование решения MDB, прозрачная due-diligence. Рекомендации по использованию: дополняет get_mdb_score (который даёт только сырую оценку + tier) с помощью get_score_explanation, чтобы понять причину и иметь возможность обосновать клиенту / банкиру / партнёру. Стоимость: 2 единицы квоты (составной расчёт + интерпретации). Только тариф Pro+ (Free/Explorer получают 402).

Выполняет поиск разрешений на строительство во Франции с комбинируемыми фильтрами: департамент, коммуна, тип разрешения, статус, даты, минимальная площадь, SIREN заявителя. Возвращает страницу разрешений с их основной информацией. Тариф Free подходит. Стоимость квоты = количество возвращённых разрешений (макс. limit, мин. 1). Пример: limit=20 и 15 разрешений совпадают => списывается 15 единиц. Анти-эксфильтрация с 2026-05-16: если вы пытаетесь охватить целый департамент, предпочтите разумную страницу (limit=10-20) и остановитесь, когда пользователь получит то, что ему нужно, вместо агрессивного листания страниц.

Ищет разрешения на строительство, точка геокодирования которых находится внутри пользовательского полигона GeoJSON, заданного пользователем. Ключевая функция для земельных участков: ЗАК (Зона Аменжман Консэртэ), ЗА, периметры операций PropTech, зоны охоты торговцев недвижимостью за пределами административных границ коммуны или департамента. Типичный сценарий: «дай мне все разрешения на жильё с рейтингом MDB >= 70 в этом полигоне, который я только что нарисовал на карте». Только тариф Business+ (Pro за 199 евро остаётся на 14 стандартных административных фильтрах search_permits). Ограничение площади 1000 км² (защита от злоупотреблений). Стоимость квоты: max(2, количество возвращённых разрешений) согласуется с составным шаблоном. Дополнительные комбинируемые фильтры: dep_code (предварительный индексный фильтр, ускоряет работу для обширных полигонов), permit_type, min_an_depot / max_an_depot, min_score MDB v0.3. Возвращает items + count + polygon_surface_km2 + polygon_center lat/lng (удобно для центрирования карты на области) + filters_applied (эхо-фильтры для отладки). Строгий формат полигона GeoJSON RFC 7946: type: 'Polygon', coordinates: [[[lng, lat], ...]] с замкнутым внешним кольцом (первая точка == последняя, минимум 4 точки). MultiPolygon не поддерживается в V1. Координаты WGS84 EPSG:4326.