Evan-Crx/permisapi-mcp

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

Возвращает топ N ближайших к разрешению сделок с недвижимостью DVF (продажи с 2021 по 2025 год, Geo-DVF Etalab). Поведение: вызывает GET /v1/permits/{num_pa}/dvf, который делает пространственное соединение по GPS-координатам разрешения и возвращает прошлые продажи близлежащих объектов с их ценой, датой, типом (дом/квартира/хозпостройка/коммерческое помещение), площадью, числом комнат и расстоянием в метрах. Фильтрует на стороне сервера сделки < 1000 EUR (дарения DGFiP). Payload содержит dvf_median_price_per_m2 (медианная цена за м² по кварталу в EUR/м²), dvf_median_sample_size (число продаж в медиане) и dvf_median_basis (правило простым текстом). Это медиана разрешения, та же, что в get_permit_full_view и get_mdb_score: она считается по 5 соседним продажам, отобранным по score (не менее 1 000 EUR, по одной на сделку), у которых площадь застройки от 10 до 1 000 м², независимо от limit и фильтров (они меняют только список matches). Медианная цена, посчитанная по малому числу продаж (dvf_median_sample_size), мало показательна. Назначение: оценить цену за м² по кварталу, откалибровать предложение о покупке, проверить соответствие DVF заявленной цене. limit=3 возвращает 3 ближайшие продажи, limit=5 (максимум) - 5 ближайших; type_local=1,2 перечисляет только дома и квартиры. Стоимость: 1 единица квоты. Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402).

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

Возвращает макростатистику плотности городской застройки для коммуны за один вызов: количество кадастровых участков DGFiP + общая площадь + количество кадастровых зданий (капитальные / легкие / прочие) + количество исторических разрешений (с 2013 года) с разбивкой по годам, по типу (PC_LOGEMENT, PC_LOCAUX, PA, PD, DP) и по распределению Score MDB v0.3 (low / medium / high / premium) + показатель плотности (зданий на км² + tier tres_dense / dense / moyen / faible). Сценарии использования: обзор коммуны для мониторинга рынка, сравнение зон перед принятием решения по земельным вопросам. Paris, Lyon, Marseille: округ (75101-75120, 69381-69389, 13201-13216) учитывает собственные разрешения (Sitadel публикует их под городом; они привязываются по номеру разрешения или по почтовому индексу участка в Marseille, см. plm_mapping); весь город (75056, 69123, 13055) объединяет все свои округа. Только тарифы Business и Entreprise (иначе 402); статистика агрегированная, без ограничения по департаменту. Стоимость квоты: 3 составные единицы. Источники: cadastre.data.gouv.fr Etalab + Sitadel SDES.

Местные компании BTP вокруг разрешения: 'кто электрики / сантехники / каменщики в радиусе X км от этой стройки?'. Коды NAF для каждого лота из breakdown_by_lot (get_economics: общестроительные работы, сантехника, электрика и т. д.) используются как фильтр naf_codes. Поведение: вызывает 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 boolean (по умолчанию false = только административно активные). Возвращает для каждой компании: siren / siret / юридическое название / коммерческое название / код NAF + расшифровка / головной офис да-нет / диапазон численности (от 00 до 53 INSEE) + границы числа сотрудников / стаж в годах / полный адрес / коммуна / расстояние в метрах. Пример запроса: 'я нашёл разрешение в Париже, какие электрики с кодом NAF 43.21A находятся в радиусе 5 км и имеют не менее 10 сотрудников?'. Стоимость: 5 единиц составной квоты (защита от злоупотреблений). Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). 422, если разрешение не геолоцировано или если коды NAF вне области BTP.

