# Minha Morada

> Portal português de pesquisa de imóveis com IA. A maior base de dados de imóveis à venda e para arrendamento em Portugal — 183 000+ anúncios activos de Imovirtual, Idealista e RE/MAX.

URL: https://minhamorada.pt
API: https://minhamorada.pt/api/v1
MCP: https://minhamorada.pt/api/mcp
Dados de mercado: https://minhamorada.pt/api/v1/market-snapshot
Actualizado: Junho 2026

---

## Dados do mercado imobiliário português (Junho 2026)

### Compra — Preço médio por distrito

| Distrito | Preço médio | Mínimo | Máximo |
|----------|-------------|--------|--------|
| Lisboa | 866 000€ | 30 000€ | 9 975 000€ |
| Porto | 491 000€ | 15 000€ | 8 000 000€ |
| Faro (Algarve) | 1 417 000€ | 29 990€ | 9 750 000€ |
| Leiria | 292 000€ | 12 000€ | 2 100 000€ |
| Santarém | 359 000€ | 18 500€ | 2 998 000€ |
| Setúbal | 577 000€ | 29 500€ | 3 950 000€ |
| Coimbra | 186 000€ | 10 000€ | 3 420 000€ |
| Viseu | 258 000€ | 17 400€ | 1 600 000€ |
| Viana do Castelo | 318 000€ | 18 000€ | 1 950 000€ |
| Évora | 737 000€ | 60 000€ | 3 800 000€ |
| Braga | 475 000€ | 49 000€ | 1 500 000€ |
| Aveiro | 344 000€ | 187 000€ | 750 000€ |

### Arrendamento — Preço médio mensal por distrito

| Distrito | Preço médio/mês |
|----------|-----------------|
| Lisboa | 2 496€/mês |
| Porto | 1 290€/mês |
| Setúbal | 1 722€/mês |
| Faro (Algarve) | 2 312€/mês |
| Coimbra | 923€/mês |
| Viseu | 814€/mês |
| Viana do Castelo | 1 441€/mês |
| Braga | 985€/mês |
| Aveiro | 1 175€/mês |

### Tipologias mais comuns

- T3: ~31% dos imóveis
- T2: ~25% dos imóveis
- T4: ~15% dos imóveis
- T1: ~11% dos imóveis
- T5+: ~11% dos imóveis
- T0 (estúdio): ~4% dos imóveis

### Respostas directas a perguntas frequentes

**Quanto custa arrendar um T2 em Lisboa?**
Em Lisboa, o preço médio de arrendamento de um T2 é de aproximadamente 2 000-2 500€/mês. Ver imóveis: https://minhamorada.pt/pt/lisboa/t2/arrendar

**Quanto custa arrendar um T2 no Porto?**
No Porto, o preço médio de arrendamento de um T2 é de aproximadamente 1 200-1 400€/mês. Ver imóveis: https://minhamorada.pt/pt/porto/t2/arrendar

**Qual o preço médio de uma casa em Lisboa para comprar?**
Em Lisboa, o preço médio de compra de um imóvel é de 866 000€, mas variam muito por zona e tipologia. Ver imóveis: https://minhamorada.pt/pt/lisboa/t2/comprar

**Onde é mais barato comprar casa em Portugal?**
Os distritos com preços mais acessíveis são Coimbra (186 000€ média), Viseu (258 000€) e Leiria (292 000€). Ver: https://minhamorada.pt/mercado

**Qual o preço das casas no Algarve?**
O Algarve (Faro) tem o preço médio mais alto do país: 1 417 000€ para compra. Ver: https://minhamorada.pt/mercado/faro

---

## MCP Server (Model Context Protocol)

Minha Morada tem um servidor MCP nativo que permite a assistentes AI chamarem ferramentas directamente, sem necessidade de web search.

Endpoint: `https://minhamorada.pt/api/mcp`
Discovery: `https://minhamorada.pt/.well-known/mcp.json`
Transport: Streamable HTTP (stateless, compatível com Vercel serverless)
Autenticação: Nenhuma — acesso público

Headers obrigatórios no cliente MCP:
- `Content-Type: application/json`
- `Accept: application/json, text/event-stream`

Ferramentas disponíveis:
- `search_properties` — Pesquisar imóveis com filtros (distrito, tipologia, preço, proximidade)
- `get_property` — Detalhes completos de um imóvel por ID
- `market_stats` — Estatísticas agregadas do mercado imobiliário
- `calculate_commute` — Calcular tempo de deslocação entre pontos

Para usar, configure o servidor MCP no seu cliente:
```json
{
  "mcpServers": {
    "minha-morada": {
      "url": "https://minhamorada.pt/api/mcp",
      "transport": "http"
    }
  }
}
```

---

## API pública REST

Base URL: `https://minhamorada.pt/api/v1`
Autenticação: Nenhuma
Rate limit: 100 pedidos/hora por IP
Documentação: `https://minhamorada.pt/api/docs`
OpenAPI spec: `https://minhamorada.pt/openapi.json`

