carsales-mcp

Un servidor MCP que permite a un asistente de IA buscar en carsales.com.au — el mercado de coches más grande de Australia — coches usados y nuevos.

Diseñado para Claude Desktop, Claude Code, Cursor y cualquier cliente compatible con MCP.

[!NOTA] carsales.com.au está protegido por la protección anti-bots DataDome. Este servidor utiliza un navegador Chromium real (no un cliente HTTP simple) para superar el desafío. Los resultados de búsqueda funcionan de forma fiable. La página de detalle completa de cada anuncio puede estar bloqueada desde algunas redes / IPs de centros de datos — cuando eso ocurre, el servidor recurre de forma transparente a los datos resumidos de la tarjeta que ya extrajo de la búsqueda (precio, año, odómetro, transmisión, combustible, carrocería, ubicación). En una conexión residencial normal, la página de detalle suele cargar sin problemas.

Herramientas

search_cars

Busca coches. Los filtros se aplican como facetas de URL de carsales cuando son compatibles, y el precio / año / odómetro se filtran en memoria desde las tarjetas de anuncios (estos no tienen un parámetro de URL simple).

get_listing_details

Obtiene los detalles completos de un anuncio mediante listingId (p. ej. OAG-AD-26099426) o la url completa. Recurre a los datos resumidos de la tarjeta si la página de detalle está bloqueada por bots.

Vista holística. Las herramientas muestran la imagen completa del anuncio al modelo:

• get_listing_details / fetch devuelven el precio (drive-away y sin cargos gubernamentales), el indicador de precio (FAIR/GOOD/GOOD/ GREAT PRICE), año, odómetro, transmisión, combustible, carrocería, motor, vendedor + estado, la lista de características/especificaciones, la descripción y la galería de fotos.

• Configura includeImages: true (por defecto en get_listing_details/fetch) y las fotos reales se descargan y devuelven como bloques de imagen de MCP, de modo que un modelo multimodal puede ver literalmente el coche. search también tiene includeImages (desactivado por defecto) para adjuntar la miniatura de cada resultado.

• search devuelve la URL de image de cada resultado en su JSON incluso cuando las imágenes no están incrustadas.

Configuración

1. Instala el navegador de Playwright

npm install -g carsales-mcp      # OR clone + npm install
npx playwright install chromium   # downloads the full Chromium build (needed!)

Se requiere la compilación completa de Chromium (channel: 'chromium') — el shell sin interfaz está marcado por huella digital y bloqueado por DataDome. En Linux también puedes necesitar bibliotecas del sistema: npx playwright install-deps chromium (o los equivalentes de tu distribución de libnss3, libnspr4, libasound2).

2. Añádelo a tu cliente MCP

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "carsales": {
      "command": "npx",
      "args": ["-y", "carsales-mcp"]
    }
  }
}

Claude Code — ~/.claude/.mcp.json:

{
  "mcpServers": {
    "carsales": {
      "command": "npx",
      "args": ["-y", "carsales-mcp"]
    }
  }
}

3. (Opcional) Ajuste de proxy / anti-bots

carsales.com.au está detrás de DataDome. El servidor está diseñado para sobrevivir a esto:

Camoufox es el motor por defecto. Camoufox es un navegador anti-detección basado en Firefox con un perfil mucho más difícil de identificar que Chromium. El binario de Camoufox se descarga automáticamente en el primer lanzamiento (ejecuta npx camoufox-js fetch por ti — sin pasos manuales), y si Camoufox falla al iniciarse, el servidor recurre de forma transparente a Chromium. Fuerza Chromium con CARS_ENGINE=chromium.

Equilibrio entre API y scraping (refleja secondhand-mcp). Si tienes una clave de API de Carapis, configura CARAPIS_API_KEY y search_cars obtendrá JSON estructurado limpio desde su endpoint de carsales.com.au (sin desafíos de bots). Si la clave no está presente o la llamada falla, recurre al scraper del navegador. Esta es la misma estrategia de API oficial cuando sea posible / scraping cuando no, que usa secondhand-mcp para eBay frente a Depad/Poshmark.

Proxy. DataDome bloquea principalmente por reputación de IP, por lo que un proxy (residencial) es la solución más fiable. Configura CARS_PROXY a un único proxy, o una lista separada por comas para rotar entre proxies por solicitud (combinado con la lógica de reintentos a continuación):

"env": {
  "CARS_PROXY": "http://user:pass@proxy1:8000,http://user:pass@proxy2:8000",
  "CARAPIS_API_KEY": "your-key"
}

Otras variables de entorno de ajuste:

"env": { "CARS_PROXY": "http://127.0.0.1:8899" }

Notas y límites

• DataDome puede desafiar ocasionalmente; si una búsqueda no devuelve nada, simplemente reintenta.

• Respeta los términos de servicio de carsales y evita saturar con números de página muy altos.

• No se utiliza ninguna API oficial de carsales — esto extrae el sitio público mediante un navegador real.

Licencia

MIT