Оценка бюджета стройки по разрешению: 'сколько будет стоить этот проект?' с диапазоном низкий / медианный / высокий (EUR), детализация по м², определённый сценарий (новое строительство, капитальный / лёгкий ремонт, снос, благоустройство). Поведение: вызывает GET /v1/permits/{num_pa}/economics, который объединяет 3 источника: (1) площади, заявленные застройщиком в разрешении Sitadel (SURF_HAB_CREEE + SURF_LOC_CREEE + преобразования) с fallback-ratio по участку, когда их нет; (2) статическая калиброванная шкала по публичной литературе Capeb / FFB / Anjou Construction 2024 (стоимость за м² по типу проекта, с поправкой по департаменту: Paris +25%, Côte d'Azur +20%, региональные метрополии +5%; и по размеру: микро +20%, крупные программы -15%); (3) официальный модулятор INSEE ICP-BT (Indice du Coût de Production des Bâtiments, база 2015), который актуализирует реальную инфляцию затрат (декабрь 2025 = 114.9 = +14.9% с 2015). Возвращает также confidence 0.0-1.0 (высокая, если площадь заявлена и INSEE доступен, низкая при fallback по участку), применённые модуляторы (детализацию расчёта) и контекстные заметки на французском. Применяется, чтобы подготовить оферту о покупке, ответить на тендер, сравнить заявленный бюджет досье с оценкой. Стоимость: 3 единицы квоты. Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). Возвращает также breakdown_by_lot (общестроительные работы 38%, сантехника 11%, электрика 9% и т. д. в зависимости от сценария) со связанными кодами NAF SIRENE, которые можно использовать как фильтр naf_codes в get_contractors (ближайшие компании BTP, по лотам).

Перечисляет кадастровые здания, уже построенные на участке, указанном в разрешении. Различает незастроенный участок (новое строительство) и уже застроенный участок (пристройка, реконструкция). Возвращает общее число nb_batiments + разбивку по типу (капитальное строение / лёгкое строение / другое) + флаг parcelle_nue boolean + детали по каждому объекту (id Etalab, тип label FR, центроид, даты создания/MAJ кадастра). Источник: cadastre.data.gouv.fr через Etalab (DGFiP). Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). Стоимость: 1 единица квоты. 404, если указанная в разрешении кадастровая ссылка отсутствует или не найдена в кадастре.

Вычисляет Score Opportunité Marchand de Biens v0.3 для разрешения. Поведение: вызывает GET /v1/permits/{num_pa}/score, который возвращает оценку 0-100, tier (low < 30, medium 30-59, high 60-79, premium >= 80), version: "v0.3", method и детализацию 11 взвешенных сигналов: components (значение 0-100 каждого сигнала: type, surface, dvf_value, dep_activity, demandeur, dvf_coherence, density, plu, risk, sirene, building_density) и weights (вес). Тот же расчёт, что и у поля score_mdb в списках и в представлении 360. Объяснение на французском для каждого сигнала даёт get_score_explanation. Назначение: предварительно отобрать разрешения с лучшими оценками, не разбирая каждое по отдельности. Пороги: >= 60 = high, >= 80 = premium. Соседние продажи по разрешению перечисляет find_dvf_neighbors. Стоимость: 1 единица квоты. Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402).

Возвращает соседние кадастровые участки для разрешения в настраиваемом радиусе (10-2000 м, по умолчанию 200 м) + их историю разрешений (не более 5 на участок). Помогает увидеть активность вокруг разрешения: зона в процессе изменений (несколько недавних разрешений на соседних участках), смежные возможности (соседние участки без недавней активности), уплотнение (соседние участки уже застроены vs свободны). Метод: центроид исходного разрешения через permits.geom, geocode BAN в приоритете, иначе ST_Centroid(cadastre_geom). Поиск PostGIS ST_DWithin по 35M участков Франции с предфильтром commune_code, чтобы задействовать индекс. Расстояние вычисляется в geography для точных метров. Участок исходного разрешения исключается из соседей (без автоссылки). Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). Стоимость квоты: 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). Исходный num_pa обычно приходит из search_permits; num_pa соседних разрешений также используются с get_mdb_score. Ошибка 422, если у исходного разрешения нет ни geocode, ни cadastre_geom (~11% разрешений Sitadel).

