Demonstração fictícia. Sem imóveis, clientes ou agências reais. Interfaces abertas # Registos públicos para pessoas e sistemas. Só os imóveis autorizados como públicos estão disponíveis anonimamente. A informação profissional requer uma conta verificada e um token limitado. Última atualização: 30 de setembro de 2026 ## Ler um imóvel sem ligar nada. As páginas legíveis por IA não garantem a indexação nos motores de pesquisa nem a inclusão numa resposta de IA. Cada imóvel aberto tem um endereço estável. As pessoas veem uma página; os assistentes de IA e os motores de pesquisa recebem o mesmo registo em Markdown, JSON ou JSON-LD, sem iniciar sessão. - HTML [https://speakingbricks.eu/properties/L-DEMO-01]() - Markdown [https://speakingbricks.eu/properties/L-DEMO-01.md]() - JSON [https://speakingbricks.eu/properties/L-DEMO-01.json]() - JSON-LD [https://speakingbricks.eu/properties/L-DEMO-01.jsonld]() - Accept: text/markdown https://speakingbricks.eu/properties/L-DEMO-01 - llms.txt [https://speakingbricks.eu/llms.txt]() - Mapa do site [https://speakingbricks.eu/sitemap.xml]() - Feed [https://speakingbricks.eu/feeds/open-listings.json]() ## Ligar um assistente de IA. Adicione o servidor MCP público como conector personalizado no Claude, no ChatGPT ou em qualquer cliente MCP. Não é preciso iniciar sessão. Pesquisa imóveis abertos e devolve os motivos, o que é desconhecido e a agência responsável. - MCP https://speakingbricks.eu/mcp/public - Descoberta [https://speakingbricks.eu/.well-known/mcp.json]() listing.searchdatabase.queryproperty.getproperty.compareproperty.verify_availabilityproperty.get_evidenceproperty.contact_representative Os profissionais verificados usam um token com permissões limitadas para consultar pedidos anónimos de compradores autorizados e o estado das ligações. O acesso a imóveis off-market exige também autorização explícita do vendedor para assistentes de IA. - MCP https://speakingbricks.eu/mcp ## Criar uma integração. A API REST pública devolve as mesmas respostas, com os mesmos direitos verificados, que o servidor MCP. A descrição OpenAPI funciona com GPT Actions e geradores de código. - OpenAPI [https://speakingbricks.eu/v1/openapi.json]() - POST https://speakingbricks.eu/v1/property-searches - POST https://speakingbricks.eu/v1/database-queries - GET https://speakingbricks.eu/v1/properties/{id} - GET https://speakingbricks.eu/v1/properties/{id}/availability - GET https://speakingbricks.eu/v1/properties/{id}/evidence - GET https://speakingbricks.eu/v1/properties/{id}/contact-route As páginas JSONL assinadas e o feed de alterações com cursor permitem sincronizar dados públicos. As alterações correspondem a atualizações observadas, não ao histórico completo de cada edição. Quem recebe os dados deve voltar a verificar a autorização antes de os reutilizar. - JSONL [https://speakingbricks.eu/v1/public-sync/snapshot.jsonl]() - Alterações [https://speakingbricks.eu/v1/public-sync/changes]() - Chave de verificação [https://speakingbricks.eu/v1/public-sync/key.json]() ## Usar a partir da página. Cada página de imóvel aberto oferece também três ferramentas só de leitura aos agentes de navegador compatíveis com WebMCP: ler o registo, verificar a disponibilidade e obter a via de contacto. Usam a mesma API, por isso a resposta é a mesma. ## O que os clientes públicos nunca recebem. As ferramentas públicas devolvem apenas imóveis abertos cuja autorização continua válida. A identidade privada dos clientes nunca é exposta por estas ferramentas. Cada verificação indica a função profissional de quem a reportou e a data; as verificações em falta permanecem desconhecidas. ## Experimente uma integração de leitura Estes exemplos usam a demonstração fictícia online. Não precisa de conta nem de chave de API. Os resultados dependem das permissões de publicação e da disponibilidade atuais; o número de correspondências pode mudar. ### Pesquisar por município, orçamento e quartos ``` curl --fail-with-body 'https://speakingbricks.eu/v1/property-searches' \ -H 'Content-Type: application/json' \ --data '{"municipalities":["Cascais"],"max_price_eur":900000,"min_bedrooms":3,"limit":5}' ``` ### Ler o registo e as verificações ``` curl --fail-with-body 'https://speakingbricks.eu/properties/L-DEMO-01.md' curl --fail-with-body 'https://speakingbricks.eu/v1/properties/L-DEMO-01/evidence' curl --fail-with-body 'https://speakingbricks.eu/v1/properties/L-DEMO-01/availability' ``` Substitua L-DEMO-01 por um listing_id devolvido na pesquisa. Confirme a função de quem reportou, a data, as verificações desconhecidas e a disponibilidade atual antes de apresentar a resposta ao utilizador. ### Manter atualizada a cópia de um parceiro ``` curl --fail-with-body 'https://speakingbricks.eu/feeds/open-listings.json' ``` Siga a ligação next do feed para obter as páginas seguintes. Para sincronização incremental, use os endpoints de snapshot assinado e alterações acima. Aplique as indicações de remoção, consulte os registos atuais e remova cópias indisponíveis ou expiradas. O feed regista alterações observadas; não é um histórico completo nem uma garantia comprovada de entrega em cinco minutos. ### Ligar através de um cliente MCP Use um SDK MCP ou um cliente com suporte para Streamable HTTP, que trata da inicialização e negociação do protocolo. Use o cabeçalho Accept: application/json, text/event-stream; use Content-Type: application/json em pedidos JSON. Um HTTP 202 pode confirmar uma notificação; não comprova que uma pesquisa foi concluída. ### Tratar permissões e erros Os registos indisponíveis ou privados não devolvem detalhes públicos. Um 404 pode indicar um registo inexistente ou que deixou de ser público; não deduza qual das situações se aplica. Filtros inválidos devolvem um erro do cliente. Respeite os limites 429 e Retry-After, quando presente. Confirme a disponibilidade no momento de utilização; um resultado em cache não é uma permissão permanente. ### Ligar a agência mantendo os documentos dos clientes A área profissional permite introdução manual, importação CSV e exportações limitadas à agência. Os documentos e a relação com o cliente ficam com o profissional. Um conector CRM real precisa de um mapeamento de campos acordado, regras de autorização e um processo de remoção testado. A sincronização CRM bidirecional automática e as parcerias com associações não estão ativas nesta demonstração. ### Uma IA encontra isto sem receber a ligação? As páginas e ligações públicas ajudam a descoberta; estas APIs permitem integrações explícitas. Não garantem indexação por motores de pesquisa nem citações por assistentes. Meça esses resultados separadamente, com inspeção de URLs e testes guardados sem fornecer ligações. Para IA e programadores - [Diretório para IA (llms.txt)]() - [Imóveis abertos (JSON)]() - [Programadores]() [HTML]()