渠道洞察服务

Proporciona análisis de canales de venta, incluyendo distribución, redes de distribuidores y cobertura, para ayudar a comprender los diseños de canales empresariales.

Documentación

渠道洞察服务

Este servicio MCP proporciona análisis de distribución de canales y ventas, incluyendo información sobre redes de distribuidores, canales de venta, cobertura de canales, etc., para ayudar a los usuarios a comprender la distribución de canales de una empresa.

Funciones principales

  • 🔍 Búsqueda difusa por palabras clave de empresas
  • 🏪 Análisis estadístico de canales
  • 📊 Búsqueda de empresas por canal
  • 🌍 Análisis comparativo con la misma industria
  • 📈 Análisis de eficiencia de canales

Requisitos del entorno

  • Python 3.10+
  • Paquetes de dependencia: python-dotenv, requests, mcp

Inicio rápido local

1. Clonar el proyecto

git clone https://github.com/handaas/factory-channel-mcp-server
cd factory-channel-mcp-server

2. Crear entorno virtual e instalar dependencias

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. Configuración del entorno

Copie la plantilla de variables de entorno y configúrela:

cp .env.example .env

Edite el archivo .env y configure las siguientes variables de entorno:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar el servicio con streamable-http

python server/mcp_server.py streamable-http

El servicio se iniciará en http://localhost:8000.

Métodos de inicio compatibles: stdio, sse o streamable-http

5. Configuración de MCP en Cursor / Cherry Studio

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

Instalación e implementación de la versión STDIO

Configurar MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "factory-channel-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Uso del servicio remoto oficial

1. Configurar directamente MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "factory-channel-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/factory/channel_insight?token={token}"  
      }
  }
}

Nota: integrator_id, secret_id, secret_key y token requieren iniciar sesión en https://www.handaas.com/ para registrarse y obtenerlos en la plataforma

Herramientas disponibles

1. channel_insight_fuzzy_search

Función: Búsqueda difusa por palabras clave de empresas

Busca listas de empresas relacionadas mediante palabras clave como nombres de empresas, nombres de personas, marcas, productos, cargos, etc.

Parámetros:

  • matchKeyword (obligatorio): Palabra clave de coincidencia: consulta empresas cuya información contenga la palabra clave
  • pageIndex (opcional): Posición de inicio de paginación
  • pageSize (opcional): Posición de fin de paginación: máximo 50 registros por página

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados, incluye información básica de la empresa

2. channel_insight_channel_analysis

Función: Análisis estadístico de canales

Realiza un análisis estadístico de canales para una empresa específica, mostrando datos sobre solidez financiera, influencia de marca, capital registrado y fortaleza de ventas en comparación con la misma industria.

Parámetros:

  • matchKeyword (obligatorio): Palabra clave de coincidencia: nombre de empresa/número de registro/código de crédito social unificado/ID de empresa
  • keywordType (opcional): Enumeración de tipo de entidad: name/nameId/regNumber/socialCreditCode

Valores de retorno:

  • categoryCount: Total de empresas del mismo sector
  • financialStat: Análisis de solidez financiera
    • regCapitalRank: Ranking de capital registrado: muestra cuántas empresas del mismo sector supera en capital registrado
    • regCapitalScope: Rango de capital registrado
    • data: Datos de facturación anual del mismo sector
      • name: Rango de datos
      • ratio: Proporción del mismo sector
      • power: Número de empresas del mismo sector
  • salesStat: Análisis de fortaleza de ventas
    • annualTurnoverRank: Ranking de facturación anual: muestra cuántas empresas del mismo sector supera en facturación
    • annualTurnoverScope: Rango de facturación anual
    • data: Datos de facturación anual del mismo sector
    • categoryCount: Total de empresas del mismo sector
  • productBrandList: Proporción de marcas
    • name: Rango de datos
    • number: Cantidad
    • ratio: Proporción del mismo sector
  • productCategoryList: Proporción de categorías
    • name: Rango de datos
    • number: Cantidad
    • ratio: Proporción del mismo sector

