Automatizar anúncios imobiliários com Terraform: apresento o provider Immobilienscout24

Introdução#

Enquanto alguém que passou mais de 15 anos a conceber, a construir e a proteger infraestruturas na cloud, a automação está no meu ADN. A minha carreira abrangeu os setores fintech, mobilidade, gaming e health tech, liderando equipas de engenharia de alto desempenho e otimizando sistemas complexos para escala, resiliência e custo. Em cada etapa, Infrastructure as Code (IaC) tem sido um pilar fundamental para entregar resultados fiáveis e reproduzíveis.

Parece-me que o mundo imobiliário está atrasado. Enquanto procurava um apartamento em Berlin — uma tarefa que não é para os fracos de coração —, reparei numa coisa recorrente: alguns anúncios ficam disponíveis por muito pouco tempo, por isso publicar ou atualizar anúncios imobiliários deve ser tedioso para os senhorios e gestores imobiliários. Parece ser um processo manual, mesmo para negócios de grande escala, e atualizar o conteúdo deve ser um pesadelo. Foi aí que surgiu a ideia de um Immobilienscout24 Terraform provider open-source.

Por que construí o Immobilienscout24 Terraform provider#

Immobilienscout24 é um dos portais imobiliários mais populares da Alemanha. Ainda assim, a sua integração com workflows cloud-native é quase inexistente, com poucas exceções dignas de nota, como o GetTheFlat (e mesmo esse tem poucas funcionalidades).

A minha motivação era simples:

• Reduzir o atrito para equipas de Ops que gerem portfólios imobiliários.

• Dar às empresas "automation-minded" o poder de publicar anúncios tal como deveriam automatizar a sua infraestrutura na cloud, com controlo de versões e CI/CD.

• Incentivar o ecossistema imobiliário a adotar o open source e as melhores práticas modernas.

Acredito que qualquer processo repetitivo, quer seja pôr servidores a funcionar ou publicar apartamentos, merece automação.

A quem se destina?#

Este provider destina-se a:

• Agências imobiliárias, startups de SaaS e equipas de proptech (não faço ideia se o termo existe) equipas que queiram automatizar a criação de anúncios e manter a paridade entre várias plataformas — talvez, no futuro, com um módulo Terraform multi-provider.

• Engenheiros de cloud ou consultores técnicos que trabalham para clientes do setor imobiliário e precisam de auditabilidade, rollback e repetibilidade nos anúncios.

• Entusiastas de open-source com vontade de fazer a ponte entre as indústrias tradicionais e o poder da automatização de infraestruturas.

Se alguma vez pensaste: «Porque é que ainda ando a clicar num portal para publicar imóveis?»… isto é para ti.

Como funciona#

O Immobilienscout24 Terraform provider é um MVP que te permite inserir um novo anúncio imobiliário através da API oficial. Usa autenticação OAuth1 e foi construído com a moderna Terraform Plugin Framework.

Exemplo de utilização#

Quero esclarecer que este processo pode mudar assim que o provider for construído e publicado automaticamente. Dito isto, depois de criação do provider a partir do código-fonte, podes automatizar um anúncio com apenas algumas linhas de código:

provider "immobilienscout24" {
  consumer_key        = "YOUR_CONSUMER_KEY"
  consumer_secret     = "YOUR_CONSUMER_SECRET"
  access_token        = "YOUR_ACCESS_TOKEN"
  access_token_secret = "YOUR_ACCESS_TOKEN_SECRET"
}

resource "immobilienscout24_realestate" "listing" {
  title            = "Modern Apartment"
  description_note = "Listed via Terraform!"
  street           = "Sample Street"
  house_number     = "5A"
  postcode         = "10115"
  city             = "Berlin"
}

Executar terraform apply vai criar um novo anúncio na tua conta do Immobilienscout24 (usando a API de sandbox deles, por agora).

Os obstáculos: obter acesso à API#

Arrancar com a construção do provider tem sido ótimo, e grande parte disso deveu-se à documentação oficial da API do ImmoScout e à fantástica documentação oficial do Terraform.

O verdadeiro desafio? Obter acesso à API do Immobilienscout24. Quando pedi as credenciais da API, deparei-me com uma série de perguntas sobre open source, Terraform e a finalidade de utilização. Na maior parte, perguntas normais — mas fiquei com a sensação de que a equipa de suporte nunca tinha lidado com ferramentas de infrastructure-as-code nem consultado as suas equipas de desenvolvimento internas.

Esclareceram ainda que o acesso à API não é gratuito, criando mais uma barreira para inovadores e projetos comunitários — e, por consequência, impedindo-me de testar de facto o provider na vida real.

Serve para lembrar que, embora a tecnologia avance depressa, as grandes organizações, startups e líderes do setor podem demorar a acompanhar os movimentos de open-source e automação. Espero que, ao lançar este provider, consiga dar início à conversa, mostrar o verdadeiro valor da comunidade open-source e incentivar plataformas como a Immobilienscout24 a investir mais em ferramentas acessíveis para developers.

Próximos passos: expandir o provider#

Isto é apenas o começo! Tenciono acrescentar:

• Suporte para read, update e delete para anúncios imobiliários.

• Tipos de recursos adicionais, tais como fontes de dados para imagens de anúncios, ou talvez até a gestão de agentes.

• Funcionalidades de nível de produção (ou tão próximas do nível de produção quanto possível): tratamento robusto de erros, cobertura de testes e documentação.

• Feedback da comunidade: se estás a usar isto ou queres ver novas funcionalidades, abre uma issue ou um PR.

Como defensor de longa data do open source e da automação em todos os setores, estou empenhado em capacitar as equipas para avançarem mais depressa, com menos atrito — mesmo em setores tradicionais como o imobiliário.

Considerações finais#

Se és developer, NinjaOps engineer ou até um líder de negócio, encorajo-te a experimentar o provider, a partilhar feedback ou a contribuir com uma issue ou um PR.

Vamos levar o poder do open source e da automação a todas as partes da stack, mesmo àquelas que ainda pensam em PDFs e portais.

Obtém o código: github.com/agusgonzaleznic/terraform-provider-immobilienscout24

Vamos automatizar o setor imobiliário juntos!