Vehículo: Ventas regionales de marcas de automóviles

Este servicio MCP se centra en las ventas regionales de marcas de automóviles, ofreciendo capacidades de descubrimiento de marcas, detalles de marca, distribución operativa regional, ventas de modelos y variantes, y consulta de concesionarios.

Sector: Mercado y comercio

Funciones principales

• Búsqueda de marcas de automóviles con múltiples criterios

• Detalles de marca y fabricante

• Distribución operativa de tiendas regionales de la marca

• Análisis de modelos a la venta y ventas de modelos

• Configuraciones de variantes y concesionarios

Related MCP server: estore-mcp-server

Notas de diseño del servicio

• El servicio se centra en el análisis de ventas y distribución de canales de marcas de automóviles en diferentes regiones; la información de marcas, modelos, variantes y concesionarios se utiliza para complementar el contexto de evaluación de ventas.

• El servicio ofrece 7 herramientas de solo lectura; una sola llamada a una herramienta accede a un único ID de producto.

• Los resultados paginados se unifican en total y resultList.

• Las respuestas exitosas son automáticamente compatibles con el negocio de Gateway y las formas internas stat/data.

• El tiempo de espera de las solicitudes se puede configurar mediante HANDAAS_REQUEST_TIMEOUT, con un valor predeterminado de 30 segundos.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

cd vehicle-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

Dirección predeterminada del servicio: http://127.0.0.1:8000/mcp. Admite stdio, sse y streamable-http.

Variables de entorno

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

Las credenciales reales solo deben guardarse en el .env local o en los secretos de implementación.

Configuración de Cursor / Cherry Studio

{
  "mcpServers": {
    "vehicle-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Herramientas disponibles e ID de producto

Flujo de llamada recomendado

1. Primero use vehicle_brand_search para confirmar la marca y obtener manufacturerId.

2. Use el ID de marca para consultar los detalles de la marca y la distribución de ventas regional.

3. Si necesita análisis de modelos, primero consulte los modelos a la venta para obtener carModelId y luego consulte las ventas de los últimos 12 meses.

4. Use el ID de marca para continuar consultando configuraciones de variantes o concesionarios en una región específica.

Descripción detallada de las herramientas

1. vehicle_brand_search

Cuándo usar: cuando el usuario solo proporciona el nombre de la marca, el nombre del fabricante, el país de origen o un rango de ventas, para localizar la marca de automóvil.

Parámetros clave: keyword es una palabra difusa de la marca; el filtro de ventas anuales está en unidades de diez mil vehículos; el formato de fecha de lanzamiento es YYYY-MM-DD; pageSize máximo 10.

Descripción de la respuesta: devuelve la marca, el fabricante, el país de origen, el rango de precios, las ventas anuales y la escala de modelos a la venta, y proporciona manufacturerId.

2. vehicle_brand_detail

Cuándo usar: cuando se necesita la introducción de la marca, modelos populares, ventas históricas, escala de modelos a la venta o resumen de tiendas.

Parámetros clave: manufacturerId debe provenir de los resultados de búsqueda de marcas.

Descripción de la respuesta: los detalles se devuelven con total=1 y una sola entrada en resultList.

3. vehicle_brand_market_analysis

Cuándo usar: para comparar la distribución de tiendas y ventas de una marca en diferentes provincias o en diferentes ciudades de una provincia.

Parámetros clave: manufacturerId es obligatorio; si no se proporciona province, se agrega por provincia; si se proporciona un nombre corto de provincia como "广东", se agrega por ciudad.

Descripción de la respuesta: devuelve storeLayout, que incluye número de tiendas, ventas mensuales, porcentaje, número de distritos comerciales y flujo de clientes mensual promedio circundante.

4. vehicle_on_sale_model_list

Cuándo usar: para ver los modelos actualmente a la venta de la marca, precios y número de variantes, o para obtener el ID del modelo para consultas de ventas.

Parámetros clave: manufacturerId proviene de la búsqueda de marcas; admite paginación.

Descripción de la respuesta: devuelve el nombre del modelo, nivel, precio y carModelId.

5. vehicle_model_sales_ranking

Cuándo usar: para ver las ventas de los últimos 12 meses de un modelo y su clasificación dentro de la marca.

Parámetros clave: manufacturerId es obligatorio; carModelId proviene de los resultados de modelos a la venta; si no se proporciona, se consulta el modelo con mayores ventas de la marca.

Descripción de la respuesta: devuelve el nombre del modelo y los meses, ventas y clasificación de los últimos 12 meses.

6. vehicle_car_trim_list

Cuándo usar: cuando se necesitan consultar variantes específicas, tipo de energía, precio sugerido, configuraciones o ventas del mes anterior.

Parámetros clave: el precio está en yuanes; carType y secondCarType no se pueden proporcionar simultáneamente; el formato de fecha es YYYY-MM-DD; admite paginación.

Descripción de la respuesta: devuelve modelo, variante, fecha de lanzamiento, tipo de energía, precio sugerido, configuraciones y ventas del mes anterior.

7. vehicle_dealer_list

Cuándo usar: cuando se necesita encontrar concesionarios de una marca en una región específica, entidades operativas e información de distritos comerciales.

Parámetros clave: manufacturerId es obligatorio; se puede filtrar por provincia, ciudad, distrito, tipo de concesionario, facturación anual y tipo de distrito comercial.

Descripción de la respuesta: devuelve nombre de la tienda, entidad empresarial, dirección, distrito comercial, flujo de clientes y precios de vivienda circundantes.

Ejemplos de uso

Ejemplo 1: Ventas regionales de la marca

Analizar el número de tiendas, ventas mensuales y porcentaje de ventas de BYD en varias ciudades de la provincia de Guangdong.

Primero llame a vehicle_brand_search(keyword="比亚迪") para obtener manufacturerId, luego llame a:

{
  "tool": "vehicle_brand_market_analysis",
  "arguments": {
    "manufacturerId": "从品牌检索结果取得",
    "province": "广东"
  }
}

Ejemplo 2: Tendencia de ventas de un modelo

Ver las ventas de los últimos 12 meses y la clasificación dentro de la marca de un modelo a la venta de BYD.

Primero consulte la marca, luego llame a vehicle_on_sale_model_list para obtener carModelId, y finalmente llame a:

{
  "tool": "vehicle_model_sales_ranking",
  "arguments": {
    "manufacturerId": "从品牌检索结果取得",
    "carModelId": "从在售车型结果取得"
  }
}

Ejemplo 3: Concesionarios regionales

Buscar los concesionarios de BYD en Shenzhen y sus distritos comerciales.

{
  "tool": "vehicle_dealer_list",
  "arguments": {
    "manufacturerId": "从品牌检索结果取得",
    "province": "广东省",
    "city": "深圳市",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Notas de uso

1. manufacturerId proviene de los resultados de búsqueda de marcas de automóviles.

2. carModelId proviene de los resultados de modelos a la venta; en la capa de API de Producto se asigna a carId.

3. El tipo de modelo de primer nivel carType y el tipo de modelo de segundo nivel secondCarType no se pueden proporcionar simultáneamente.

4. El filtro de ventas anuales está en unidades de diez mil vehículos, el filtro de precios de variantes está en yuanes; las unidades de ventas devueltas se rigen por las descripciones de los campos.

Pruebas y verificación

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

Las pruebas unitarias utilizan respuestas simuladas; la verificación real se realiza mediante la llamada al Gateway Integrador de HandaaS a través del .env local.