Ищет напрямую в кадастре DGFiP по идентификатору Etalab из 14 символов: возвращает за 1 вызов полный контекст участка, не обращаясь к разрешению. Ответ: центроид lat/lng, официальная площадь DGFiP в м², commune (код INSEE + nom), département, section + numero cadastraux + prefix, polygon GeoJSON Polygon, если доступен (берётся из первого связанного разрешения, у которого есть cadastre_geom), счётчик существующих зданий, если polygon доступен (ST_Within), булев флаг parcelle_nue. Сценарий использования: 'я видел участок 75104000AA0123, дай мне всё, что о нём известно, + все связанные исторические разрешения'. Согласовано с /v1/permits/{num_pa}/parcelle, но поиск идёт в обратную сторону: (parcelle -> permits), а не (permit -> parcelle). Связанные разрешения возвращаются через сопоставление commune + section + numero, сортируются по году подачи по убыванию, не более 50. Для Paris/Lyon/Marseille сопоставление arrondissement -> головной город выполняется автоматически. Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). Стоимость квоты: 1 (участок) + 1 за каждое возвращённое разрешение (составная, согласована с паттерном bulk_enrich_list и /360). Источник: Etalab DGFiP, 35 миллионов участков по всей Франции, ежемесячное обновление. 404, если id_parcelle не существует (проверяйте формат: 14 символов, буквенно-цифровой в верхнем регистре, например '75104000AA0123').

Точная геометрия кадастрового участка DGFiP по разрешению (через открытые данные Etalab). Возвращает GeoJSON Polygon WGS84 + измеренную площадь в м² + идентификатор Etalab. Позволяет визуализировать точный полигон участка на карте (вместо одной лишь точки lat/lng адреса). Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). 404, если коммуна ещё не в кэше (редко, вне покрытия Etalab по совсем недавним DOM).

Получает все известные сведения о разрешении по его идентификатору Sitadel num_pa. Поведение: вызывает GET /v1/permits/{num_pa}, который возвращает полный почтовый адрес, код коммуны INSEE, код департамента, даты (подача, фактическое решение о разрешении, DAACT), площадь участка в м², статус (Autorisé / Annulé / Travaux commencés / Travaux terminés), тип разрешения (PC_LOGEMENT, DP_LOCAUX, PA, PD...), геокодированные GPS-координаты lat/lng и кадастровую ссылку (sec_cadastre1 + num_cadastre1). Назначение: читает за 1 вызов карточку разрешения, для которого известен num_pa. Для известного идентификатора этот инструмент стоит 1 единицу, тогда как search_permits списывает 1 единицу за каждое возвращённое разрешение. Стоимость: 1 единица квоты. Все тарифные планы (в географической зоне действия тарифного плана).

Полная Vue 360 по разрешению за 1 вызов: детали + sirene + dvf + score MDB + зонирование PLU + риски, то есть содержимое 6 отдельных вызовов, собранное в один. Тарифы Régional, Pro, Business и Entreprise: полный обзор, 6 единиц квоты (1 на подраздел, как 6 отдельных вызовов). Gratuit, Découverte и Explorateur: только детали (1 единица), с полем plan_required_for_full ("regional" : тариф Régional). При сбое подфункции (например, PLU timeout) поле равно null, а ошибка указывается в fetch_errors. Типичная задержка 5-7 с.

Возвращает зонирование по градостроительным документам PLU/POS для геокодированной GPS-точки разрешения. Поведение: вызывает GET /v1/permits/{num_pa}/plu, который обращается к Géoportail de l'Urbanisme (apicarto.ign.fr) либо возвращает локальный кеш, если данные уже загружались. Возвращает: 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, значит в точке разрешения на Géoportail не нашлось ни одного оцифрованного документа градостроительного планирования (причина указана в not_covered_reason). Стоимость: 1 единица квоты. Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402).

