{"name":"Portal Inmuebles CLI","version":"2.1.0","description":"CLI para gestión de propiedades inmobiliarias, analytics, balance y monetización","endpoints":{"documentation":"/api/cli","execute":"/api/cli/execute","token_management":"/api/cli/token","subscription":"/api/cli/subscription"},"tasacion":{"description":"Sistema de tasación de propiedades inmobiliarias","discovery":"/.well-known/ai-tasacion.json","documentation":"/api/tasacion","endpoints":{"cuota":"/api/tasacion/cuota","iniciar":"/api/tasacion/iniciar","estado":"/api/tasacion/estado/{id}","pagar":"/api/tasacion/pagar"},"authentication":{"type":"session_cookie","note":"Requiere usuario registrado con sesión activa en el navegador","how_to_obtain":["1. Registrarse en /auth/register","2. Iniciar sesión en /auth/login","3. Las cookies de sesión se manejan automáticamente"]},"pricing":{"gratuitas_por_mes":1,"costo_adicional_uf":0.25,"nota":"Primera tasación del mes es gratis para usuarios registrados"}},"authentication":{"type":"bearer_token","token_format":"cli_[64 caracteres alfanuméricos]","header":"Authorization: Bearer cli_xxx...","how_to_obtain":["1. Registrarse en https://portalinmuebles.cl/auth/register","2. Ir a /dashboard/cli","3. Solicitar token (se envía por email)","4. Usar link del email para revelar token (una sola vez)"],"token_duration_days":90,"public_endpoints":["/api/cli","/.well-known/ai-cli.json"]},"tiers":{"FREE":{"price_clp":0,"property_limit":3,"rate_limit_per_minute":5,"rate_limit_per_hour":30,"commands":["properties:list","properties:get","balance:check","feedback:submit","feedback:types","subscription:status","subscription:plans"]},"BASIC":{"price_clp":9990,"property_limit":10,"rate_limit_per_minute":20,"rate_limit_per_hour":200,"commands_added":["properties:create","properties:update","analytics:summary","spaces:list","balance:history","feedback:list"]},"PRO":{"price_clp":49990,"property_limit":50,"rate_limit_per_minute":60,"rate_limit_per_hour":1000,"commands_added":["properties:delete","properties:bulk-update","analytics:views","analytics:export","spaces:buy","balance:add","feedback:stats"]},"ENTERPRISE":{"price_clp":99990,"property_limit":200,"rate_limit_per_minute":120,"rate_limit_per_hour":3000,"commands_added":["properties:bulk-delete","analytics:trends","spaces:history","balance:transfer","users:list","users:get"]}},"execute_format":{"method":"POST","url":"/api/cli/execute","headers":{"Authorization":"Bearer cli_tu_token_aqui","Content-Type":"application/json"},"body_format":{"command":"string — grupo de comando (ej: \"properties\", \"analytics\", \"credits\")","subcommand":"string — acción específica (ej: \"list\", \"create\", \"get\")","args":"object — argumentos del comando (varía por comando)"},"warning":"NUNCA enviar command y subcommand juntos como \"properties:list\". Siempre separados."},"examples":{"listar_propiedades":{"description":"Listar propiedades del usuario","body":{"command":"properties","subcommand":"list","args":{"limit":10}}},"crear_propiedad":{"description":"Crear nueva propiedad","body":{"command":"properties","subcommand":"create","args":{"data":{"title":"Casa en Providencia","description":"Descripcion de la propiedad","property_type":"casa","listing_type":"sale","price":5000,"moneda_publicacion":"UF","address":"Av. Providencia 1234","city":"Providencia","state":"Region Metropolitana","bedrooms":3,"bathrooms":2,"square_meters":200,"built_surface":120}}}},"ver_balance":{"description":"Consultar balance de creditos","body":{"command":"credits","subcommand":"balance","args":{}}},"buscar":{"description":"Buscar propiedades por texto","body":{"command":"search","subcommand":"properties","args":{"query":"casa providencia"}}}},"ai_agent_instructions":["CRITICO: command y subcommand son campos SEPARADOS en el body JSON. Nunca juntos con \":\"","GET /api/cli para documentacion completa sin autenticacion","POST /api/cli/execute para ejecutar comandos (requiere token CLI)","Cada usuario solo puede ver/modificar sus propios recursos (RLS activo)","Los limites de rate se retornan en la respuesta JSON (rate_limit.remaining)","TASACION: GET /api/tasacion para documentacion del sistema de tasacion","TASACION: Requiere usuario registrado con sesion activa (cookies)","TASACION: 1 tasacion gratis/mes, despues 0.25 UF cada una","Si un comando falla, revisa el campo \"error\" y \"_feedback_hint\" en la respuesta","Reporta problemas via POST /api/feedback/ai (sin autenticacion)"],"ai_feedback":{"description":"Canal oficial para que agentes IA reporten problemas, confusiones y sugerencias","endpoint":"POST /api/feedback/ai","auth":"NINGUNA — público, sin token requerido","docs":"GET /api/feedback/ai — devuelve tipos disponibles y ejemplo de request","when_to_use":["Cuando un comando retorna un error que no esperabas","Cuando no entiendes el flujo correcto (qué paso va antes/después)","Cuando la documentación no coincide con el comportamiento real","Cuando necesitas una funcionalidad que no existe","Cuando los rate limits bloquean tu caso de uso legítimo","Cuando tienes sugerencias para mejorar la API","SIEMPRE que veas _feedback_hint en una respuesta de error"],"feedback_types":["api_confusion","flow_confusion","unexpected_error","missing_capability","documentation_gap","rate_limit_issue","bug_report","feature_request","security_concern","usability","other"],"example":{"method":"POST","url":"/api/feedback/ai","body":{"agent_name":"Claude Code","type":"flow_confusion","severity":"medium","message":"No está claro el orden para publicar una propiedad. ¿Primero credits:purchase o properties:create?","command_attempted":"properties:create","context":{"steps_tried":["credits:balance → ok (3 créditos)","properties:create → 403 Forbidden"],"expected_behavior":"Crear la propiedad y descontar crédito automáticamente","actual_behavior":"Error 403 sin mensaje explicativo"}}},"important":"Los errores del CLI incluirán _feedback_hint cuando sea relevante reportar. Síguelo."},"links":{"full_documentation":"/api/cli","feedback_endpoint":"/api/feedback/ai","feedback_docs":"GET /api/feedback/ai","help_center":"/ayuda","register":"/auth/register","dashboard_cli":"/dashboard/cli","tasacion_discovery":"/.well-known/ai-tasacion.json","tasacion_documentation":"/api/tasacion","dashboard_tasacion":"/dashboard/tasacion"},"last_updated":"2026-03-28","contact":"soporte@portalinmuebles.cl","base_url":"https://portalinmuebles.cl"}