Servidor MCP de Rango de Precios carsensor para Agentes de IA

Si estás creando un agente de IA, un chatbot o una aplicación que necesite responder a la pregunta "¿es justo el precio de este coche de segunda mano?" — no una suposición, sino un número fundamentado en datos reales de mercado — este servidor MCP te ofrece exactamente eso en una única llamada de herramienta. resolvePriceRange(carModel, year) devuelve un rango de precios de mercado (mínimo / máximo / mediana) calculado en vivo a partir de las estadísticas oficiales de mercado por modelo y año de carsensor.net — los mismos datos que el propio carsensor publica en sus páginas de 相場(precio de mercado), convertidos en un número estructurado y listo para usar en lugar de una página que tendrías que leer e interpretar tú mismo.

Lo que obtienes:

• Una herramienta, resolvePriceRange, que solo requiere el nombre del modelo de coche y un año — sin claves API que gestionar para la fuente de datos subyacente, sin HTML que parsear tú mismo

• priceRangeYen: { min, max, median } más sampleSize (cuántos anuncios reales de carsensor respaldan la estimación) y confidence (normal / low — degradado honestamente, no ocultado, cuando el año no puede verificarse completamente contra los datos propios de carsensor; consulta "Limitaciones conocidas")

• Alojamiento siempre activo mediante el modo Standby de Apify — sin servidor que ejecutar tú mismo. Conecta cualquier cliente MCP (Claude Desktop, Claude Code, tu propio agente) directamente a un endpoint HTTPS estable, o llámalo como un servidor MCP Streamable HTTP normal desde el código de tu propia aplicación

{
  "ok": true,
  "carModel": "プリウス",
  "year": 2018,
  "priceRangeYen": { "min": 750000, "max": 4772500, "median": 1573112 },
  "sampleSize": 412,
  "confidence": "normal",
  "disclaimer": "carsensor.net上の公開情報(相場ページの価格×年式集計)を基にした参考値です。個体差・装備差・実際の商談結果は反映されません。"
}

Precio por evento — consulta "Precios" más abajo. Los detalles completos de entrada/salida, configuración y diseño técnico se encuentran más adelante en esta página.

⚠️ Aviso legal (por favor, lee)

• Este Actor recupera automáticamente información que está disponible públicamente en carsensor.net. Eres responsable de cómo recuperas y utilizas estos datos.

• Los Términos de Uso del propietario del sitio, robots.txt o el bloqueo de accesos podrían cambiar sin previo aviso, lo que podría impedir que este Actor funcione o cambiar su salida de forma inesperada.

• priceRangeYen es una estimación estadística derivada de los datos agregados publicados por el propio carsensor de precio×modelo-año, no una garantía del valor real de ningún vehículo individual. No tiene en cuenta el estado, las diferencias de acabado/grado ni el kilometraje (consulta "Limitaciones conocidas"). Verifica siempre el precio de un vehículo específico en carsensor.net antes de tomar cualquier decisión de compra o venta basada en estos datos.

¿Para quién es esto?

• Agentes de IA y chatbots que necesitan fundamentar una respuesta de "¿cuánto vale esto realmente?" en datos reales de mercado en lugar del conocimiento (a menudo desactualizado o alucinado) del propio modelo sobre precios de coches de segunda mano

• Desarrolladores de aplicaciones/herramientas que crean funciones de compra de coches, valoración o estimación de entrega a cambio y quieren una consulta de rango de precios ya preparada en lugar de hacer scraping y mantener su propia integración con carsensor.net

• Cualquiera que quiera esto como una simple llamada de herramienta MCP en lugar de un scraping por lotes — este Actor es la contrapartida de herramienta única y bajo demanda de nuestro Actor orientado a lotes carsensor-resale-value-scout (que puntúa listas completas de anuncios contra los mismos datos de mercado subyacentes)

¿Qué no puede hacer? (por favor, lee antes de integrar)

• El kilometraje aún no es una entrada compatible. Solo se utilizan el modelo de coche y el año — el rango de precios refleja el agregado por modelo-año del propio carsensor, no una estimación ajustada por kilometraje. Una versión futura podría añadir esto.

