# Motomarkt

> Marketplace de motos, scooters, quads y triciclos en España. Datos públicos en JSON estable.

## API
- [Listings](https://motomarkt.pages.dev/api/listings): listado paginado con la misma gramática de URLs que el SSR (vehicleType, make, model, version, transaction, condition, prov, muni, facets, page, pageSize, sort).
- [Listing detail](https://motomarkt.pages.dev/api/listings/{id}): ficha individual con bloque schema.org Motorcycle.
- [Search](https://motomarkt.pages.dev/api/search): busqueda conversacional. Pasa ?q=texto libre. Devuelve interpretacion estructurada (state, priceMax, terminos detectados) y resultados; cuando la consulta encaja con una ruta SEO canonica incluye redirectTo.
- [Taxonomy](https://motomarkt.pages.dev/api/taxonomy): vocabulario controlado (vehicleType, make, model, version, condition, transaction, fuelType, gearbox, carnet, bodyType).
- [Geo](https://motomarkt.pages.dev/api/geo): provincias y municipios indexables.
- [SEO routes](https://motomarkt.pages.dev/api/routes): lookup de una ruta canónica. Pasa ?path=/motos/honda.

## Agent discovery
- [Developer page](https://motomarkt.pages.dev/agent): índice humano de todas las superficies agent-readable.
- [OpenAPI 3.1](https://motomarkt.pages.dev/openapi.json): descripción machine-readable de toda la API.
- [API catalog](https://motomarkt.pages.dev/.well-known/api-catalog): linkset RFC 8288 hacia la OpenAPI.
- [A2A agent card](https://motomarkt.pages.dev/.well-known/agent.json): tarjeta Agent-to-Agent con skills invocables.
- [MCP server card](https://motomarkt.pages.dev/.well-known/mcp/server-card.json): tools MCP que envuelven la API.

## Negociación markdown
Las páginas de catálogo (/motos, /motos/honda, …) y /api/search devuelven una vista markdown compacta cuando el cliente envía el header Accept con valor text/markdown. ~5x más barata de ingerir que el HTML completo.

## Specs (programmatic SEO)
- [/info](https://motomarkt.pages.dev/info): índice de fichas técnicas (precios y medidas) por marca y modelo. Estructura /info/{marca}/{modelo}/[{año}/]; el año más reciente canonicaliza al hub /info/{marca}/{modelo}/. Cada variante incluye JSON-LD schema.org Vehicle y, cuando hay anuncios en venta del mismo modelo, AggregateOffer apuntando al catalogo /motos/{marca}/{modelo}.

## Sitemaps
- [Sitemap index](https://motomarkt.pages.dev/sitemap.xml)
- [Static sitemap](https://motomarkt.pages.dev/sitemap-static.xml): páginas fijas (home, /agent, legales).
- [Taxonomy sitemap](https://motomarkt.pages.dev/sitemap-taxonomy.xml)
- [Geo sitemap](https://motomarkt.pages.dev/sitemap-geo.xml)
- [Listings sitemap](https://motomarkt.pages.dev/sitemap-listings.xml)
- [Specs sitemap](https://motomarkt.pages.dev/sitemap-info.xml)

## Optional
- [Robots](https://motomarkt.pages.dev/robots.txt)