渠道洞察服务
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
渠道洞察服务
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 clavepageIndex(opcional): Posición de inicio de paginaciónpageSize(opcional): Posición de fin de paginación: máximo 50 registros por página
Valores de retorno:
total: TotalresultList: 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 empresakeywordType(opcional): Enumeración de tipo de entidad: name/nameId/regNumber/socialCreditCode
Valores de retorno:
categoryCount: Total de empresas del mismo sectorfinancialStat: Análisis de solidez financieraregCapitalRank: Ranking de capital registrado: muestra cuántas empresas del mismo sector supera en capital registradoregCapitalScope: Rango de capital registradodata: Datos de facturación anual del mismo sectorname: Rango de datosratio: Proporción del mismo sectorpower: Número de empresas del mismo sector
salesStat: Análisis de fortaleza de ventasannualTurnoverRank: Ranking de facturación anual: muestra cuántas empresas del mismo sector supera en facturaciónannualTurnoverScope: Rango de facturación anualdata: Datos de facturación anual del mismo sectorcategoryCount: Total de empresas del mismo sector
productBrandList: Proporción de marcasname: Rango de datosnumber: Cantidadratio: Proporción del mismo sector
productCategoryList: Proporción de categoríasname: Rango de datosnumber: Cantidadratio: 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 principalesaddress(opcional): Región: formato: [["provincia","ciudad"],["provincia","ciudad"]]channelTradeType(opcional): Modo de venta: todos/exportación/mercado internopageIndex(opcional): Número de página: comienza desde 1pageSize(opcional): Tamaño de página: máximo 50 registros por página
Valores de retorno:
total: Total: máximo 100,000 empresasnameId: ID de empresaname: Nombre de empresafoundTime: Fecha de fundaciónmainProducts: Productos principalestagNames: Categoría de productosregCapital: Capital registrado
Casos de uso
- Optimización de canales: Optimizar la distribución y gestión de canales de venta, y desarrollar estrategias de canales
- Expansión de mercado: Analizar áreas de mercado desatendidas y desarrollar estrategias de expansión de mercado y canales
- Análisis competitivo: Comprender las ventajas de canal y la distribución de mercado de los competidores para desarrollar estrategias competitivas
- Selección de socios: Buscar distribuidores y socios de canal de alta calidad para establecer relaciones de cooperación
- 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
- Investigación de la industria: Estudiar la distribución de canales y las características de los modelos de venta en industrias específicas
- 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
- 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
- Datos de canales: Los datos de canales pueden tener retrasos; se recomienda combinarlos con investigación de campo y verificación de mercado
- 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
- Fuentes de datos: Los datos de canales de diferentes fuentes pueden variar; se recomienda verificación cruzada
- Formato de región: La búsqueda por región debe ingresarse en el formato especificado; admite consultas combinadas de múltiples regiones
- 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)
- ¿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?
- ¿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?
- ¿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)
- Busque empresas de canal cuyo producto principal sea "accesorios para teléfonos móviles". ¿En qué regiones se distribuyen principalmente?
- ¿Qué empresas se dedican a ventas de exportación? ¿Cuál es su capital registrado?
- ¿Qué distribuidores de mercado interno hay en la provincia de Guangdong? ¿Cuáles son sus categorías de productos?