API pública.
Acceso de lectura a los datos públicos franceses que integramos: regiones, departamentos, municipios y parcelas catastrales, con las estadísticas y los enriquecimientos que se muestran en el sitio. REST, JSON, una clave en una cabecera. Gratuita para uso no comercial. Y un servidor MCP para asistentes de IA.
Crea una cuenta.
La clave se obtiene en línea, en dos minutos, sin necesidad de escribirnos:
- Regístrate con tu email y una contraseña, o con Google.
- Abre el enlace de confirmación que recibirás por email.
- En tu cuenta, haz clic en «Crear una clave»: solo se muestra una vez, cópiala.
El plan gratuito está incluido; los planes de pago se contratan desde la cuenta, sin permanencia.
| Plan | Precio | Por día | Por minuto | Uso |
|---|---|---|---|---|
| Gratuito | Gratuito | 100 solicitudes | 10 solicitudes | No comercial |
| Standard | 19 € + IVA / mes | 2000 solicitudes | 60 solicitudes | Uso comercial permitido |
| Pro | 79 € + IVA / mes | 25.000 solicitudes | 300 solicitudes | Uso comercial permitido |
Los límites se aplican por cuenta, sumando todas sus claves. Una clave identifica una integración, no a un visitante: no la incluyas en un front-end público. Cada respuesta devuelve X-Plan, X-Quota-Used y X-Quota-Remaining. Para necesidades fuera de este marco (administraciones, investigación, mayor volumen), escríbenos: contact@lagrandecarte.fr.
curl -H "X-API-Key: TU_CLAVE" \ "https://lagrandecarte.fr/api/v1/communes/18033?include=stats"
Servidor MCP.
Los mismos datos, directamente en Claude, ChatGPT, Cursor o cualquier cliente compatible con MCP: el asistente geocodifica la dirección, encuentra la parcela y consulta sus riesgos, su urbanismo o sus ventas sin que tengas que tocar la API. Cada herramienta llama al endpoint REST correspondiente: misma cuenta, mismos límites, una llamada a una herramienta cuenta como una solicitud.
https://lagrandecarte.fr/mcp
Guía de conexión paso a paso: lagrandecarte.fr/es/mcp.
Desde la interfaz
Añade en tu asistente un conector personalizado con esta dirección. Te redirigirá a La Grande Carte: inicia sesión (o crea una cuenta), autoriza el acceso y se creará automáticamente una clave «MCP · …» en tu cuenta. Revocarla desconecta el asistente.
Con una clave
Para los clientes que aceptan una cabecera, genera una clave desde tu cuenta. Claude Code:
claude mcp add --transport http lagrandecarte https://lagrandecarte.fr/mcp \ --header "X-API-Key: TU_CLAVE"
Configuración JSON (Cursor, Claude Desktop, VS Code…):
{
"mcpServers": {
"lagrandecarte": {
"type": "http",
"url": "https://lagrandecarte.fr/mcp",
"headers": {
"X-API-Key": "TU_CLAVE"
}
}
}
} Ejemplos de preguntas
- «¿Qué sabes del municipio de Bosdarros? ¿Y qué tal es la calidad del agua del grifo?»
- «Voy a visitar una casa en el 4 rue Porte Jaune de Bourges: ¿riesgos naturales, zonificación del PLU, ventas recientes en la zona?»
- «Compara la renta mediana, los alquileres y la delincuencia de Pau y Tarbes.»
- «¿Tasa de pobreza y esperanza de vida en Pirineos Atlánticos (Pyrénées-Atlantiques), comparadas con Nueva Aquitania (Nouvelle-Aquitaine)?»
El asistente solo envía los parámetros de las herramientas (un municipio, una dirección), nunca tu conversación: consulta la política de privacidad. Preguntas o problemas: contact@lagrandecarte.fr.
| Herramienta | Descripción |
|---|---|
| get_commune | Todo sobre un municipio: población, ingresos, alquileres, calidad del agua y del aire, delincuencia, clima, cargos electos, finanzas… (estadísticas incluidas) |
| search_address | Buscar un municipio, una dirección o un paraje; devuelve el código INSEE y las coordenadas |
| get_parcel_enrichments | El informe completo de una parcela: riesgos, urbanismo, ventas, certificado energético, ruido, redes… |
| get_parcel_at_point | La parcela catastral en un punto |
| get_parcel | Una parcela por su referencia catastral (IDU) |
| get_departement | Un departamento con sus estadísticas y, opcionalmente, sus municipios |
| get_region | Una región con sus estadísticas y, opcionalmente, sus departamentos |
| find_commune | El municipio que contiene un punto |
| list_communes | Los municipios de un departamento |
| list_departements | Los departamentos, opcionalmente de una región |
| list_regions | Las regiones |
Los endpoints.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1 | Índice del servicio — la única llamada sin clave |
| GET | /api/v1/regions | Las 18 regiones |
| GET | /api/v1/regions/{code} | Una región · include=geometry,stats,departements |
| GET | /api/v1/departements | Los 96 departamentos metropolitanos · ?region= |
| GET | /api/v1/departements/{code} | Un departamento · include=geometry,stats,communes |
| GET | /api/v1/communes | Los municipios de un departamento (?departement=) o el que contiene un punto (?lat=&lon=) |
| GET | /api/v1/communes/{codeInsee} | Un municipio · include=geometry,stats |
| GET | /api/v1/adresses?q= | Geocodificación de una dirección o un lugar (Base Adresse Nationale) |
| GET | /api/v1/parcelles?lat=&lon= | La parcela catastral en un punto |
| GET | /api/v1/parcelles/{idu} | Una parcela · include=geometry |
| GET | /api/v1/parcelles/{idu}/enrichments | Todo lo que sabemos de la parcela |
Los departamentos de ultramar aún no están en la tabla de límites administrativos: /departements/974 responde 404, pero sus municipios y sus parcelas sí se sirven (/communes?departement=974).
Los datos se publican bajo Licence Ouverte 2.0: reutilización libre, también comercial, siempre que se cite la fuente. Basta con mencionar «La Grande Carte» con un enlace.
Prueba las llamadas.
La documentación interactiva se genera a partir de la especificación OpenAPI y está en inglés.