Assetlog.ai

Readme

Qué es AssetLog

AssetLog es una API abierta para clasificados hiperlocales — empleos, vehículos y bienes raíces — donde los agentes de IA pueden tanto leer anuncios como enviar nuevos en nombre de los usuarios. Un solo endpoint, unificado en pueblos pequeños y grandes ciudades, accesible para humanos y máquinas por igual.

A diferencia de los feeds de solo lectura (RSS, schema.org), AssetLog le da a la IA la ruta de escritura — un agente puede publicar un anuncio en nombre del usuario mediante un flujo verificado por correo electrónico. La IA actúa en nombre del usuario, no como el usuario: cada envío requiere un clic humano para publicarse.

Datos abiertos, no un jardín amurallado

Somos un portal de clasificados que hace lo contrario de lo que hace el resto de la industria. La mayoría de los portales bloquean sus anuncios detrás de APIs que no puedes leer, muros de pago que no puedes cruzar y términos de servicio que prohíben el scraping. AssetLog abre sus datos — cada anuncio se publica a través de una API pública y legible por máquinas con Schema.org JSON-LD, una especificación OpenAPI y un manual llms.txt para agentes de IA.

Nos importa la transparencia y dar a los anunciantes el mayor alcance posible para la venta más rápida posible. Cuando ChatGPT, Claude, Perplexity y Google AI pueden leer tu anuncio de forma nativa, llegas a una audiencia que ningún portal de clasificados tradicional puede tocar — sin tarifas de posicionamiento premium, sin espacios patrocinados, sin filtros algorítmicos.

Por qué existe esto

Los datos de clasificados están dispersos en docenas de portales — cada uno con acceso restringido, cada uno con su propia API, ninguno escribible por un agente de IA sin crear una cuenta falsa. Los mercados hiperlocales (ciudades y pueblos más pequeños) son los peor atendidos: los anuncios están fragmentados en foros comunitarios, tableros regionales y el boca a boca.

AssetLog unifica los clasificados en vivo en un solo paquete legible por máquinas. En lugar de hacer scraping en una docena de portales, una IA llama a un endpoint y recibe JSON limpio. Y en lugar de obligar al usuario a abrir cinco pestañas para publicar el mismo anuncio, el agente publica una vez — el usuario solo hace clic en un correo de confirmación.

A través de la API pública, un agente de IA puede:

• leer anuncios (GET)
• enviar nuevos en nombre del usuario, verificados por correo electrónico (POST)
• editar los existentes (PATCH / PUT)
• eliminar (DELETE)

Categorías de anuncios

• vehicle — coches, motocicletas, vehículos comerciales
• real estate — apartamentos, casas, terrenos, propiedades comerciales
• cv — el CV privado de un solicitante de empleo: solo el propietario lo ve y lo adjunta a las respuestas a ofertas de trabajo. Nunca se muestra públicamente.
• job — ofertas de empleo y trabajo a tiempo parcial

Visibilidad en modelos de IA

Gracias a los datos estructurados (Schema.org JSON-LD), una API pública y un formato legible por máquinas, los anuncios publicados a través de AssetLog tienen una probabilidad significativamente mayor de ser citados por herramientas de búsqueda de IA como Perplexity, la búsqueda web de ChatGPT y Google AI Overviews.

En lugar de que la IA tenga que escarbar en sitios web desordenados, los datos se sirven aquí exactamente en la forma que entiende de forma nativa. Los anunciantes ganan alcance en una nueva capa de internet — aquella donde los usuarios ya no preguntan a Google, sino a su asistente de IA.

Enviar a través de ChatGPT

Para usuarios de ChatGPT Plus: el AssetLog GPT oficial te permite enviar vehículos, bienes raíces o empleos de forma conversacional — y crear tu CV privado, visible solo para ti, de la misma manera. Solo describe lo que necesitas y recibirás un enlace de confirmación por correo electrónico.

Para Claude, Cursor, Cline y otros clientes compatibles con MCP, consulta la siguiente sección. Gemini y Perplexity aún no admiten envío directo — pero pueden leer y citar anuncios de AssetLog a través de nuestro feed público y JSON-LD.

Acerca de las fotos en envíos de IA

La API de envío acepta fotos de tres maneras independientes — los clientes eligen la que mejor se adapte a su entorno de ejecución:

• URLs públicas de imágenes (Imgur, CDN, anuncio de origen) pasadas en el campo images de /ai/submit.
• Carga nativa de archivos mediante multipart/form-data a /ai/images/upload (devuelve una URL pública).
• JSON + base64 a /ai/images/upload (devuelve una URL pública).

Verificación de la realidad sobre ChatGPT Custom GPT: no puede reenviar de manera confiable las fotos adjuntas por el usuario (/mnt/data/...) a las Actions — ni como multipart ni como base64. El modelo a menudo pasa la ruta local como texto plano y la carga falla. El flujo de trabajo más confiable hoy es pegar una URL pública de imagen en el chat. Los clientes de IA con APIs nativas de archivos HTTP (scripts de Python, n8n, Make, uso de herramientas de la API de Claude) manejan las cargas sin problemas. Estamos rastreando mejores flujos de fotos específicamente para ChatGPT.

Conectar Claude, Cursor y otros clientes de IA (MCP)

AssetLog ejecuta un servidor MCP (Model Context Protocol) en una URL fija: https://api.assetlog.ai/mcp — una forma estándar para que los asistentes de IA usen AssetLog como herramienta desde su chat. Una vez conectado, simplemente le dices al asistente "añade mi apartamento" o "encuentra un trabajo de Laravel en Praga" y actúa. Funciona con Claude Desktop, Claude Code, Cursor, Cline, Continue y cualquier otro cliente compatible con MCP.

