API y agentes de IA

Buscar en la web

HTML servido desde el servidor, sin registro ni CAPTCHA para leer y buscar. URLs estables:

• https://mercado.foro125.com/buscar?q=…&categoria=… — búsqueda con filtros (categoría, precio, estado, distancia, campos de la categoría)
• https://mercado.foro125.com/anuncios/<id>-<titulo> — ficha del anuncio
• https://mercado.foro125.com/categoria/<slug> y /categorias — categorías
• https://mercado.foro125.com/se-busca — anuncios de demanda

Cada anuncio y cada búsqueda están también en JSON y en Markdown (misma URL con .json o .md). Cada ficha lleva datos estructurados schema.org en JSON-LD (Product + Offer), y los listados ItemList y BreadcrumbList. Sitemap en /sitemap.xml, política de rastreo en /robots.txt y resumen para modelos en /llms.txt.

API pública

• Base: https://api.foro125.com/v1
• Especificación OpenAPI: https://api.foro125.com/openapi.json
• Búsqueda y ficha sin clave, con límite de uso por IP. Publicar, editar y mensajes con token (OAuth 2 o clave de API de cliente profesional).
• Mismos nombres de campos que la web y el JSON-LD. Errores siempre como {"error":{"code","message","fields"}}.

Servidor MCP

• Endpoint: https://api.foro125.com/mcp
• Herramientas: buscar anuncios, ver anuncio, publicar, editar, dar de baja, escribir al vendedor, destacar o subir un anuncio.
• Autorización del usuario con OAuth 2 (https://api.foro125.com/oauth/authorize), con permisos por tipo de acción: leer, publicar, mensajes, pagos. Los pagos los confirma siempre la persona.