Plataforma API e MCP da CASAFARI: dados imobiliários para agentes de IA
Ligue o Claude, o ChatGPT ou qualquer cliente MCP ao grafo de imóveis da CASAFARI em 16 países (EUA: em fase de entrada, estados selecionados, apenas imobiliário comercial, através do Claro AI). Uma única conta, OAuth sem chaves e 1.000 tokens grátis.
A CASAFARI é a plataforma de inteligência de dados imobiliários nativa para agentes de IA. A Plataforma API e MCP da CASAFARI permite que assistentes como o Claude ou o ChatGPT acedam diretamente ao grafo de imóveis em 16 países, incluindo Portugal, através de servidores MCP em formato Streamable HTTP ou de uma API REST. O acesso é gerido numa única conta em platform.casafari.com, com início de sessão por OAuth no navegador, ferramentas maioritariamente de leitura e um plano gratuito inicial de 1.000 tokens durante 30 dias sem necessidade de cartão de crédito.
O que é a Plataforma API e MCP da CASAFARI?
Numa terça-feira de manhã numa rede imobiliária em Lisboa, um analista abre o Claude e digita em português: «Mostra-me a evolução dos preços por metro quadrado em Campo de Ourique nos últimos 24 meses e lista os comparáveis para um T3 em Cascais». Em poucos segundos, o assistente consulta o servidor de localização, obtém as séries temporais e devolve a avaliação fundamentada, reportando exatamente os tokens consumidos.
A Plataforma API e MCP da CASAFARI disponibiliza o grafo de imóveis da CASAFARI, no qual cada propriedade corresponde a um registo único e limpo com todo o histórico de alterações de preço, estados e retiradas do mercado, abrangendo habitação e imóveis comerciais para venda e arrendamento. Os mesmos dados estão disponíveis por duas vias suplementares na mesma conta: servidores MCP para agentes de IA e a API REST para aplicações tradicionais.
Esta resposta em tempo real é crítica no mercado português. De acordo com o Índice de Preços da Habitação do INE, 1.º trimestre de 2026, o preço das casas em Portugal registou um aumento homólogo de 17,8%. No trimestre seguinte, os dados do INE para o 2.º trimestre de 2026 indicaram uma subida homóloga de 16,5% num contexto de redução de 6,4% no número de transações. Com os valores a evoluírem rapidamente, utilizar dados atualizados por agente de IA supera qualquer análise manual em folhas de cálculo, como explicado no artigo sobre comandos de ChatGPT para agentes imobiliários.
Porque é que a CASAFARI é nativa para agentes de IA?
A CASAFARI foi desenhada para interagir nativamente com modelos de linguagem e agentes autónomos, apresentando cinco caraterísticas estruturais:
- Uma conta partilhada: pessoas e agentes utilizam a mesma conta na consola e partilham o mesmo saldo de tokens.
- Autenticação OAuth no navegador: o utilizador inicia sessão na interface Web sem precisar de copiar ou expor chaves de API nas janelas de conversação.
- Ferramentas só de leitura por predefinição: 19 das 21 ferramentas MCP documentadas executam exclusivamente operações de leitura. As únicas 2 ferramentas que realizam escrita pedem confirmação expressa ao utilizador antes de executar.
- Documentação legível por máquinas: pontos de entrada estruturados como o ficheiro
llms.txt, esquemas OpenAPI e a especificação de autenticação facilitam a descoberta autónoma pelos agentes, conforme detalhado nos pontos de entrada legíveis por máquinas para agentes (em inglês). - Custos previsíveis por chamada: cada ferramenta especifica o custo fixo em tokens no seu esquema, permitindo ao agente calcular o consumo antes da execução.
A plataforma integra os diretórios de referência do setor, estando listada no diretório oficial de conectores do Claude (Claro AI), no Cursor Directory e no MCP Registry oficial sob o identificador com.casafari.
Os servidores MCP, um por produto
Cada produto da CASAFARI funciona como um servidor MCP independente em formato Streamable HTTP, protegido por OAuth 2.1 e acessível através de um URL próprio sob a plataforma.
Location Lookup
O Location Lookup é a ferramenta de entrada que converte nomes de zonas, concelhos ou freguesias (como Lisboa, Alvalade ou Vila Nova de Gaia) nos identificadores internos de localização. A utilização do servidor Location Lookup é gratuita e permanece sem custos mesmo após o período inicial de 30 dias do plano gratuito.
Area Insights
O servidor Area Insights inclui 7 ferramentas para análise territorial, fornecendo séries temporais de preços, distribuições por valor, tipologia e tempo em mercado, operações estatísticas como CAGR e volatilidade, e mapas de calor de mercado. É a ferramenta indicada para preparar relatórios de mercado por freguesia ou comparar rentabilidades antes de reuniões de angariação, podendo consultar mais detalhes na página sobre Insights de Área para estudos de mercado por zona.
Comparables
O servidor Comparables devolve imóveis comparáveis e estimativas de preço com base no histórico do mercado. É utilizado por peritos avaliadores, departamentos de risco bancário e consultores imobiliários. Pode verificar a versão para utilizadores humanos na página sobre as avaliações de imóveis e estudos de mercado da CASAFARI.
AgentGraph AI
O AgentGraph AI disponibiliza 13 ferramentas orientadas para a prospeção B2B de agências e agentes imobiliários. A sua cobertura atual é exclusiva para a Alemanha e restrita a empresas verificadas, permitindo mapear territórios e criar listas de acompanhamento (as únicas ferramentas que realizam escrita). Não cobre o mercado português.
Claro AI
O Claro AI foi concebido para a seleção de localizações comerciais e terrenos através de instruções em linguagem natural, integrando dados de Location Intelligence como tráfego pedonal e dados sociodemográficos. A sua cobertura abrange espaços comerciais em Espanha e lotes comerciais na Alemanha (não estando disponível para Portugal nesta fase). Em testes registados a 16 de outubro de 2026 com o Claude, os resultados demonstraram a capacidade do conector:
- Valência: um pedido para lojas entre 40 e 120 m² até 3.500 €/mês identificou 546 correspondências, filtradas pelo Claude para as 6 melhores opções;
- Espanha (Madrid e Barcelona): uma pesquisa para ginásios analisou 483 espaços até selecionar 7 candidatos com dossiê completo;
- Alemanha: um resumo para centros de inspeção automóvel triou 1.279 lotes industriais para uma lista final de 6 terrenos.
Pode consultar a documentação do Claro AI e inteligência de localização (em inglês) e os exemplos reais do Claro AI escritos pelo Claude (em inglês).
Property Sourcing e High Potential Seller Leads: só por REST, na mesma conta
Nem todos os produtos necessitam de uma interface MCP de conversação. O Property Sourcing e o High Potential Seller Leads estão disponíveis exclusivamente via API REST no endereço https://platform.casafari.com/v1/<produto>, utilizando a mesma conta e o mesmo saldo de tokens. A autenticação é feita com uma chave de API (cf_sk_…) enviada no cabeçalho Authorization: Bearer.
O Property Sourcing permite pesquisar o grafo global de imóveis, obter o registo unificado de um imóvel com todas as suas fontes de publicação e resolver hiperligações de portais imobiliários no registo correspondente. O High Potential Seller Leads identifica imóveis que registaram sucessivas reduções de preço de venda. Este produto devolve exclusivamente os dados de mercado do imóvel e não inclui nomes, números de telefone ou endereços de correio eletrónico de pessoas singulares. Saiba mais sobre a integração técnica na página sobre a Plataforma de Integração de Dados (API REST da CASAFARI).
Como criar conta e como funcionam os tokens
Para começar, basta criar conta na consola da plataforma (sem cartão). O Plano Gratuito atribui imediatamente 1.000 tokens válidos por 30 dias. Findo esse período, o produto Location Lookup continua a poder ser utilizado sem custos.
Para utilização contínua, a plataforma disponibiliza o plano Agent (subscrição mensal) e o plano Custom (sob contrato para clientes empresariais existentes). A utilização adicional é gerida através do carregamento de tokens pré-pagos. Os consumos são sempre contabilizados em tokens — o termo técnico utilizado na plataforma —, sendo o custo exato por chamada detalhado na documentação de cada ferramenta.
O consumo é rigorosamente controlado: quando os tokens do saldo terminam, o agente de IA interrompe as chamadas e notifica o utilizador. O agente nunca pode efetuar pagamentos autónomos; qualquer carregamento de saldo exige uma ação humana direta na consola.
Como ligar o Claude, o ChatGPT e outros clientes MCP
A configuração de um servidor MCP no assistente da sua preferência é simples e rápida:
- Claude (claude.ai, Claude Desktop e aplicação móvel): aceda a «Personalizar» → «Conectores» → «Adicionar conector personalizado», cole o URL do servidor MCP pretendido (por exemplo,
https://platform.casafari.com/mcp/comparables) e conclua a autenticação no navegador. Em contas Team ou Enterprise, o administrador da organização pode configurar o conector uma única vez para toda a equipa. - ChatGPT: ative o Modo de Programador, crie um novo conector com o URL do servidor MCP e configure a autenticação OAuth.
- Claude Code: execute o comando de linha de comandos:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparablesou utilize o suplemento disponível no repositório casafari-mcp no GitHub. - Gemini CLI: execute o comando:
gemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparablese efetue a autenticação com/mcp auth.
A plataforma é compatível com qualquer cliente MCP, incluindo Cursor, VS Code, Codex CLI, Zed, Cline, JetBrains Junie, Kiro, Warp e goose. A autenticação é feita no navegador através de OAuth, garantindo que nenhuma palavra-passe ou segredo é partilhado na janela de conversação. Para compreender o impacto operacional desta tecnologia, leia o artigo sobre como a IA agêntica automatiza o crescimento de uma imobiliária.
Para instruções detalhadas, consulte o guia de ligação para Claude, ChatGPT, Cursor e outros clientes MCP (em inglês).
Segurança: o que um agente pode e não pode fazer
A Plataforma API e MCP da CASAFARI utiliza o protocolo OAuth 2.1 com PKCE (Proof Key for Code Exchange) e registo dinâmico de clientes. O agente de IA nunca acede às credenciais do utilizador. Em conformidade com a especificação MCP de junho de 2025 sobre access tokens vinculados ao servidor, os access tokens de OAuth emitidos são vinculados a um único servidor (RFC 8707) e têm uma validade limitada a 15 minutos, enquanto os refresh tokens rodam a cada utilização.
Para agentes que operam de forma autónoma sem supervisão direta, o acesso é configurado através de uma chave de API ou de um cliente confidencial criado por uma pessoa na consola. As permissões, o plano ativo e o saldo de tokens são verificados em cada chamada executada.
Por conceção, as ferramentas tratam as respostas dos servidores estritamente como dados e não como instruções executáveis, prevenindo injeções de pedidos (prompt injection). Além disso, produtos como o High Potential Seller Leads fornecem exclusivamente métricas imobiliárias e dados de mercado, sem incluir contactos pessoais. Para enquadramento adicional sobre tratamento de dados, consulte a política de privacidade da CASAFARI e a documentação de segurança da plataforma (em inglês).
Quanto custa?
Os custos da plataforma variam consoante o volume de chamadas e o produto utilizado. Para consultar a estrutura detalhada de tokens por chamada, leia os planos e preços nas perguntas frequentes para programadores (em inglês). Se já é cliente da CASAFARI ou procura um plano feito à medida para a sua rede imobiliária, pode pedir um plano Custom a partir da plataforma (como funcionam os planos, em inglês). Pode também em que países está disponível a CASAFARI para confirmar a abrangência do grafo.
Por onde continuar
Para explorar a integração da CASAFARI na sua infraestrutura de inteligência artificial, pode iniciar sessão na plataforma ou consultar a documentação técnica nos casos de uso para programadores (em inglês). Pode igualmente visitar a página do produto CASAFARI MCP para uma visão geral da solução.
[Os casos de uso detalhados para agentes de IA estarão disponíveis em breve nesta secção.]
Perguntas frequentes
O que é a Plataforma API e MCP da CASAFARI?
É a plataforma self-service disponível em platform.casafari.com onde agentes de IA e equipas técnicas acedem aos dados do grafo de imóveis da CASAFARI em 16 países (EUA: em fase de entrada, estados selecionados, apenas imobiliário comercial, através do Claro AI), incluindo Portugal. O acesso é feito através de servidores MCP para assistentes de IA e de uma API REST para aplicações, partilhando uma única conta e um saldo comum de tokens. A plataforma disponibiliza um plano gratuito inicial de 1.000 tokens durante 30 dias sem necessidade de cartão de crédito.
Como ligo o Claude ou o ChatGPT aos dados imobiliários da CASAFARI?
No Claude, aceda às definições da sua conta em Personalizar, selecione Conectores, clique em Adicionar conector personalizado, insira o URL do servidor MCP do produto pretendido (por exemplo, https://platform.casafari.com/mcp/comparables) e efetue a autenticação no navegador. No ChatGPT, ative o Modo de Programador e crie um novo conector indicando o URL do servidor MCP e a autenticação OAuth. Não é necessário copiar nem introduzir manualmente chaves de API nas conversações.
Quanto custa usar a CASAFARI com um agente de IA?
Cada chamada efetuada por um agente de IA consome um número fixo de tokens indicado na descrição da respetiva ferramenta. O Plano Gratuito inclui 1.000 tokens para utilização durante os primeiros 30 dias, mantendo-se a ferramenta Location Lookup gratuita após esse período. Para uma utilização contínua, estão disponíveis o plano Agent com subscrição mensal, o plano Custom para empresas e pacotes de tokens pré-pagos para consumos adicionais.
Um agente de IA pode gastar dinheiro na minha conta CASAFARI?
Não. O agente de IA apenas consome tokens a partir do saldo previamente carregado na conta por uma pessoa. Quando o saldo de tokens se esgota, as chamadas do agente são interrompidas e apenas um utilizador humano pode efetuar novos carregamentos ou alterar o plano na consola. A plataforma valida as permissões, o plano e o saldo disponível em cada chamada efetuada.
Que dados de Portugal posso consultar por MCP?
Através de MCP, pode utilizar o Location Lookup para identificar localizações portuguesas, o Area Insights para obter séries temporais de preços, distribuições e mapas de calor por freguesia ou concelho, e o Comparables para aceder a imóveis comparáveis e estimativas de avaliação em Portugal. Adicionalmente, os produtos Property Sourcing e High Potential Seller Leads cobrem o mercado português via API REST. Os servidores AgentGraph AI e Claro AI não cobrem o mercado português atualmente.
É seguro dar a um agente de IA acesso aos dados da CASAFARI?
A plataforma utiliza autenticação OAuth 2.1 com access tokens vinculados ao servidor e válidos por 15 minutos, garantindo que o agente nunca acede à palavra-passe do utilizador. A grande maioria das ferramentas MCP (19 em 21) é estritamente de leitura, e os dados devolvidos focam-se em métricas de mercado sem incluir dados de contacto de pessoas singulares. A avaliação da adequação do acesso às políticas internas da organização cabe a cada utilizador.