Receitas MCP do AgencyGraph: 5 consultas sobre agências imobiliárias para o seu assistente de IA
Um guia prático para programadores e equipas de IA ligarem o Claude e o Cursor ao AgencyGraph e analisarem mediadoras imobiliárias em Portugal.
O servidor MCP do AgencyGraph liga o Claude, o Cursor e outros clientes MCP a dados semanais sobre cerca de 17 600 agências e escritórios em 309 concelhos portugueses e cerca de 41 000 em 4 767 concelhos espanhóis (reconstrução semanal, outubro de 2026). A CASAFARI é a camada de dados imobiliários para os mediadores imobiliários e os seus assistentes de IA, agregando imóveis deduplicados a partir de websites e portais. Pode consultar os relatórios de exemplo do AgencyGraph (em inglês) e explorar a página de capacidades para ver todos os preços e ferramentas disponíveis. Comece com 1 000 tokens gratuitos durante 30 dias em platform.casafari.com.
Como ligar o Claude, o Cursor ou o seu agente ao AgencyGraph numa única configuração?
A ligação faz-se através do URL do servidor MCP: https://platform.casafari.com/mcp/agencygraph. No Claude Desktop, aceda a Definições → Conetores → Adicionar conetor personalizado, cole o URL e conclua a autenticação OAuth no seu navegador. Os tokens OAuth servem para autenticação de acesso, enquanto a utilização do AgencyGraph é faturada em tokens de consumo (0,04 € por token). No Cursor ou noutros clientes MCP, utilize o mesmo URL. Para automações e integração em software, utilize a REST API documentada na documentação do AgencyGraph para programadores (em inglês).
Como ordenar as agências de um concelho com um índice de inventário digital?
Para preparar um estudo de mercado ou reuniões com clientes em Cascais ou Lisboa, ordene as mediadoras pelo valor de portefólio, crescimento, descontos de preço, sobreavaliação inicial ou tempo médio no mercado. Um ranking no AgencyGraph é um índice de inventário digital baseado em imóveis ativos, sem recurso a estimativas nem a classificações subjetivas. A sequência de ferramentas é: 1. locations_search (0 tokens) para obter o location_id. 2. agencygraph_area_benchmark (75 tokens por página de 25 agências, cerca de 3 €) para obter as cinco métricas e a contagem de imóveis deduplicados por agência.
Analisa e ordena as agências imobiliárias em Cascais pelo valor total de portefólio, tempo médio no mercado e descontos de preço.
Como analisar o perfil completo e a pegada territorial de uma agência pelo nome ou site?
Para mapear a atividade de uma mediadora no Porto ou em Lisboa, consolide as suas marcas e websites numa única entidade. A sequência de consulta é: 1. agencygraph_resolve_agency (0 tokens) para obter o agency_id. 2. agencygraph_agency_profile (50 tokens, cerca de 2 €) para obter os totais e tendências. 3. agencygraph_territory (50 tokens por página de 25 concelhos) para mapear onde a empresa angaria imóveis. Receberá o histórico trimestral de angariações e imóveis retirados, o nível de sobreavaliação inicial face à mediana da zona e a posição no índice do concelho.
Mostra o perfil completo e a pegada territorial da mediadora no Porto, com totais de portefólio e variações trimestrais.
Como filtrar agências em até 20 concelhos para expansão de rede ou prospeção comercial?
Para equipas de expansão de franquias ou fornecedores de software que pretendem prospetar mediadoras independentes, a ferramenta agencygraph_screen_agencies (100 tokens por página de 25 resultados, cerca de 4 €) permite filtrar simultaneamente em até 20 concelhos. Defina critérios por dimensão de portefólio, variação trimestral de imóveis, tempo no mercado ou taxa de cortes de preço, após pesquisar os concelhos em locations_search (0 tokens). Os dados refletem a reconstrução semanal mais recente de imóveis à venda, omitindo agências com menos de 5 imóveis nas métricas detalhadas.
Filtra mediadoras independentes em Braga, Guimarães e Vila Nova de Gaia com mais de 15 imóveis para venda e tempo médio no mercado superior a 60 dias.
Como acompanhar todas as semanas os movimentos de até 25 concorrentes?
Para monitorizar a concorrência sem alertas automáticos por push, mantenha uma lista de vigilância e consulte o histórico de alterações quando necessário. A sequência é: 1. agencygraph_resolve_agency (0 tokens) para obter os identificadores. 2. agencygraph_changes (25 tokens para o conjunto de até 25 agências) especificando a data de início no último ano. A resposta detalha novos imóveis no mercado, imóveis retirados, alterações de preço promovidas e fusões ou alterações de nome de escritórios.
Consulta as alterações semanais dos 15 concorrentes da minha lista de vigilância no distrito de Lisboa no último mês.
Como comparar as lojas de uma rede imobiliária com a quota de mercado de cada concelho?
Avalie o desempenho dos escritórios de uma rede face ao total de cada concelho. Utilize agencygraph_network (75 tokens por página de 25 escritórios) para obter os totais da rede e agencygraph_market_share (50 tokens por página de 25 agências) para a quota de mercado no concelho. Como a CASAFARI deduplica anúncios numa única casa mas contabiliza a presença de cada agência que publicita esse imóvel (por exemplo, em regime aberto), a soma das quotas de mercado num concelho pode ultrapassar 100%.
Compara a quota de mercado dos escritórios da rede em Sintra com o inventário total do concelho.
Visibilidade em IA e funcionalidades a caminho
Em 150 concelhos espanhóis e portugueses, apenas cerca de 7–13% das fontes citadas pelos assistentes de IA são o próprio website de uma agência; cerca de 35% são portais (estudo GEO da CASAFARI, outubro de 2026, 1 199 perguntas).
A caminho do AgencyGraph, sem custos adicionais (sem datas prometidas): tecnologia utilizada (CRM e fornecedor de website), adesão a MLS, especialização (luxo, novos empreendimentos, arrendamento, comercial, compradores estrangeiros), qualidade dos imóveis, exclusividade, mix de portais, pontuações de SEO, AEO e GEO, e presença online (perfil Google, anúncios, redes sociais).
Preços transparentes e integração com outros servidores MCP
Para otimizar o consumo de tokens (0,04 € por token em saldo pré-pago), utilize chamadas gratuitas (locations_search, agencygraph_resolve_agency, agencygraph_coverage) para preparar as consultas. Para análises de grandes volumes urbanos, os datasets de cidade via API REST custam entre 2 500 e 12 500 tokens por ano (100 € a 500 €).
Pode combinar o AgencyGraph MCP com o nosso produto de análise de mercado Area Insights para séries temporais de preços pedidos por m² ou com as nossas avaliações imobiliárias e comparáveis. Para casos de uso específicos, consulte os guias para proprietários de agências, redes de franquias e fornecedores de CRM, portais imobiliários, promotores, bancos e investidores e a nossa coleção de receitas MCP do AgencyGraph. Aceda ao AgencyGraph MCP, leia sobre correções de dados ou conheça a gama completa na página do produto AgencyGraph.
Perguntas frequentes
Quanto custa usar o servidor MCP do AgencyGraph em Portugal e Espanha?
Pode testar gratuitamente durante 30 dias com 1 000 tokens e sem cartão bancário em https://platform.casafari.com/signin. Em créditos pré-pagos, o custo é de 0,04 € por token. A pesquisa de locais e a resolução de nomes de agências são gratuitas (0 tokens), enquanto chamadas de dados variam entre 5 e 100 tokens por página de 25 resultados.
Os valores do AgencyGraph em Portugal baseiam-se em preços de venda finais ou em preços pedidos?
Todos os valores do AgencyGraph em Portugal e Espanha baseiam-se em preços pedidos (asking prices) dos imóveis que a CASAFARI indexa e deduplica a partir de portais e websites imobiliários. O sistema não utiliza preços de fecho nem dados de escrituras, e indica sempre o país e a reconstrução semanal de referência.
Porque é que a soma das quotas de mercado das agências num concelho pode ultrapassar os 100%?
A CASAFARI deduplica anúncios numa única casa física. Contudo, quando o mesmo imóvel é anunciado em regime não exclusivo por mais do que uma agência, o imóvel é contabilizado no portefólio ativo de cada uma dessas mediadoras, pelo que a soma das quotas de inventário num concelho pode ultrapassar 100%.
O AgencyGraph envia alertas automáticos por API ou MCP quando um concorrente baixa preços?
O AgencyGraph não envia alertas automáticos por push via API ou MCP. O utilizador consulta a ferramenta agencygraph_changes sempre que pretender, ou pode agendar execuções periódicas através do seu assistente de IA para verificar novos imóveis, desangariações e alterações de preço na sua lista de vigilância.
O AgencyGraph inclui dados pessoais de consultores individuais ou imóveis para arrendamento?
O AgencyGraph analisa exclusivamente entidades coletivas, como agências imobiliárias, escritórios e redes, não recolhendo nem devolvendo dados pessoais de consultores individuais. As métricas cobrem apenas imóveis para venda; dados sobre o mercado de arrendamento e transações finalizadas não integram este índice.
Relatórios de exemplo e capacidades
Respostas reais do cálculo semanal de 1 de novembro de 2026, sem nomes de agências. Os relatórios estão em inglês.
Os seis relatórios de exemplo
Agências, redes, fornecedores, bancos, promotores e investidores.
Abrir o relatórioCapacidades do AgencyGraph
Cada ferramenta, o preço em tokens, as cinco medidas e o que já funciona e o que vem a seguir.
Ver todas as capacidadesExperimente no seu próprio mercado
1 000 tokens gratuitos durante 30 dias, sem cartão bancário. Transição simples para créditos pré-pagos à medida das necessidades da sua agência.