Antes de empezar: regístrate e inicia sesión. AssetLog se conecta a tu cuenta, así que antes de añadir el conector asegúrate de tener una cuenta en assetlog.ai y haber iniciado sesión. El paso de autorización te pedirá que inicies sesión — si aún no estás registrado, crea una cuenta primero, de lo contrario la conexión no se puede completar.

La forma más fácil: Custom Connector de claude.ai (configuración cero)

Si tienes Claude Pro / Max / Team / Enterprise en claude.ai, la vía más rápida es el Custom Connector integrado. Sin tokens, sin archivos de configuración, sin CLI.

1. Abre claude.ai → Configuración → Conectores → Añadir conector personalizado
2. Pega la URL: https://api.assetlog.ai/mcp
3. Haz clic en Añadir. Inicia sesión en AssetLog cuando se te solicite, luego haz clic en Permitir en la pantalla de consentimiento.
4. Listo. Las herramientas aparecen en tu chat de Claude — prueba "Usa AssetLog para listar mis activos" o "Busca en AssetLog coches en Brno".

Detrás de escena, claude.ai usa OAuth 2.1 + Dynamic Client Registration (RFC 7591) — el mismo estándar que usarías para integrar cualquier proveedor OAuth moderno. Sin intercambio manual de tokens, revocable desde la página del conector.

También funciona para ChatGPT (Custom Connector)

Los planes ChatGPT Pro / Team / Enterprise / Edu admiten el mismo estándar MCP a través de Custom Connectors — la URL del servidor de AssetLog es idéntica. Un solo backend, ambos asistentes de IA.

1. Abre chatgpt.com → Configuración → Conectores → Añadir (o en un chat: + → Conectores)
2. Pega la misma URL: https://api.assetlog.ai/mcp
3. Autoriza en la pantalla OAuth de AssetLog. Las herramientas aparecen en tu ChatGPT — prueba "Lista mis anuncios de AssetLog" o "Crea mi CV como desarrollador de Laravel".

Los usuarios de ChatGPT Free / Plus (sin interfaz de Conectores aún) pueden usar la ruta de token manual a continuación con un Custom GPT (Action) — consulta la sección de configuración manual.

Lo que la IA puede hacer (45 herramientas)

Una vez conectado, el asistente tiene 45 herramientas de AssetLog en su paleta. Estas diez cubren casi todo lo que le pedirás:

• search_assets — busca el feed público — filtra por tipo, ciudad, rango de precios o un radio en el mapa.
• get_asset_detail — abre un anuncio completo — precio, ubicación, fotos, especificaciones específicas del tipo.
• submit_asset — publica un nuevo anuncio. Se publica solo después de que hagas clic en el correo de confirmación.
• upload_image — sube una foto y recibe una URL pública que la IA adjunta a un anuncio.
• list_my_assets — tus propios anuncios — incluidos los borradores que aún no son públicos.
• update_asset — edita uno de tus anuncios — precio, estado, título, ubicación. Solo cambian los campos que mencionas.
• contact_owner — envía un mensaje a la persona detrás de un anuncio.
• create_saved_search — un vigilante — envíame un correo cuando un nuevo anuncio coincida con estos criterios.
• search_users — encuentra agentes, concesionarios y reclutadores por el área que cubren.
• get_my_account — tu plan, cuota de anuncios, impulsos y créditos de IA — en una sola llamada.

Configuración manual (Claude Desktop / Claude Code / Cursor / Cline / Continue)

Para clientes sin interfaz de Custom Connectors OAuth (Claude Desktop, CLI de Claude Code, Cursor, Cline, Continue, …), usa un token Bearer por usuario en su lugar. Mismo servidor MCP, solo autenticación diferente.

Dos formas de iniciar sesión para generar un token

No necesitas registrarte con una contraseña. Si ya confirmaste un anuncio enviado por IA en el pasado, tu cuenta existe — inicia sesión con un código de un solo uso enviado a tu correo (sin necesidad de contraseña) y genera el token desde allí. Los usuarios avanzados con correo + contraseña pueden usar el inicio de sesión regular.

Tres pasos para conectar:

1. Regístrate o inicia sesión en assetlog.ai, luego haz clic en connect_to_AI en el encabezado — elige la ruta más fácil (Custom Connector de Claude.ai o Conector de ChatGPT), o genera un token manual para Claude Desktop / Cursor / Cline. Los tokens manuales se muestran una sola vez; trátalos como una contraseña.
2. Añade el servidor de AssetLog a tu cliente de IA. Dos rutas: (a) CLI de Claude Code — claude mcp add --scope user --transport http assetlog https://api.assetlog.ai/mcp --header "Authorization: Bearer <TOKEN\>"\; (b) edita el archivo de configuración del cliente (claude_desktop_config.json en Claude Desktop, o el equivalente en Cursor / Cline / Continue) y añade un bloque mcpServers con la URL y el encabezado Authorization. Cierra y reinicia el cliente por completo después de guardar.
3. Reinicia el cliente. El asistente ahora ve las 45 herramientas y las usa bajo demanda. Los anuncios enviados aún pasan por el mismo flujo de confirmación por correo — ningún activo se publica sin tu clic.

¿Perdiste un token, dejas un trabajo o rotas claves? Revoca cualquier token desde el panel — el cliente de IA deja de funcionar inmediatamente con el anterior.

Construido para IA

El futuro no está en interfaces cada vez más bonitas. El futuro es una experiencia centrada en IA. En el contexto de la IA, la interfaz de usuario y la experiencia de usuario son solo una distracción que roba el tiempo del usuario.

La IA no necesita un frontend hermoso. La IA necesita datos buenos y de alta calidad. AssetLog es un paso intermedio hacia datos limpios — un lugar donde los datos viven en un formato que la IA entiende de forma nativa.

FAQ →