Dutch Property Context
Relatório de propriedade holandesa por endereço. Combina nove fontes oficiais abertas: ano de construção, área útil, etiqueta energética, estatísticas do bairro, ruído ambiental e qualidade do ar, status de monumento nacional e escolas próximas. Separa fato, sinal e desconhecido. MCP remoto, sem chave de API.
Documentação
Por que isso existe
Pergunte a um agente de IA sobre um endereço holandês e ele vai para a web. Isso gera uma resposta que parece boa e às vezes está correta. Os dados subjacentes são públicos e confiáveis, mas estão em nove registros diferentes, cada um com sua própria chave, formato e peculiaridades.
A parte mais difícil não é buscar, mas vincular. Ao construir, travamos exatamente nessas vinculações: um número de monumento que publicamos acabou sendo o número interno do objeto e apontava para um imóvel em uma província completamente diferente. Um endereço sem nome de cidade recebeu um monumento de Coevorden. E Binnenrotte 101, Amsterdam retornou, sem qualquer ressalva, o imóvel em Rotterdam.
Esses não são erros nas fontes — todas estavam corretas. A vinculação é que falhou. Esta camada assume esse trabalho e diz explicitamente o quão certo está de que capturamos o imóvel correto.
Para quem, e para quê
Corretores e avaliadores
Posição inicial objetiva em uma vistoria: ano de construção, área, etiqueta, status de proteção.
Compradores e seus consultores
O que está oficialmente registrado e quais pontos merecem verificação na inspeção predial.
Sustentabilidade e instalação
Coorte de ano de construção, etiqueta energética e área como ponto de partida para um conselho de isolamento ou bomba de calor.
Construtores de agentes de IA
Uma ferramenta MCP que o agente chama sozinho assim que um endereço holandês aparece na conversa.
O que você recebe de volta
Uma resposta JSON, cerca de 11 kB, com estes blocos:
| Bloco | Conteúdo |
|---|---|
identity | O imóvel encontrado, mais match_verified: este é realmente o endereço solicitado? |
building | Ano de construção, área útil, finalidade de uso, identificações do imóvel |
energy | Etiqueta energética registrada, validade, tipo de edifício, consumo calculado |
location | Coordenadas, município, código de bairro e distrito |
neighbourhood | Números do bairro: habitantes, densidade, estrutura etária, composição dos domicílios, valor médio WOZ, aluguel/compra, distância até médico de família, supermercado, escola e creche |
environment | Ruído ambiental (Lden), material particulado PM2.5 e dióxido de nitrogênio NO₂ |
heritage | Status de monumento nacional com o número real do registro |
protected_area | Localização em área urbana ou rural protegida, e em Patrimônio Mundial da UNESCO |
schools | Ensino fundamental e médio na vizinhança, com distância e estrutura educacional |
signals | As observações, cada uma com uma recomendação e a fundamentação |
provenance | Por fonte: qual, quando foi buscada, com qual status e licença |
Os sinais são o ponto
Um sinal nunca estabelece uma deficiência. Ano de construção 1921 não significa que há canos de chumbo — significa que vale a pena verificar. Todos funcionam assim:
- construction_era_checks — o que deve ser verificado nesta coorte de ano de construção
- conflicting_construction_year — dois registros citam anos de construção diferentes; ambos são exibidos, nós não escolhemos
- energy_label_expiring / no_energy_label / energy_label_address_mismatch
- protected_townscape e world_heritage_area — consequências para licenças
- address_match_unverified — o endereço solicitado não foi encontrado com certeza
- source_unavailable — uma fonte não respondeu; o campo é desconhecido, não vazio
O que ele não faz
Isto não é uma avaliação, não é valor de imóvel e não é aconselhamento jurídico ou predial. Não há preço de venda, nem canon de enfiteuse, nem informações de associação de condomínio, nem histórico de propriedade cadastral — esses dados não estão disponíveis gratuitamente.
Atenção ao identity.match_verified
Se estiver como false, o endereço solicitado não foi encontrado com certeza e o restante da resposta pode ser sobre um imóvel diferente. Nesse caso, não apresente os dados como fato. Em match_ambiguous, há vários candidatos igualmente bons, e todos estão listados.
Documentos ambientais sob a Lei Ambiental (Omgevingswet) não estão conectados; eles exigem uma chave separada. Isso aparece como not_configured na resposta — um status, não um campo vazio.
Como usar
Como servidor MCP, no Claude, Cursor ou outro agente
Cursor: um clique —
Claude (web ou desktop, funciona em qualquer plano, incluindo o gratuito): vá em Customize → Connectors → + → Add custom connector e cole https://property-context.tradebrite.nl/mcp. O Claude não pode instalar isso por você; é deliberadamente uma ação sua, pois um conector pode agir em seu nome.
ChatGPT: conectores personalizados estão atrás do Developer Mode e só estão disponíveis no Pro, Team, Enterprise e Edu — no plano Plus não é possível. Use a API HTTPS comum abaixo.
Claude Code:
claude mcp add --transport http property-context https://property-context.tradebrite.nl/mcp
Ou manualmente na sua configuração MCP:
{
"mcpServers": {
"property-context": {
"type": "http",
"url": "https://property-context.tradebrite.nl/mcp"
}
}
}
Depois disso, você pode simplesmente perguntar: "O que devo saber sobre Grote Markt 2 em Haarlem antes de visitar?"
Como API HTTPS
curl "https://property-context.tradebrite.nl/v1/property/context?address=Grote%20Markt%202,%20Haarlem"
| Parâmetro | Significado |
|---|---|
address | Endereço holandês, de preferência com nome da cidade ou CEP. Também funciona com 2242KE 1. |
depth | compact (padrão) ou full. Full fornece a lista completa de escolas e as URLs das fontes. |
refresh | 1 ignora o cache de uma hora. |
Fontes, licença e limites de uso
Os dados vêm de registros oficiais holandeses: o Registro Base de Endereços e Edifícios, números de bairro do CBS, medições do RIVM para ruído e qualidade do ar, o registro de etiquetas energéticas da RVO, os registros de monumentos nacionais e áreas protegidas, e os endereços educacionais da DUO.
Parte disso está sob CC BY 4.0, o que significa que a atribuição de fonte é obrigatória. Por isso, cada resposta inclui o bloco provenance com o nome e o status de cada fonte — também no formato compacto. Inclua essa atribuição ao repassar os dados a um usuário final; essa obrigação acompanha os dados.
Etiquetas energéticas não podem ser redistribuídas em grandes quantidades. É por isso que há um limite de taxa; isso decorre das condições do detentor da fonte, não da nossa capacidade.
Limite de taxa
10 solicitações por 10 segundos e 60 por minuto, por endereço IP. Em caso de excedente, é retornado HTTP 429 com um cabeçalho Retry-After. Se você precisar de mais volume de forma estrutural, envie um e-mail.
Responsabilidade
Este serviço é oferecido gratuitamente e sem garantias. Decisões sobre compra, reforma ou sustentabilidade continuam sendo responsabilidade do usuário.
A mesma ideia, outro assunto
Dutch Vehicle Context
A mesma abordagem para veículos holandeses: uma única placa fornece o histórico de inspeção técnica (APK), pontos de reprovação com descrições traduzidas, a avaliação da quilometragem e a cadeia completa de recalls — incluindo o que pode quebrar e o quão perigoso é.
Código-fonte
O código está aberto no GitHub, sob licença MIT: github.com/rleefers/dutch-property-context. Você pode executá-lo na sua própria conta Cloudflare; não são necessárias chaves para as fontes abertas. No repositório também está o teste de regressão que usamos para verificar se as vinculações estão corretas.
Este serviço também está no registro oficial MCP como nl.tradebrite/dutch-property-context.
Perguntas ou algo quebrado?
Construído e mantido pela Tradebrite BV. Algo não está certo, falta uma fonte, ou você quer mais volume? Avise — relatos sobre um endereço concreto são os mais úteis.