API e MCP de imóveis à venda em São Paulo

Peça para o Claude, o ChatGPT ou o seu agente procurar imóvel para você: “3 quartos perto do metrô em Pinheiros até 1,8 mi, com varanda”. A resposta vem com opções reais, o link de cada imóvel e o anúncio mais barato entre as imobiliárias.

São anúncios de 330+ imobiliárias da cidade de São Paulo, com cada imóvel aparecendo uma vez só. Para cada um dizemos se o preço pedido está abaixo, no preço ou acima de imóveis parecidos, e mostramos o que foi pago de verdade no prédio, pelas vendas registradas no ITBI da Prefeitura. Só venda e só a capital. É grátis.

https://itbisp.com/imoveis/mcpMCP · Streamable HTTP · sem login

Usar no Claude

Abra Configurações → Conectores (no Claude ou no Claude Desktop).
Clique em Adicionar conector personalizado, dê o nome Imóveis SP (itbisp) e cole a URL acima.
Numa conversa, ligue o conector em Pesquisa e ferramentas e faça o pedido.

Conectores personalizados existem nos planos Pro, Max, Team e Enterprise. No Team e no Enterprise, quem adiciona é o dono da organização.

Claude Code

claude mcp add --transport http itbisp-imoveis https://itbisp.com/imoveis/mcp

Usar no ChatGPT

No ChatGPT pela web, abra Plugins, clique em + e escolha Add custom MCP server.
Dê um nome, cole a URL acima e deixe sem autenticação.
Confirme o aviso de segurança, crie o plugin e use numa conversa nova.

A disponibilidade depende do plano e das permissões do workspace. Para GPTs com Actions, use o OpenAPI.

Ferramentas

Tool	REST	Quando usar
`buscar_imoveis`	`GET /imoveis/v1/imoveis`	Opções para comprar. Aceita o pedido em português em `q` e devolve os `termos_entendidos`; os campos estruturados (bairro, estação, preço, quartos, características, cobertura...) refinam.
`para_voce`	`GET /imoveis/v1/para-voce`	Quando importam trabalho, escola ou família: ordena por tempo de trajeto e distância, com nota, motivos e alertas.
`ficha_imovel`	`GET /imoveis/v1/imoveis/{id}`	Todos os anúncios, preços, histórico, fotos, descrição e o ITBI do prédio.
`comparaveis_imovel`	`GET /imoveis/v1/imoveis/{id}/comparaveis`	“Esse preço é bom?”: os parecidos usados na conta e as vendas pagas no prédio.
`comparaveis_endereco`	`GET /imoveis/v1/comparaveis`	“Quanto vale meu apê na Rua X, 123?”
`resumo_bairro`	`GET /imoveis/v1/bairros/{bairro}`	Preços típicos de um bairro, por número de quartos, e o pago no ITBI.

Exemplos

curl 'https://itbisp.com/imoveis/v1/imoveis?q=3+quartos+perto+do+metr%C3%B4+em+Pinheiros+at%C3%A9+1,8+mi+com+varanda&limite=3'

curl 'https://itbisp.com/imoveis/v1/para-voce?q=trabalho+na+Av.+Paulista,+meus+pais+moram+no+Tatuap%C3%A9,+at%C3%A9+1,3+mi,+3+quartos'

curl -X POST https://itbisp.com/imoveis/mcp -H 'content-type: application/json' -d '{
  "jsonrpc":"2.0","id":1,"method":"tools/call",
  "params":{"name":"buscar_imoveis","arguments":{"q":"studio até 450 mil perto da estação Faria Lima","limite":3}}}'

Cada imóvel traz preço, R$/m², nivel_preco (abaixo do mercado, no preço, acima, 30%+ acima), metrô mais próximo e distância, características lidas do anúncio, etiquetas pela foto, quantos outros estão à venda no mesmo prédio, o link da ficha (ficha) e o do anúncio mais barato (anuncio_menor_preco.url).

Regras de uso

Cite “dados: itbisp.com” ao mostrar os resultados.
Contato é sempre pelo anúncio da imobiliária. Não temos nem devolvemos nome, telefone ou e-mail de corretor.
Preço pedido não é preço de venda. O pedido costuma ficar uns 20% acima do pago no ITBI, que aparece em campo separado.
Limite: 30 chamadas por minuto por IP. Para mais volume, mande a chave em X-API-Key; peça uma em bruno@pqgventures.com.

Arquivos para máquinas: /imoveis/llms.txt · /imoveis/v1/openapi.json · /imoveis/v1/ferramentas