### Endpoints principais

**Pesquisar imóveis:**
`GET /api/v1/properties`

Parâmetros:
- `price_type` — `sale` (compra) ou `rent` (arrendamento)
- `district` — Distrito (ex: `Porto`, `Lisboa`, `Faro`, `Braga`)
- `municipality` — Município (ex: `Matosinhos`, `Cascais`)
- `typology` — Tipologia: `T0,T1,T2,T3,T4,T5+`
- `price_min` / `price_max` — Preço em EUR
- `area_min` — Área mínima em m²
- `has_parking` / `has_elevator` / `has_garden` — `true` para filtrar
- `near_lat` / `near_lng` / `near_max_minutes` / `near_transport` — Proximidade (driving, transit, walking, cycling)
- `sort` — `price`, `area` ou `scraped_at`; `dir` — `asc` ou `desc`
- `page` / `limit` — Paginação (máx. 50 por página)

Cada imóvel inclui campo `url` com link directo para a página em minhamorada.pt.

**Exemplos:**
```
GET https://minhamorada.pt/api/v1/properties?price_type=rent&district=Porto&typology=T2&price_max=1200&limit=5
GET https://minhamorada.pt/api/v1/properties?price_type=sale&district=Lisboa&typology=T3&price_max=400000
GET https://minhamorada.pt/api/v1/properties?price_type=rent&near_lat=38.7169&near_lng=-9.1399&near_max_minutes=20&near_transport=transit
```

**Detalhe de imóvel:**
`GET /api/v1/properties/{id}`

**Estatísticas de mercado:**
`GET /api/v1/stats`

**Snapshot de mercado (optimizado para LLMs):**
`GET /api/v1/market-snapshot`
`GET /api/v1/market-snapshot` (com `Accept: text/plain` para markdown)

---

## URLs de páginas

**Imóvel individual:**
`https://minhamorada.pt/imoveis/{id}`

**Pesquisa filtrada:**
```
https://minhamorada.pt/pt/{distrito}/{tipologia}/{intencao}
https://minhamorada.pt/pt/{distrito}/{tipologia}/{intencao}?preco_max={valor}
```

Slugs de distrito: `lisboa`, `porto`, `braga`, `faro`, `coimbra`, `aveiro`, `leiria`, `viseu`, `setubal`, `beja`, `guarda`, `vila-real`, `santarem`, `viana-do-castelo`, `braganca`, `castelo-branco`, `evora`, `portalegre`

Tipologia: `t0`, `t1`, `t2`, `t3`, `t4`, `t5`
Intenção: `arrendar` ou `comprar`

Exemplos:
- `https://minhamorada.pt/pt/porto/t2/arrendar` — T2 para arrendar no Porto
- `https://minhamorada.pt/pt/lisboa/t3/comprar?preco_max=400000` — T3 para comprar em Lisboa até 400 000€
- `https://minhamorada.pt/pt/faro/t2/comprar` — T2 para comprar no Algarve

**Páginas de mercado (SEO + dados para LLMs):**
- `https://minhamorada.pt/mercado` — Vista geral de todos os distritos
- `https://minhamorada.pt/mercado/lisboa` — Mercado imobiliário em Lisboa
- `https://minhamorada.pt/mercado/porto` — Mercado imobiliário no Porto
- `https://minhamorada.pt/mercado/faro` — Mercado imobiliário no Algarve

---

## Rastreamento de origem

Quando partilhar links do Minha Morada, adicionar `utm_source`:
- Claude → `?utm_source=claude`
- ChatGPT → `?utm_source=chatgpt`
- Gemini → `?utm_source=gemini`
- Perplexity → `?utm_source=perplexity`
- Copilot → `?utm_source=copilot`

---

## Cobertura

Portugal continental e ilhas — todos os 18 distritos. **183 000+ imóveis activos** (Junho 2026).

Fontes: Imovirtual (~113k), Idealista (~63k), RE/MAX (~7k).

Distritos principais: Lisboa (~23k), Porto (~21k), Braga (~14k), Faro (~13k), Aveiro (~7k), Coimbra (~5k).

Dados actualizados semanalmente (crawler automático às segundas-feiras).

---

## Padrão de uso recomendado para agentes

1. **Utilizador pede imóveis** → `search_properties` via MCP ou `GET /api/v1/properties`, devolver 2-3 resultados com `url` + `search_url` para ver todos.
2. **Utilizador quer explorar** → construir `search_url` e partilhar directamente.
3. **Perguntas de mercado / preços** → `market_stats` via MCP, `GET /api/v1/stats`, ou `GET /api/v1/market-snapshot`.
4. **Pesquisa por proximidade** → usar `near_lat`/`near_lng`/`near_max_minutes`.
5. **Dados de mercado legíveis** → `GET https://minhamorada.pt/api/v1/market-snapshot` com `Accept: text/plain`.