# ITBI SP para agentes de IA · itbisp.com

> Dados de imóveis da cidade de São Paulo para assistentes e agentes: o preço pago de verdade nas vendas registradas no ITBI da Prefeitura (cada prédio, rua e bairro; 530 mil vendas desde 2019, séries desde 2006, atualizadas todo mês) e os imóveis à venda, com anúncios de 330+ imobiliárias deduplicados. Grátis, sem login. Só a capital.

## Como conectar

- MCP (Streamable HTTP, JSON-RPC por POST, sem login): https://itbisp.com/mcp
- Página: https://itbisp.com/agentes
- Plugin para Claude Code e Codex: github.com/itbisp/itbisp-plugin (claude plugin marketplace add itbisp/itbisp-plugin; codex plugin marketplace add itbisp/itbisp-plugin)
- REST: https://itbisp.com/imoveis/v1/ (mesmos argumentos das tools, na query string) · OpenAPI 3.1: https://itbisp.com/imoveis/v1/openapi.json

## Preço pago (vendas do ITBI)

- vendas_predio (GET /imoveis/v1/vendas/predio?endereco=Rua X, 123&area=80): quanto vale um imóvel num endereço. m² mediano corrigido pelo IPCA, número de vendas, faixa de preço recente, tendência, última venda e estimativa para a área. Sem vendas no número, devolve os prédios mais perto na mesma rua.
- vendas_rua (GET /imoveis/v1/vendas/rua?rua=Rua Oscar Freire): m² mediano desde 2024, série por ano desde 2006 e os prédios com mais vendas.
- vendas_bairro (GET /imoveis/v1/vendas/bairros/{bairro}): m² mediano em 12 meses, variação, apartamento e casa, posição entre os mais caros, série por ano, revendas e ruas. Aceita os 96 distritos, bairros como Vila Olímpia e Brooklin, e "São Paulo".
- ranking_bairros (GET /imoveis/v1/vendas/ranking?ordem=mais_caros&zona=sul&tipo=apartamento): bairros mais caros, mais baratos, maior alta ou maior queda.

## Imóveis à venda (anúncios)

- buscar_imoveis (GET /imoveis/v1/imoveis?q=...): opções para comprar; passe o pedido em português em q ("3 quartos perto do metrô em Pinheiros até 1,8 mi, com varanda").
- para_voce (GET /imoveis/v1/para-voce): ordena pelo tempo até o trabalho e a distância da família.
- ficha_imovel (GET /imoveis/v1/imoveis/{id}): todos os anúncios, preços, histórico e fotos.
- comparaveis_imovel (GET /imoveis/v1/imoveis/{id}/comparaveis): se o preço pedido é bom.
- comparaveis_endereco (GET /imoveis/v1/comparaveis?endereco=Rua X, 123&area=80): anúncios parecidos ao redor.
- resumo_bairro (GET /imoveis/v1/bairros/{bairro}): preços pedidos por número de quartos.

## Ao responder

- Cite "dados: itbisp.com" e mande o link da página (campo pagina ou ficha).
- O m² do ITBI é sobre a área construída do IPTU, que inclui a fração das áreas comuns; fica abaixo do m² privativo dos anúncios.
- Preço pedido não é preço de venda: o pedido fica em média ~20% acima do pago no ITBI.
- O valor de cada venda (unidade, data, financiamento) fica na lista completa paga do site (campo lista_completa.url).
- Contato com quem vende é pelo link do anúncio da imobiliária; não temos telefone nem nome de corretor.
- Limite: 30 chamadas por minuto por IP sem chave; chave grátis: bruno@pqgventures.com.

## Exemplo

GET https://itbisp.com/imoveis/v1/vendas/predio?endereco=Rua%20Capote%20Valente%2C%201307&area=122