LyBox

Lance l'analyse IA complète de LyBox sur un favori et renvoie le rapport (result, en HTML simple pour type ad, en Markdown pour type dpe ; result_format le précise) : type ad = analyse de l'annonce selon un objectif (rp résidence principale, invest investissement locatif, patrim patrimonial, mdb marchand de biens, lcd location courte durée), type dpe = analyse du diagnostic énergétique. Consomme 1 crédit IA du compte (solde dans get_user_settings ; erreur explicite si le solde est épuisé ou si le forfait ne le permet pas) et dure une à trois minutes : prévenir l'utilisateur et ne lancer qu'à sa demande. La réponse porte verdict (décision et fiabilité), suggestions (corrections de champs proposées, à appliquer avec update_favorite après accord de l'utilisateur) et ai_credit (solde restant). Ne compte pas dans le quota journalier.

run_ai_analysis

Favoris d'une liste (ou de toutes avec favorite_list_id = all), paginés par 20, avec filtres optionnels sur le titre, le statut, la ville, le prix et le rendement. Résumé par favori par défaut (detail = true pour les favoris complets, ou get_favorite pour un seul).

list_favorites

Liste les listes de favoris de l'utilisateur (ses propres listes : celles partagées par d'autres comptes ne sont pas accessibles via l'assistant) avec leur identifiant et leur nombre de favoris (total). Les favoris d'une liste s'obtiennent par list_favorites.

list_favorite_lists

Recherches sauvegardées de l'utilisateur avec leur identifiant, leurs filtres et la fréquence d'alerte mail (Fréquence des alertes mail : 0 = aucune, 1 = 2 fois par semaine, 2 = tous les matins, 3 = tous les midis, 4 = tous les soirs, 5 = matins et soirs, 6 = matin, midi et soir, 7 = en direct (dès qu'une annonce sort)). filters suit le schéma de search_ads et se passe tel quel à search_ads ou update_search (search_city_params_id = secteur de list_sectors) ; city_names donne le nom de chaque city_code.

list_saved_searches

Liste les secteurs géographiques enregistrés par l'utilisateur (villes incluses/exclues, départements, régions).

list_sectors

Modifie les DONNÉES SOURCES d'un favori (simulation de l'utilisateur) : prix, loyer, surface, travaux, charges, taxe foncière, financement, hypothèses fiscales, revente, notes, lots, contacts. Les indicateurs (rendement brut et net, cash-flow, charges mensuelles, nb_lots) ne se modifient pas : ils sont recalculés par LyBox après chaque modification et renvoyés avec la simulation (sans l'annonce d'origine ni la fiche ville : get_favorite, get_city). Un prix d'acquisition nul est refusé. Un champ calculé ou inconnu est refusé avec la liste des champs concernés. Ne modifie que ce que l'utilisateur a demandé, en confirmant les valeurs avant d'écrire quand elles sont ambiguës.

update_favorite

Remplace le titre et les filtres d'une recherche sauvegardée (les filtres non fournis sont effacés : renvoyer l'ensemble des filtres voulus). L'alerte n'est pas modifiée.

update_search

Détail complet d'un favori : annonce d'origine, données sources de la simulation (prix, loyer, surface, travaux, charges, financement, lots, notes, contacts), indicateurs calculés avant impôt (efficiency_brut, efficiency_net, cash_flow) et lien lybox_url pour l'ouvrir dans l'application. Description et photos sont celles du favori (ad ne les reprend que si l'annonce diffère). favorite_list vide = annonce seulement ouverte dans l'application, pas encore rangée en favori : c'est normal. La ville est réduite à son identité (fiche complète : get_city). La simulation d'impôt (imposition, cash-flow après impôt, projection de revente) n'est pas calculée par le MCP : une estimation indicative peut être donnée avec ses hypothèses, les vraies valeurs sont dans l'application (lybox_url).

get_favorite

Réglages que LyBox applique à tout nouveau favori : frais d'acquisition (%), trois niveaux de travaux en €/m² (work_1 rafraîchissement, work_2 rénovation, work_3 remise à neuf), financement par défaut (apport, durée, taux, assurance, frais bancaires), gestion locative, vacance, GLI, PNO, comptable, régime fiscal et revenus déclarés, ainsi que le solde de crédits IA (ai_credit, ai_credit_quota, ai_credit_renew_date) à vérifier avant run_ai_analysis. Chaque code est expliqué dans labels. À lire avant de proposer des travaux, un financement ou des charges sur un favori, pour rester cohérent avec le compte. Ne compte pas dans le quota.

get_user_settings

Recherche des annonces immobilières à vendre selon des filtres (localisation, prix, surface, type de bien, rendement, cash-flow…). Renvoie ads (pour chaque annonce : ad avec ad.id, calc = indicateurs, quartier = INSEE et prix de son IRIS et grand quartier, absent sans IRIS ; pas de loyers par quartier), cities (fiche de chaque commune présente, une seule fois, par city_code : inutile d'appeler get_city pour elles), result (nombre renvoyé) et total. Pagination par décalage : last = nombre d'annonces déjà reçues (0 = première page, puis 10, 20… avec limit 10), jusqu'à 250 résultats (last + limit) ; au-delà, affiner les filtres. Compte dans le quota journalier (solde dans quota_remaining).

search_ads

Recherche des communes selon des critères de marché et socio-démographiques : population, chômage, étudiants, logements vacants, niveau de vie, locataires, croissance démographique, tension locative, loyer et prix au m², rentabilité moyenne, évolution des prix, dispositifs Action cœur de ville et Denormandie, dans une zone (villes avec rayon, départements, régions). Renvoie une liste paginée de villes avec leurs indicateurs clés (résumé par défaut, detail = true pour toutes les données de la recherche ; la fiche complète d'une ville, séries annuelles comprises, est dans get_city). Compte dans le quota journalier (solde dans quota_remaining).

search_cities

Convertit un nom de ville ou un code postal en code INSEE, et un nom de département ou de région en libellé exact attendu par les filtres. Facultatif : le code INSEE est l'identifiant officiel de chaque commune, s'il est déjà connu il se passe directement à search_ads, get_city ou save_sector. Renvoie pour chaque résultat son type (city, global pour Paris, Lyon ou Marseille entiers : filtre de recherche seulement, sans fiche get_city, departement, region). Ne compte pas dans le quota journalier.

find_city

Sauvegarde une recherche d'annonces nommée avec ses filtres (mêmes filtres que search_ads) et, optionnellement, une alerte mail. Renvoie la recherche créée avec son identifiant.

save_search

Retire un favori (et sa simulation) des listes de l'utilisateur. Irréversible depuis l'assistant : ne l'appelle qu'après une demande explicite de l'utilisateur visant ce favori précis, jamais en lot ni par déduction. Les listes et secteurs ne se suppriment pas via le MCP.

delete_favorite

Supprime une recherche sauvegardée et son alerte mail. Irréversible depuis l'assistant : ne l'appelle qu'après une demande explicite de l'utilisateur visant cette recherche précise (id de list_saved_searches), jamais en lot ni par déduction. Pour seulement couper les mails, préférer set_search_alert avec frequency_alert 0.

delete_search