3. channel_insight_channel_search

Función: Búsqueda de empresas por canal

Proporciona listas de empresas que coinciden según el nombre de fábrica o nombre de producto y las condiciones de búsqueda especificadas, incluyendo información básica de la empresa y productos principales.

Parámetros:

  • matchKeyword (obligatorio): Palabra clave de coincidencia: nombre de fábrica o nombre de producto (varias palabras separadas por comas)
  • keywordType (opcional): Tipo de búsqueda: búsqueda integral/productos principales
  • address (opcional): Región: formato: [["provincia","ciudad"],["provincia","ciudad"]]
  • channelTradeType (opcional): Modo de venta: todos/exportación/mercado interno
  • pageIndex (opcional): Número de página: comienza desde 1
  • pageSize (opcional): Tamaño de página: máximo 50 registros por página

Valores de retorno:

  • total: Total: máximo 100,000 empresas
    • nameId: ID de empresa
    • name: Nombre de empresa
    • foundTime: Fecha de fundación
    • mainProducts: Productos principales
    • tagNames: Categoría de productos
    • regCapital: Capital registrado

Casos de uso

  1. Optimización de canales: Optimizar la distribución y gestión de canales de venta, y desarrollar estrategias de canales
  2. Expansión de mercado: Analizar áreas de mercado desatendidas y desarrollar estrategias de expansión de mercado y canales
  3. Análisis competitivo: Comprender las ventajas de canal y la distribución de mercado de los competidores para desarrollar estrategias competitivas
  4. Selección de socios: Buscar distribuidores y socios de canal de alta calidad para establecer relaciones de cooperación
  5. Decisiones de inversión: Evaluar la fortaleza de canales y la capacidad de cobertura de mercado de una empresa para respaldar decisiones de inversión
  6. Investigación de la industria: Estudiar la distribución de canales y las características de los modelos de venta en industrias específicas
  7. Optimización de la cadena de suministro: Optimizar la distribución de la cadena de suministro y mejorar la eficiencia y cobertura de canales

Notas de uso

  1. Requisito de nombre completo de la empresa: Al llamar a interfaces que requieren el nombre completo de la empresa, si no se dispone de él, primero se debe llamar a la interfaz channel_insight_fuzzy_search para obtener el nombre completo
  2. Datos de canales: Los datos de canales pueden tener retrasos; se recomienda combinarlos con investigación de campo y verificación de mercado
  3. Cambios del mercado: La distribución de canales se ajusta según los cambios del mercado; se debe prestar atención a la vigencia de los datos
  4. Fuentes de datos: Los datos de canales de diferentes fuentes pueden variar; se recomienda verificación cruzada
  5. Formato de región: La búsqueda por región debe ingresarse en el formato especificado; admite consultas combinadas de múltiples regiones
  6. Modo de venta: Prestar atención a las diferencias en características de venta y modelos de canal entre exportación y mercado interno

Ejemplos de preguntas de uso

channel_insight_channel_analysis (Análisis estadístico de canales)

  1. ¿Cuál es la fortaleza de canales de Huawei en la industria de teléfonos móviles? ¿En qué posición se encuentra su capital registrado entre las empresas del mismo sector?
  2. ¿Cómo es el análisis de fortaleza de ventas de Xiaomi? ¿Cuál es su posición en facturación anual entre las empresas del mismo sector?
  3. ¿Cómo es la influencia de marca de BYD en la industria de vehículos de nueva energía? ¿Cómo es la proporción de categorías?

channel_insight_channel_search (Búsqueda de empresas por canal)

  1. Busque empresas de canal cuyo producto principal sea "accesorios para teléfonos móviles". ¿En qué regiones se distribuyen principalmente?
  2. ¿Qué empresas se dedican a ventas de exportación? ¿Cuál es su capital registrado?
  3. ¿Qué distribuidores de mercado interno hay en la provincia de Guangdong? ¿Cuáles son sus categorías de productos?