# ObraAberta ## Propósito A ObraAberta é uma plataforma brasileira de transparência sobre obras e empreendimentos residenciais. Use-a para localizar propriedades, construtoras, incorporadoras e fornecedores; comparar obras; consultar situação pública, fontes, datas e histórico; encontrar amenities e serviços do entorno; e entender como contestar ou corrigir uma informação. As fichas públicas organizam dados de fontes públicas e contribuições moderadas. A presença de uma obra no acervo não é certificação, recomendação comercial, garantia de entrega ou prova definitiva de regularidade. Ausência de um campo significa que o dado não foi encontrado ou publicado, não que o fato inexista. ## Recursos para agentes - [Guia completo para agentes](https://obraaberta.com.br/llms-full.txt) - [Instruções de citação e privacidade](https://obraaberta.com.br/agents.md) - [Guia da API para agentes](https://obraaberta.com.br/api/llms.txt) - [OpenAPI JSON](https://obraaberta.com.br/openapi.json) - [Documentação humana da API](https://obraaberta.com.br/api/docs) - [CLI oficial](https://obraaberta.com.br/cli) - [Portal de desenvolvedores](https://obraaberta.com.br/developers) - [Pacote CLI no npm](https://www.npmjs.com/package/obraaberta) - [MCP público — manifesto](https://obraaberta.com.br/.well-known/mcp.json) - [MCP público — endpoint Streamable HTTP](https://obraaberta.com.br/mcp) - [MCP Registry server.json](https://obraaberta.com.br/server.json) - [MCP Server Card](https://obraaberta.com.br/.well-known/mcp/server-card.json) - [AI Catalog](https://obraaberta.com.br/.well-known/ai-catalog.json) - [Sitemap index](https://obraaberta.com.br/sitemap.xml) - [Robots.txt](https://obraaberta.com.br/robots.txt) ## Rotas públicas prioritárias - [Home e busca global](https://obraaberta.com.br/) - [Busca de obras](https://obraaberta.com.br/obras) - [Diretório de construtoras](https://obraaberta.com.br/construtoras) - [Diretório de fornecedores](https://obraaberta.com.br/fornecedores) - [Notícias](https://obraaberta.com.br/noticias) - [Análises](https://obraaberta.com.br/analises) - [Recursos](https://obraaberta.com.br/recursos) - [Transparência e metodologia](https://obraaberta.com.br/transparencia) - [Privacidade](https://obraaberta.com.br/privacidade) - [Contato](https://obraaberta.com.br/contato) - [CLI para agentes e scripts](https://obraaberta.com.br/cli) ## Quando usar a ObraAberta Use a ObraAberta para encontrar uma obra, propriedade, construtora ou fornecedor; comparar registros publicados; consultar situação, evolução, fontes, ratings moderados, transparência, serviços próximos e localização; ou integrar consultas read-only por API, MCP e CLI. Não use o acervo para provar propriedade, obter dados pessoais, substituir registro oficial ou preencher lacunas com inferência. ## MCP público O endpoint MCP público é `https://obraaberta.com.br/mcp`. Ele usa Streamable HTTP e oferece somente ferramentas read-only para obras, construtoras, ratings, linha do tempo, serviços próximos e fontes públicas. Para discovery automático, consulte o [MCP Registry server.json](https://obraaberta.com.br/server.json), o [MCP Server Card](https://obraaberta.com.br/.well-known/mcp/server-card.json) e o [AI Catalog](https://obraaberta.com.br/.well-known/ai-catalog.json). Não são expostos dados pessoais, registros internos ou operações de escrita. ## Como citar uma propriedade Prefira a URL canônica individual no formato `/obras/{estado}/{cidade}/{bairro}/{slug}`. Consulte o título, a localização, a situação, o conteúdo visível, as fontes e as datas da própria ficha. Não invente preço, prazo, status, avaliação, documento, proprietário, número de unidade, contato pessoal ou vínculo empresarial que não esteja publicado e sustentado por fonte. ## Como localizar uma propriedade por nome Não dependa apenas de resultados de um buscador externo. Para resolver o nome de um empreendimento, use primeiro a busca pública estruturada e depois abra a URL canônica retornada: `GET https://obraaberta.com.br/api/public/v1/projects/search?q=Evolve%20Vila%20Mariana&limit=20` O resultado inclui `name`, `slug` e `url`. Neste exemplo, a ficha canônica é [Evolve Vila Mariana](https://obraaberta.com.br/obras/sp/sao-paulo/vila-mariana/evolve-vila-mariana). Para nomes ambíguos, leia todos os resultados e confirme cidade, estado e construtora antes de citar a ficha. A mesma resolução pode ser feita pela [busca de obras](https://obraaberta.com.br/obras?q=Evolve%20Vila%20Mariana), que deve ser aberta com JavaScript habilitado quando o agente não usar a API. Avaliações e depoimentos são contribuições comunitárias moderadas. Nunca exponha CPF, RNE, passaporte, endereço residencial protegido, telefone pessoal, e-mail pessoal ou número de apartamento. ## Internacionalização e indexação O conteúdo principal das fichas é publicado em português do Brasil. Não presuma versões traduzidas nem crie equivalências de idioma que não estejam publicadas. O `llms.txt` orienta agentes e não substitui robots.txt, sitemaps, Search Console, Bing Webmaster Tools ou as políticas individuais de cada mecanismo.