Saltar para o conteúdo
Demonstração fictícia. Sem imóveis, clientes ou agências reais.Entrar
Speaking BricksUma rede imobiliária profissional
Registar com convite
Menu

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:

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.

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.

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.

  • MCPhttps://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.

  • OpenAPIhttps://speakingbricks.eu/v1/openapi.json
  • POSThttps://speakingbricks.eu/v1/property-searches
  • POSThttps://speakingbricks.eu/v1/database-queries
  • GEThttps://speakingbricks.eu/v1/properties/{id}
  • GEThttps://speakingbricks.eu/v1/properties/{id}/availability
  • GEThttps://speakingbricks.eu/v1/properties/{id}/evidence
  • GEThttps://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.

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.