# CALA Inmobiliaria — AI-Ready Premium Real Estate Mallorca

> Portfolio showcase by StudioMeyer (https://studiomeyer.io)
> AI-Ready luxury real estate agency in Mallorca, Spain.
> Website: https://inmobiliaria.studiomeyer.io
> Contact: info@cala-inmobiliaria.com | +34 612 345 678
> Languages: Spanish (es), English (en), German (de)
> Properties for sale: 16 (€495K–€4.9M) — with PropertyDNA, Energy Certificates, Catastro references
> Vacation rentals: 25 (€95–€620/night)
> Locations: 19 across Mallorca
> AI Agent Discovery: /.well-known/agents.json (8 tools)
> A2A Protocol: /.well-known/agent-card.json (v1.0 RC, 8 skills)
> PropertyDNA Index: /.well-known/property-dna (open standard, CC BY 4.0)
> Kyero XML v3: /api/v1/export/kyero-xml (portal syndication)
> Catastro API: /api/v1/catastro (Spanish land registry)
> WebMCP: Browser-side AI tool registration (6 tools)
> API Base URL: https://inmobiliaria.studiomeyer.io

---

## Properties for Sale (16 listings)

Each listing: Name — Beds, Size, Price — Location
Deep link: /es/property/{id}
API: GET /api/v1/properties/{id}?locale=es|en|de

1. Villa Moderna Son Vida — 5 bed, 420m², €3,450,000 — Son Vida, Palma
   - URL: https://inmobiliaria.studiomeyer.io/es/property/villa-moderna-son-vida
   - API: GET /api/v1/properties/villa-moderna-son-vida

2. Finca Rústica Alaró — 4 bed, 350m², €1,850,000 — Alaró, Tramuntana
   - URL: https://inmobiliaria.studiomeyer.io/es/property/finca-rustica-alaro
   - API: GET /api/v1/properties/finca-rustica-alaro

3. Penthouse Portixol — 3 bed, 185m², €2,200,000 — Portixol, Palma
   - URL: https://inmobiliaria.studiomeyer.io/es/property/penthouse-portixol
   - API: GET /api/v1/properties/penthouse-portixol

4. Apartment Santa Catalina — 2 bed, 110m², €685,000 — Santa Catalina, Palma
   - URL: https://inmobiliaria.studiomeyer.io/es/property/apartment-santa-catalina
   - API: GET /api/v1/properties/apartment-santa-catalina

5. Townhouse Pollença — 3 bed, 210m², €920,000 — Pollença Old Town
   - URL: https://inmobiliaria.studiomeyer.io/es/property/townhouse-pollensa
   - API: GET /api/v1/properties/townhouse-pollensa

6. Villa Nueva Bendinat — 6 bed, 550m², €4,900,000 — Bendinat, Calvià
   - URL: https://inmobiliaria.studiomeyer.io/es/property/villa-nueva-bendinat
   - API: GET /api/v1/properties/villa-nueva-bendinat

7. Villa Deià Sea View — 4 bed, 320m², €2,750,000 — Deià, Tramuntana (Featured)
   - URL: https://inmobiliaria.studiomeyer.io/es/property/villa-deia-seaview
   - API: GET /api/v1/properties/villa-deia-seaview

8. Apartment Palma Centro — 1 bed, 75m², €495,000 — Palma Centro
   - URL: https://inmobiliaria.studiomeyer.io/es/property/apartment-palma-centro
   - API: GET /api/v1/properties/apartment-palma-centro

9. Finca Artà Olivar — 3 bed, 240m², €1,450,000 — Artà (Featured)
   - URL: https://inmobiliaria.studiomeyer.io/es/property/finca-arta-olivar
   - API: GET /api/v1/properties/finca-arta-olivar

10. Penthouse Port d'Andratx — 3 bed, 200m², €3,200,000 — Port d'Andratx (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/property/penthouse-port-andratx
    - API: GET /api/v1/properties/penthouse-port-andratx

11. Townhouse Sóller — 3 bed, 180m², €780,000 — Sóller Old Town
    - URL: https://inmobiliaria.studiomeyer.io/es/property/townhouse-soller
    - API: GET /api/v1/properties/townhouse-soller

12. Villa Cala Vinyes — 5 bed, 480m², €3,800,000 — Cala Vinyes, Calvià (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/property/villa-cala-vinyes
    - API: GET /api/v1/properties/villa-cala-vinyes

13. Finca Tradicional Sineu — 4 bed, 310m², €1,250,000 — Sineu, Central Mallorca
    - URL: https://inmobiliaria.studiomeyer.io/es/property/finca-sineu-traditional
    - API: GET /api/v1/properties/finca-sineu-traditional

14. Apartment Illetas Beach — 2 bed, 95m², €575,000 — Illetas, Calvià
    - URL: https://inmobiliaria.studiomeyer.io/es/property/apartment-illetas-beach
    - API: GET /api/v1/properties/apartment-illetas-beach

15. Penthouse Paseo Marítimo — 3 bed, 175m², €1,950,000 — Paseo Marítimo, Palma (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/property/penthouse-paseo-maritimo
    - API: GET /api/v1/properties/penthouse-paseo-maritimo

16. Townhouse Santanyí — 3 bed, 195m², €850,000 — Santanyí, Southeast
    - URL: https://inmobiliaria.studiomeyer.io/es/property/townhouse-santanyi
    - API: GET /api/v1/properties/townhouse-santanyi

---

## Vacation Rentals (25 listings)

Each listing: Name — Beds, Guests, Price/night — Location
Deep link: /es/rental/{id}
API: GET /api/v1/rentals/{id}?locale=es|en|de

1. Beach House Cala d'Or — 3 bed, 6 guests, €280/night — East Coast
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/beach-house-cala-dor
   - API: GET /api/v1/rentals/beach-house-cala-dor

2. Modern Apartment Palma — 2 bed, 4 guests, €165/night — Palma
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/modern-apartment-palma
   - API: GET /api/v1/rentals/modern-apartment-palma

3. Finca Retreat Sóller — 4 bed, 8 guests, €320/night — Sóller
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/finca-retreat-soller
   - API: GET /api/v1/rentals/finca-retreat-soller

4. Holiday Apartment Alcúdia — 2 bed, 5 guests, €130/night — North Coast
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/holiday-apartment-alcudia
   - API: GET /api/v1/rentals/holiday-apartment-alcudia

5. Penthouse Suite Puerto Portals — 3 bed, 6 guests, €450/night — Southwest
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/penthouse-suite-puerto-portals
   - API: GET /api/v1/rentals/penthouse-suite-puerto-portals

6. Beach Villa Cala Millor — 4 bed, 8 guests, €350/night — East Coast (Featured)
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/beach-villa-cala-millor
   - API: GET /api/v1/rentals/beach-villa-cala-millor

7. Old Town Penthouse Palma — 2 bed, 4 guests, €220/night — Palma (Featured)
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/old-town-penthouse-palma
   - API: GET /api/v1/rentals/old-town-penthouse-palma

8. Finca Valldemossa Pool — 3 bed, 6 guests, €280/night — Tramuntana (Featured)
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/finca-valldemossa-pool
   - API: GET /api/v1/rentals/finca-valldemossa-pool

9. Design Loft Santa Catalina — 1 bed, 2 guests, €145/night — Palma
   - URL: https://inmobiliaria.studiomeyer.io/es/rental/loft-santa-catalina
   - API: GET /api/v1/rentals/loft-santa-catalina

10. Seaview Apartment Port de Sóller — 2 bed, 4 guests, €175/night — Sóller
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/seaview-apartment-port-soller
    - API: GET /api/v1/rentals/seaview-apartment-port-soller

11. Family Villa Alcúdia — 4 bed, 10 guests, €250/night — North Coast (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/family-villa-alcudia
    - API: GET /api/v1/rentals/family-villa-alcudia

12. Romantic Finca Deià — 2 bed, 4 guests, €390/night — Tramuntana (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/romantic-finca-deia
    - API: GET /api/v1/rentals/romantic-finca-deia

13. Beach Apartment Can Picafort — 2 bed, 5 guests, €110/night — North Coast
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/beach-apartment-can-picafort
    - API: GET /api/v1/rentals/beach-apartment-can-picafort

14. Designer Villa Camp de Mar — 5 bed, 10 guests, €480/night — Southwest (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/designer-villa-camp-de-mar
    - API: GET /api/v1/rentals/designer-villa-camp-de-mar

15. Studio Pollença Old Town — 1 bed, 2 guests, €95/night — North Coast
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/studio-pollenca-old-town
    - API: GET /api/v1/rentals/studio-pollenca-old-town

16. Luxury Villa Son Vida — 5 bed, 10 guests, €550/night — Palma (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/luxury-villa-son-vida
    - API: GET /api/v1/rentals/luxury-villa-son-vida

17. Finca Binissalem Wine Country — 3 bed, 6 guests, €240/night — Central Mallorca (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/finca-binissalem-wine
    - API: GET /api/v1/rentals/finca-binissalem-wine

18. Seaside Apartment Cala Mayor — 2 bed, 4 guests, €155/night — Palma
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/seaside-apartment-cala-mayor
    - API: GET /api/v1/rentals/seaside-apartment-cala-mayor

19. Beach House Es Trenc — 3 bed, 6 guests, €310/night — South Coast (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/beach-house-es-trenc
    - API: GET /api/v1/rentals/beach-house-es-trenc

20. Marina Penthouse Port Adriano — 2 bed, 4 guests, €380/night — Southwest (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/marina-penthouse-port-adriano
    - API: GET /api/v1/rentals/marina-penthouse-port-adriano

21. Hilltop Villa Formentor — 5 bed, 10 guests, €620/night — North Coast (Featured)
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/hilltop-villa-formentor
    - API: GET /api/v1/rentals/hilltop-villa-formentor

22. Rural Finca Manacor — 3 bed, 7 guests, €195/night — East Coast
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/rural-finca-manacor
    - API: GET /api/v1/rentals/rural-finca-manacor

23. Gallery Apartment Santanyí — 2 bed, 4 guests, €140/night — South Coast
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/apartment-santanyi-gallery
    - API: GET /api/v1/rentals/apartment-santanyi-gallery

24. Finca Orient Valley — 2 bed, 4 guests, €210/night — Tramuntana
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/finca-orient-valley
    - API: GET /api/v1/rentals/finca-orient-valley

25. Harbor Apartment Port d'Andratx — 2 bed, 4 guests, €200/night — Southwest
    - URL: https://inmobiliaria.studiomeyer.io/es/rental/harbor-apartment-port-andratx
    - API: GET /api/v1/rentals/harbor-apartment-port-andratx

---

## Property Types

| Type | Description | Sale Range | Rental Range |
|------|-------------|------------|--------------|
| villa | Luxury villas with pools, gardens, sea views | €2.7M–€4.9M | €250–€620/night |
| finca | Traditional Mallorcan country estates with land | €1.25M–€1.85M | €195–€320/night |
| penthouse | Premium top-floor apartments with terraces | €1.95M–€3.2M | €220–€450/night |
| apartment | Modern city and beach apartments | €495K–€685K | €95–€200/night |
| townhouse | Restored historic old-town houses | €780K–€920K | — |
| beach-house | Beachfront holiday homes | — | €280–€310/night |

---

## Locations Covered (26 areas)

### Palma & Surroundings
- Palma Centro
- Son Vida
- Portixol
- Santa Catalina
- Paseo Marítimo
- Cala Mayor

### Southwest
- Bendinat, Calvià
- Cala Vinyes
- Camp de Mar
- Illetas
- Port d'Andratx
- Port Adriano
- Puerto Portals

### Tramuntana (West)
- Alaró
- Deià
- Orient
- Sóller / Port de Sóller
- Valldemossa

### North
- Alcúdia
- Can Picafort
- Formentor
- Pollença

### Central
- Sineu
- Binissalem
- Manacor

### East & South
- Artà
- Cala d'Or
- Cala Millor
- Es Trenc
- Santanyí

---

## API Usage Policy

- Authentication: None required (public API)
- CORS: Open (Access-Control-Allow-Origin: *)
- Rate limit: 60 requests per minute per IP
- On limit exceeded: HTTP 429 Too Many Requests
- Abuse protection: Repeated violations may result in temporary IP blocks
- Commercial use: Contact info@cala-inmobiliaria.com for higher limits
- Data freshness: Real-time from database, no caching delay
- Response format: JSON (UTF-8)
- Error format: { "error": "message" } with appropriate HTTP status code

---

## API Endpoints for AI Agents

Base URL: https://inmobiliaria.studiomeyer.io

### Properties (Sale)

GET /api/v1/properties — Search all properties
  Parameters:
  - type: villa | finca | penthouse | apartment | townhouse
  - minPrice: minimum price in EUR (e.g. 500000)
  - maxPrice: maximum price in EUR (e.g. 2000000)
  - bedrooms: minimum number of bedrooms (e.g. 3)
  - area: location name (e.g. "Palma", "Deià", "Son Vida")
  - locale: es | en | de (response language)

GET /api/v1/properties/:id — Get property details by ID
  Parameters:
  - locale: es | en | de

### Rentals (Vacation)

GET /api/v1/rentals — Search all rentals
  Parameters:
  - type: villa | finca | apartment | penthouse | beach-house
  - maxPrice: maximum price per night in EUR (e.g. 300)
  - guests: minimum number of guests (e.g. 6)
  - area: location name (e.g. "Sóller", "Palma")
  - locale: es | en | de

GET /api/v1/rentals/:id — Get rental details by ID
  Parameters:
  - locale: es | en | de

### Appointments

POST /api/appointment — Book a property viewing
  Body (JSON):
  - name: string (required)
  - email: string (required)
  - phone: string (optional)
  - propertyId: string (optional, e.g. "villa-moderna-son-vida")
  - date: string (optional, e.g. "2026-03-15")
  - message: string (optional)

### PropertyDNA (Open Standard)

GET /api/v1/property/:id/property.txt — Get PropertyDNA (YAML) for a property
  Returns: YAML with IDENTITY, SPECIFICATIONS, FINANCIALS, COMPLIANCE, CONTEXT, MEDIA, DISCOVERY
  License: CC BY 4.0

GET /.well-known/property-dna — PropertyDNA index (all properties with links)

### Kyero XML v3 (Portal Syndication)

GET /api/v1/export/kyero-xml — Export all properties as Kyero XML v3
  Returns: XML feed compatible with Idealista, Kyero, ThinkSpain, Fotocasa
  Includes: Trilingual descriptions, energy ratings, coordinates, images

### Catastro API (Spanish Land Registry)

GET /api/v1/catastro — Look up Spanish Catastro data
  Parameters:
  - lat + lng: GPS coordinates (e.g. lat=39.5898&lng=2.6071)
  - rc: Referencia Catastral (e.g. rc=07040A001000120000YT)
  Source: ovc.catastro.meh.es (public API, no auth required)

### Example API Calls

```
# Find villas under 2M EUR
GET /api/v1/properties?type=villa&maxPrice=2000000&locale=en

# Find rentals for 6+ guests under 300/night
GET /api/v1/rentals?guests=6&maxPrice=300&locale=en

# Get PropertyDNA for a specific property
GET /api/v1/property/villa-moderna-son-vida/property.txt

# Export Kyero XML v3 feed
GET /api/v1/export/kyero-xml

# Look up Catastro by coordinates
GET /api/v1/catastro?lat=39.5898&lng=2.6071

# Look up Catastro by reference
GET /api/v1/catastro?rc=07040A001000120000YT

# Get specific property details in German
GET /api/v1/properties/villa-deia-seaview?locale=de
```

---

## Discovery & Agent Integration

| Endpoint | URL | Purpose |
|----------|-----|---------|
| agents.json | /.well-known/agents.json | Tool discovery (8 tools) |
| Agent Card | /.well-known/agent-card.json | A2A Protocol v1.0 RC (8 skills) |
| PropertyDNA | /.well-known/property-dna | PropertyDNA index (16 properties) |
| Kyero XML | /api/v1/export/kyero-xml | Kyero XML v3 portal feed |
| Catastro | /api/v1/catastro | Spanish land registry lookup |
| WebMCP | /webmcp-register.js | Browser-side AI tools (6 tools) |
| Health | /api/health | Service status check |
| Sitemap | /sitemap.xml | 93 URLs, trilingual |
| robots.txt | /robots.txt | AI crawler permissions |
| llms.txt | /llms.txt | This file |

---

## Contact

- Company: CALA Inmobiliaria
- Email: info@cala-inmobiliaria.com
- Phone: +34 612 345 678
- Address: Paseo del Borne 15, 07012 Palma de Mallorca, Spain
- Website: https://inmobiliaria.studiomeyer.io
- Languages: Spanish, English, German

---

## About CALA

CALA is an AI-Ready premium real estate agency specializing in luxury properties and vacation rentals across Mallorca. From sea-view villas in Deià to modern penthouses in Palma, we offer a curated selection of 16 properties for sale (€495K–€4.9M) and 25 vacation rentals (€95–€620/night) across 19 locations on the island. Our multilingual team (ES/EN/DE) provides personalized service for buyers, sellers, and holiday guests.

### AI-Ready Features
- **PropertyDNA** — Open standard (CC BY 4.0) for AI-readable property data in YAML format
- **Kyero XML v3** — Feed for Spanish real estate portals (Idealista, Kyero, ThinkSpain, Fotocasa)
- **Catastro API** — Spanish land registry lookup by coordinates or Referencia Catastral
- **A2A v1.0 RC** — Agent-to-Agent protocol with 8 skills and extended agent card
- **WebMCP** — Browser-side AI tool registration (6 tools for Chrome 146+)
- **Spanish Compliance** — Certificado Energético, IBI, community fees, Referencia Catastral for every property

---

## Built by Studio Meyer.IO

- Website: https://studiomeyer.io
- AI-First Digital Studio — KI-Systeme und AI-Ready Websites
- Immobilien Template v4.0 with PropertyDNA, Kyero XML, Catastro, WebMCP
- agents.json + A2A Protocol v1.0 RC + PropertyDNA + Kyero XML + Catastro API + WebMCP + Public REST API + llms.txt