Возвращает известные природные и техногенные риски по коммуне, к которой относится разрешение, по данным Géorisques BRGM. Поведение: вызывает GET /v1/permits/{num_pa}/risks, который возвращает агрегированный балл 0-100 (risk_score), качественный уровень (risk_tier: low / moderate / high / critical) и список обнаруженных рисков с их кодом (номенклатура GASPAR от Géorisques, официальное название в label). Возможные коды: INONDATION, MVT (движение грунта), SEISME, AVALANCHE, ERUPTION, FEUFOR (лесной пожар), ATMOSPHERE (шторм, молния, град, снег), CYCLONE (только для заморских департаментов), RADON, INDUSTRIEL, NUCLEAIRE, RUPTURE_BARRAGE, TMD (перевозка опасных грузов), ENGINS_GUERRE, горные риски (AFFAISSEMENT_MINIER, INONDATION_MINIERE, GAZ_MINE, ECHAUFFEMENT_DEPOTS) и AUTRE. has_ppr: true, если в коммуне есть ОБЯЗАТЕЛЬНЫЙ К ИСПОЛНЕНИЮ план предупреждения по этому риску (архив GASPAR, файл ppr_lu_le, шаблон ppr_type, название ppr_nom), false, если его нет, null, если это не проверено; покрытый риск считается с коэффициентом x1,5. Это план коммуны, а не зоны адреса. icpe_proches перечисляет объекты Seveso в радиусе 2 км от разрешения (независимо от их коммуны), от ближайшего к самому дальнему, с distance_m в метрах: +15 к баллу за каждый объект, но не больше +30; у негеокодированного разрешения их нет. Каждый риск коммуны добавляет свои баллы (3 за радон, 8 за сейсмику, 10 за наводнение, 20 за промышленный риск...); уровни: низкий ниже 25, умеренный от 25 до 54, высокий от 55 до 74, критический от 75. risk_reasons говорит, откуда взялись баллы (по одной фразе на причину, их сумма даёт risk_score), а risk_summary - что именно измеряет уровень; risk_tier_label даёт уровень по-французски (faible, modéré, élevé, critique). Это риски всей коммуны, а не адреса. Назначение: сообщить покупателю или застройщику о рисках, учтённых по коммуне, прежде чем идти дальше; не заменяет…

Поясняет Score Opportunité Marchand de Biens v0.3 для разрешения. Поведение: вызывает GET /v1/permits/{num_pa}/score/explain, который возвращает score 0-100 + tier + 11 взвешенных сигналов, для каждого из которых: его название на французском, его доктрина (как он рассчитывается в общем случае), его вес в итоговом score, его рассчитанное значение 0-100 для ЭТОГО разрешения, его итоговый вклад (значение × вес) и контекстуализированная интерпретация на французском ('Démolition pure (PD) : top signal MDB', '850 m² dans le sweet spot MDB', 'Risque critique : rédhibitoire' и т.д.). Включает также top 3 drivers (сигналы, которые тянут score вверх относительно нейтрального 50) и top 3 drags (сигналы, которые тянут его вниз) с их 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?') и обосновать решение. get_mdb_score даёт оценку, tier и сырое значение каждого сигнала; этот инструмент добавляет к ним названия, интерпретации и вклады. Стоимость: 2 единицы квоты (расчёт композита + интерпретации). Тарифы Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402).

Ищет разрешения на строительство во Франции с комбинируемыми фильтрами: департамент, коммуна, тип разрешения, статус, даты, минимальная площадь, SIREN заявителя. Возвращает страницу разрешений с базовой информацией о них: {"data": [...], "pagination": {page, limit, total, has_next, next_url}}. Все тарифы (включая Gratuit), в пределах географической зоны действия тарифа. Фильтры min_score и max_risk доступны только для тарифов Régional, Pro, Business и Entreprise (Gratuit, Découverte и Explorateur получают 402). Градостроительное зонирование разрешения выдаёт get_plu_zoning (расчёт в реальном времени). Расход квоты = количество возвращённых разрешений (максимум limit, минимум 1). Пример: limit=20 и найдено 15 разрешений => списано 15 единиц. Каждая страница списывается так же: перебор всего департамента страница за страницей может израсходовать большую часть месячной квоты.

Ищет разрешения на строительство, у которых геокодированная точка попадает внутрь пользовательского полигона GeoJSON, заданного пользователем. Для ZAC (Zone d'Aménagement Concerté), зоны активности, периметра операции или любого участка, который не идёт по границам коммуны или департамента. Пример запроса: «дай мне все разрешения на жильё со Score MDB >= 70 в этом полигоне, который я только что нарисовал на карте». Только тарифы Business и Entreprise (для остальных 402, включая Régional и Pro: они сохраняют административные фильтры search_permits). Ограничение площади 1 000 км² (защита от злоупотреблений). Стоимость по квоте: 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 не поддерживается. Координаты WGS84 EPSG:4326.