# Portal Inmuebles — portalinmuebles.cl

> Portal inmobiliario chileno con API/CLI completo para automatización. Permite a IAs y herramientas publicar, actualizar, tasar y gestionar propiedades programáticamente.

## Quick start para IAs (si el usuario quiere publicar propiedades)

Si el usuario te pide publicar propiedades en portalinmuebles.cl, esto es lo que necesitas:

1. **Token de autenticación CLI** (el usuario debe generarlo en https://portalinmuebles.cl/dashboard/cli)
2. **Endpoint principal**: `POST https://portalinmuebles.cl/api/cli/execute`
3. **Header de auth**: `Authorization: Bearer cli_xxxxx`

Ejemplo minimal en bash para crear una propiedad:

```bash
curl -X POST https://portalinmuebles.cl/api/cli/execute \
  -H "Authorization: Bearer $CLI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "command": "properties",
    "subcommand": "create",
    "args": {
      "title": "Casa 3D 2B Providencia",
      "listing_type": "sale",
      "property_type": "casa",
      "price": 8500,
      "moneda_publicacion": "UF",
      "address": "Hernando de Aguirre 1234",
      "city": "Providencia",
      "state": "Metropolitana de Santiago",
      "bedrooms": 3,
      "bathrooms": 2,
      "square_meters": 180
    }
  }'
```

## Documentación

- **Discovery endpoint**: https://portalinmuebles.cl/.well-known/ai-cli.json
- **API docs (GET)**: https://portalinmuebles.cl/api/cli
- **Human-readable docs**: https://portalinmuebles.cl/docs/cli
- **Tasación discovery**: https://portalinmuebles.cl/.well-known/ai-tasacion.json
- **Tasación API**: https://portalinmuebles.cl/api/tasacion

## Comandos principales CLI (formato `command:subcommand`)

### properties (gestión de propiedades)
- `properties:list` — lista propiedades del usuario
- `properties:get` — detalle de una propiedad (args: id)
- `properties:create` — crear propiedad nueva
- `properties:update` — actualizar propiedad (args: id + campos a cambiar)
- `properties:delete` — eliminar propiedad (soft delete)
- `properties:activate` / `properties:deactivate` — activar/pausar publicación
- `properties:add-image` — agregar foto (args: id, image_url)
- `properties:add-video` — agregar video YouTube/Vimeo (args: id, video_url)
- `properties:bulk-update` — actualizar múltiples propiedades a la vez
- `properties:republish` — republicar para aparecer como nueva

### tasacion (tasación con IA)
- `tasacion:iniciar` — tasar una propiedad (args: direccion, comuna, tipo, superficie, dormitorios)
- `tasacion:estado` — consultar estado (args: id)
- `tasacion:historial` — tasaciones previas
- `tasacion:cuota` — cuota mensual gratuita disponible

### uf, credits, balance, profile, search, viral, analytics, subscription, feedback
Ver documentación completa en `/api/cli` o blog `/blog/automatizacion-ia-cli-gestionar-propiedades`

## Campos de propiedad (tabla properties en Supabase)

Campos requeridos al crear:
- `title` (string, nombre de la publicación)
- `listing_type` (`sale` para venta, `rent` para arriendo)
- `property_type` (`casa`, `departamento`, `parcela`, `oficina`, `terreno`, `local`)
- `price` (number)
- `moneda_publicacion` (`UF` o `CLP`)
- `address` (string, dirección completa)
- `city` (string, COMUNA — no confundir con capital regional)
- `state` (string, REGIÓN, ej: "Metropolitana de Santiago", "Valparaiso")

Campos opcionales comunes:
- `description` (HTML permitido)
- `bedrooms`, `bathrooms`, `parking_spots`, `storage_rooms` (numbers)
- `square_meters`, `built_surface`, `land_area` (numbers en m²)
- `images` (array de objetos `{url, isPrimary}`)
- `videos` (array de URLs YouTube/Vimeo, máx 3 para usuarios normales)
- `furnished`, `pet_friendly`, `canje_enabled` (booleans)
- `agent_name`, `agent_email`, `agent_phone` (string)
- `short_code` (string, código corto para URL)
- `status` (`active`, `inactive`, `pending`, `sold`)

## Subida de fotos

Las fotos se suben como archivos binarios al endpoint:
`POST https://portalinmuebles.cl/api/properties/upload`

Headers:
- `Authorization: Bearer <cli_token o jwt>`
- `Content-Type: multipart/form-data`

Body (form-data):
- `file`: archivo JPG/PNG/WebP (máx 10MB)
- `propertyId`: UUID de la propiedad (o "temp-XXX" para subida previa)
- `applyWatermark`: "true" o "false"

El sistema aplica automáticamente:
- Resize a max 1920x1080 (mantiene aspect ratio)
- Conversión a WebP quality 85
- EXIF auto-rotate (corrige fotos de celular en vertical)
- Genera 3 thumbnails: 400x300, 800x600, 150x150
- Scan antimalware (magic bytes + MIME + script injection)

## Datos geográficos Chile

El portal usa la estructura: País → Región (16 oficiales) → Comuna (346 oficiales)
- `country` = "Chile"
- `state` = nombre de la región (ej: "Valparaiso", "Metropolitana de Santiago")
- `city` = nombre de la comuna (ej: "Providencia", "Vina del Mar", "Casablanca")

Dataset completo de regiones y comunas disponible al consumir el CLI con `search:properties`.

## Límites y tiers

- **FREE**: read-only (list, get, search, tasacion, uf, profile, credits, balance)
- **BASIC**: + create, update, activate/deactivate, add-video, add-image
- **PRO**: + bulk-update, bulk-create, clone, delete, analytics:export
- **ENTERPRISE**: + bulk-delete, todos los analytics, webhooks
- **ADMIN_CEO**: acceso total (reservado para admin del portal)

Rate limits: FREE 10/min, BASIC 20/min, PRO 60/min, ENTERPRISE 120/min

## Blog con guías para usuarios

- https://portalinmuebles.cl/blog/ia-publica-gestiona-propiedades-por-ti — guía básica con 3 prompts de ejemplo
- https://portalinmuebles.cl/blog/automatizacion-ia-cli-gestionar-propiedades — referencia técnica completa
- https://portalinmuebles.cl/blog/como-instalar-claude-code-windows-linux — instalación paso a paso
- https://portalinmuebles.cl/blog/tasacion-propiedades-ia-gratis-chile — cómo tasar con IA

## Soporte

- Email: info@portalinmuebles.cl
- Reportar bugs al CLI: `POST /api/feedback/ai` con `type=unexpected_error`