API y MCP
Los datos de DroidBazaar están disponibles para desarrolladores y agentes de IA, en solo lectura y gratis. Cada especificación y compatibilidad lleva la URL de su fuente y la fecha en que se comprobó. Enlaza a la página de DroidBazaar indicada en cada campo url.
API REST v1
URL base https://droidbazaar.com/api/v1. Respuestas JSON, CORS activado, sin clave. Límite: 120 peticiones por minuto por IP (consulta las cabeceras X-RateLimit-*). La descripción completa está en openapi.json (OpenAPI 3.1).
| Endpoint | Devuelve |
|---|---|
| GET /robots | Modelos de robot; filtros category, brand, status, sort y min_<spec>/max_<spec> |
| GET /robots/{brand}/{model} | Robot con especificaciones con fuentes, enlaces y variantes |
| GET /robots/{brand}/{model}/parts | Piezas compatibles con el robot (incluida su familia) |
| GET /robots/{brand}/{model}/where-to-buy?region= | Distribuidores, vendedores y empresas de servicio, por país o UE |
| GET /robots/{brand}/{model}/issues | Problemas conocidos reportados por propietarios, los más confirmados primero |
| GET /robots/{brand}/{model}/prices | Precios con fuentes (tarifa, tienda, segunda mano, alquiler) y estadísticas de segunda mano |
| GET /brands | Marcas |
| GET /brands/{slug} | Marca con sus robots |
| GET /parts | Piezas; filtros category, robot=brand/model, maker |
| GET /parts/{slug} | Pieza con especificaciones y niveles de compatibilidad |
| GET /listings | Anuncios activos del marketplace |
| GET /listings/{id} | Un anuncio (el contacto se hace en la web) |
| GET /needs | Necesidades abiertas: lo que buscan los compradores |
| GET /news | Resúmenes de noticias con su fuente original |
| GET /guides | Guías sobre cómo funcionan los robots y sus piezas |
| GET /guides/{slug} | Una guía en texto plano con créditos de las figuras y lecturas recomendadas |
| GET /companies | Empresas: fabricantes de componentes, distribuidores, proveedores de servicios… |
| GET /search?q= | Busca robots, marcas, categorías, piezas, empresas, noticias, anuncios y necesidades |
Ejemplo: baterías para el Unitree Go2
curl "https://droidbazaar.com/api/v1/parts?category=battery&robot=unitree/go2"Errores
{ "error": { "code": "invalid_request", "message": "category: Invalid option…" } }Servidor MCP para agentes de IA
Conecta un cliente MCP (Claude y otros) a https://droidbazaar.com/api/mcp (Streamable HTTP, sin autenticación). Herramientas: search_robots, get_robot, get_robot_prices, get_robot_issues, compare_robots, search_parts, check_part_compatibility, search_listings, get_listing, search_needs, search_news y search_companies. Son de solo lectura.
{
"mcpServers": {
"droidbazaar": { "type": "http", "url": "https://droidbazaar.com/api/mcp" }
}
}Conviene saber
- Los anuncios y necesidades no incluyen datos de contacto: las personas se contactan en la web.
- Niveles de compatibilidad: official (lo dice el fabricante, con fuente), verified, seller claimed y community (sin comprobar).
- Los fabricantes que quieran actualizar sus datos pueden dar de alta su empresa.