• La resolución del nombre del modelo puede fallar ocasionalmente o ser lenta en el primer uso con un modelo desconocido — consulta "Limitaciones conocidas" para saber por qué y cómo el caché mitiga esto después de la primera llamada.

• Esto es una estimación estadística, no una tasación. Consulta el Aviso legal anterior.

Entrada / Salida

Entrada (argumentos de llamada a la herramienta MCP):

Salida (éxito):

Salida (modelo no encontrado / sin datos para ese año): { "ok": false, "reason": "no_code_resolved" | "no_matching_data", "message": "..." } — no se cobra (consulta "Precios").

Ejemplo de uso

Claude Desktop / configuración de cualquier cliente MCP:

{
  "mcpServers": {
    "carsensor-price-range": {
      "url": "https://woolen-snake--carsensor-price-range-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Llamándolo directamente desde tu propia aplicación (Node.js, @modelcontextprotocol/sdk):

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://woolen-snake--carsensor-price-range-mcp.apify.actor/mcp'),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.APIFY_TOKEN}` } } },
);
const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const result = await client.callTool({
  name: 'resolvePriceRange',
  arguments: { carModel: 'プリウス', year: 2018 },
});
console.log(JSON.parse(result.content[0].text));

Precios

Precio fijo independientemente de si la llamada usó datos en caché o provocó una solicitud nueva a carsensor.net — consulta "Cómo se fijó el precio" más abajo para ver el razonamiento completo, incluido por qué se rechazó deliberadamente el precio por niveles de caché.

Cómo se fijó el precio

$0.03 se sitúa entre el nivel de clasificación base de esta familia de Actores ($0.015, p. ej. listing-extracted en nuestro Actor carsensor-resale-value-scout) y su nivel de señal derivada más pesado ($0.045–$0.065, p. ej. value-score-computed) — lo que refleja que un rango de precios es una señal de mercado calculada, no una obtención de datos en bruto, mientras que el coste de infraestructura subyacente de esta herramienta (muy por debajo de $0.001/llamada, la mayoría de las llamadas se sirven desde caché) deja un amplio margen en cualquier caso.

Por qué los aciertos y fallos de caché tienen el mismo precio: el valor entregado — priceRangeYen, sampleSize, confidence — es idéntico en ambos casos; el caché es puramente una optimización interna de rendimiento/coste, no una diferencia en lo que obtienes. Fijar un precio diferente también crearía un incentivo perverso para acortar el TTL del caché (más fallos = más ingresos), lo que iría directamente en contra del objetivo de diseño de esta herramienta de minimizar la carga en carsensor.net.

Fuente de datos y cálculo

Utiliza la página de 相場(precio de mercado) publicada públicamente por el propio carsensor.net para el modelo resuelto (/usedcar/souba/{makerCode}_S{modelCode}/), específicamente su tabulación cruzada de "precio × modelo-año" (intervalo de precio, intervalo de año, recuento de anuncios por celda) — datos agregados oficiales que el propio carsensor calcula a partir de su inventario en vivo, no una estimación de terceros.

• median es un promedio ponderado por recuento del punto medio del intervalo de precio de cada intervalo de año coincidente

• min / max provienen de los límites reales de los intervalos de precio de las celdas coincidentes (los intervalos abiertos, p. ej. "¥4.150.000 o más", se aproximan con una heurística de ±15% — un ajuste empírico, no derivado estadísticamente)

• Estos son datos agregados por grado (p. ej. todos los acabados del Toyota Prius combinados), no precios de anuncios individuales — no tienen en cuenta diferencias de acabado/grado, equipamiento ni estado

Caché (2 niveles)

Un acierto de caché en ambos niveles significa cero solicitudes HTTP a carsensor.net para esa llamada. En la versión alojada en Apify, este caché está limitado a una única ejecución/instancia de contenedor de Standby — las sesiones concurrentes pueden terminar en diferentes instancias de contenedor con cachés independientes, por lo que la tasa de aciertos en el mundo real en la versión alojada puede ser menor que la que vería un único proceso local de larga duración. Una versión futura podría mover esto al Key-Value Store de Apify (compartido entre ejecuciones) si resulta que importa en la práctica.

Intervalo de acceso y registro

Las solicitudes a carsensor.net se espacian con un intervalo mínimo de 1000 ms (1500 ms por defecto) como medida de reducción de carga — el mismo mínimo que utiliza nuestro Actor carsensor-resale-value-scout. Cada llamada se registra (modelo, año, acierto/fallo de caché por nivel, solicitudes HTTP realmente realizadas, tiempo de respuesta, resultado) para monitorización futura — no se expone a los llamadores, se usa únicamente para operar este Actor de forma responsable.

FAQ

¿Por qué confidence a veces es "low"? El eje de años de carsensor tiene un intervalo inferior abierto en sus propios datos (p. ej. "2012 o anterior"). Cualquier año igual o anterior a ese límite coincidirá con él, exista o no el modelo realmente en ese año — no hay forma de verificar completamente la plausibilidad solo con estos datos, por lo que confidence se degrada honestamente en lugar de informarse como seguro. Consulta el campo note en dichas respuestas para conocer el motivo específico.

¿Por qué mi primera llamada para un modelo determinado tarda unos segundos, pero las llamadas repetidas son mucho más rápidas? La primera llamada para un modelo desconocido necesita hasta 3 solicitudes reales a carsensor.net (búsqueda → página de detalle → página de precio de mercado) para resolver de qué modelo se trata. Una vez resuelto, el mapeo modelo→código se almacena en caché de forma prácticamente permanente, y los datos de precio se almacenan en caché durante 12 horas — por lo que las llamadas repetidas para el mismo modelo son casi instantáneas.

¿Cubre el kilometraje? Aún no — consulta "¿Qué no puede hacer?".

¿En qué se diferencia de carsensor-resale-value-scout? Ese Actor es un scraper por lotes: dale un término de búsqueda y obtén una lista de anuncios en vivo, cada uno puntuado contra estos mismos datos de mercado. Este Actor es la contrapartida de llamada única y bajo demanda, construido para agentes de IA y aplicaciones que quieren un número para un modelo/año — no una lista que procesar y hacer scraping.

Limitaciones conocidas

• La resolución de nombres de modelo no tiene una búsqueda directa — pasa por la búsqueda de texto libre propia de carsensor y lee la página de un anuncio coincidente para identificar el modelo. Para un modelo genuinamente no reconocido (error tipográfico, modelo inexistente), la página de resultados de búsqueda de carsensor aún contiene un widget de "también te puede gustar" con coches no relacionados; este Actor detecta y excluye explícitamente ese widget para que no se confunda con una coincidencia real — confirmado mediante pruebas en vivo.

• confidence no puede verificar por completo si un año consultado es plausible para un modelo determinado — consulte las FAQ.

• Esto es un agregado a nivel de grado, no un precio de anuncio individual — consulte "Fuente de datos y cálculo".

• La caché basada en archivos es por contenedor en la versión alojada (Apify Standby) — consulte "Almacenamiento en caché".

• La lógica de scraping subyacente de esta herramienta está deliberadamente duplicada, no importada, del código de carsensor-resale-value-scout, para mantener desacoplados los dos Actors desplegados de forma independiente. Un cambio de marcado en carsensor.net que afecte a uno puede requerir una corrección equivalente en el otro.

• No aparece en Smithery: la respuesta de autenticación de Apify Standby no es conforme con el descubrimiento de OAuth, lo que interrumpe el escaneo de conexión automático de Smithery antes de que llegue a la autenticación basada en configuración de este propio servidor — no se planea ninguna solución por ahora.

Posibles extensiones futuras (no implementadas en esta versión)

• Kilometraje como tercera entrada, usando la matriz precio×kilometraje de carsensor (confirmado que se puede obtener, aún no integrado)

• Mover la caché al Key-Value Store de Apify para que se comparta entre las instancias de contenedor de Standby

• Publicación en directorios MCP adicionales más allá del Apify Store