Factory Insight Service
Analiza la capacidad
Documentación
Factory Insight Service
Funciones principales
- 🔍 Búsqueda difusa por palabras clave de empresas
- 🏭 Consulta de información general de fábricas
- 📊 Análisis estadístico de productos de fábrica
- ⚙️ Evaluación de capacidad de producción de fábrica
- 🔧 Búsqueda y filtrado de fábricas
- 📍 Análisis de distribución geográfica de fábricas
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-insight-mcp-server
cd factory-insight-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 MCP en Cursor / Cherry Studio
{
"mcpServers": {
"handaas-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
Instalación y despliegue de la versión STDIO
Configurar MCP en Cursor / Cherry Studio
{
"mcpServers": {
"factory-insight-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-insight-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/factory/factory_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. factory_insight_fuzzy_search
Función: Búsqueda difusa por palabras clave de empresas
Busca de forma difusa una lista de empresas relacionadas según palabras clave proporcionadas como nombre de empresa, nombre de persona, marca, producto, puesto, etc.
Parámetros:
matchKeyword(obligatorio): Palabra clave de coincidencia - Consulta empresas cuya información variada 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. factory_insight_factory_profile
Función: Consulta de información general de fábrica
Proporciona la información general de la fábrica de la empresa según su información de identificación, incluyendo evaluación de riesgos e información detallada de la fábrica.
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:
nameId: ID de empresaname: Nombre de empresafoundTime: Fecha de fundaciónfactoryScale: Tamaño de la fábricafactoryTypeList: Tipo de fábricamonthlyProductionAmountValue: Producción mensualaccountPeriodRisk: Riesgo de plazo de pagofactoryAddress: Dirección de la fábricaprovince: Provinciacity: Ciudaddistrict: Regiónvalue: Dirección
regCapital: Capital registradocoinType: Monedavalue: Monto
3. factory_insight_factory_product_stats
Función: Análisis estadístico de productos de fábrica
Según el nombre de la entidad de la fábrica, obtiene información estadística de productos de la fábrica, incluyendo número de marcas de servicio, número de productos principales, etiquetas de productos, estadísticas de categorías de productos, etc.
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:
serviceBrandCount: Número de marcas de serviciomainProductCount: Número de productos principalestagNames: Etiquetas de productosproductCategoriesStatInfo: Información estadística de categorías de productosname: Categoríavalue: Cantidad
4. factory_insight_factory_capabilities
Función: Evaluación de capacidad de producción de fábrica
Consulta la capacidad de producción y la información de calificaciones de la fábrica de la empresa especificada, incluyendo configuración de líneas de producción, configuración de personal, detalles de equipos, gestión de calidad y calificaciones relacionadas.
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:
assemblyLine: Número de líneas de producciónmonthlyProductionAmountValue: Producción mensualboarderStaffNumber: Número de personas de patronajeinspectionStaffNumber: Número de inspectoresinspectionGroup: Equipos de inspecciónisSupportProofing: Soporte de muestrascompanyTechnicList: Procesos de la fábricamanagementSystemCertification: Certificaciones del sistema de gestiónenterpriseCertification: Certificaciones de calidad de producciónmainDeviceList: Lista de equiposequipName: Nombre del equipobrand: Marca del equipoequipVersion: Modelo del equipoequipNum: Cantidad de equipos
patentCertificateImageList: Lista de calificaciones relacionadaspatentName: Nombre de la calificaciónimage: ImagenimageLink: Enlace de imagen
5. factory_insight_factory_search
Función: Búsqueda y filtrado de fábricas
Busca información de fábricas que cumplan las condiciones según los criterios ingresados por el usuario (como nombre de fábrica, productos principales, nombre de producto y ubicación geográfica).
Parámetros:
matchKeyword(obligatorio): Palabra clave de coincidencia - Nombre de fábrica/productos principales/nombre de productokeywordType(obligatorio): Tipo de entidad - Búsqueda integral/nombre de fábrica/productos principales/nombre de productopageIndex(opcional): Número de página - Comienza desde 1pageSize(opcional): Tamaño de página - Máximo 10 registros por páginaaddress(obligatorio): Región - Formato: [["provincia","ciudad"],["provincia","ciudad"]]
Valores de retorno:
total: Total - Máximo mostrado 100001resultList: Resultados de la listanameId: ID de empresaname: Nombre de empresafoundTime: Fecha de fundaciónmainProducts: Productos principalesregCapital: Capital registrado
Casos de uso
- Evaluación de proveedores: Evaluar la capacidad de producción y el nivel técnico de los fabricantes, seleccionar proveedores de calidad
- Análisis de inversión: Comprender la capacidad de producción y el potencial de desarrollo de las empresas manufactureras, respaldar decisiones de inversión
- Selección de socios: Buscar socios con capacidades de producción específicas, optimizar la distribución de la cadena de suministro
- Análisis de competencia: Analizar las ventajas de fabricación y la capacidad de producción de los competidores, formular estrategias competitivas
- Investigación industrial: Estudiar la distribución y el nivel de desarrollo de la manufactura en industrias específicas, comprender las tendencias del mercado
- Decisiones de compra: Evaluar la calidad del producto y la escala de producción de las fábricas, optimizar las decisiones de compra
- Evaluación de riesgos: Evaluar el riesgo de plazo de pago y la estabilidad de producción de los proveedores
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 tiene el nombre completo, primero llame a la interfaz factory_insight_fuzzy_search para obtenerlo
- Datos de capacidad: Los datos de capacidad pueden ser capacidad de diseño o capacidad real, se debe distinguir y verificar
- Información de equipos: La precisión de la información de equipos depende de la fuente de datos y la frecuencia de actualización, se recomienda verificación en sitio
- Confidencialidad de procesos: Parte de la información de procesos clave puede no estar completamente disponible, existen limitaciones de información
- Filtrado por región: La búsqueda por región debe ingresarse en el formato especificado, admite consultas combinadas de múltiples regiones
- Límite de paginación: La búsqueda de fábricas devuelve un máximo de 10 registros por página, se deben configurar adecuadamente los parámetros de paginación
Ejemplos de preguntas de uso
factory_insight_factory_profile (Consulta de información general de fábrica)
- ¿Cuál es el tamaño de la fábrica de Shenzhen Zhongan Xunshi?
- ¿En qué regiones se distribuyen las direcciones de las fábricas de Shenzhen Zhongan Xunshi? ¿Cuál es el capital registrado?
- ¿Qué tipos de fábricas de fabricación tiene Shenzhen Zhongan Xunshi? ¿Cuál es la situación del riesgo de plazo de pago?
factory_insight_factory_product_stats (Análisis estadístico de productos de fábrica)
- ¿Cuántos productos principales tiene Shenzhen Zhongan Xunshi?
- ¿Cómo son las estadísticas de categorías de productos de Shenzhen Zhongan Xunshi?
factory_insight_factory_capabilities (Evaluación de capacidad de producción de fábrica)
- ¿Cuántas líneas de producción tiene Shenzhen Zhongan Xunshi? ¿Qué marcas tienen los equipos principales?
- ¿Qué procesos de fábrica tiene Shenzhen Zhongan Xunshi? ¿Cuál es la situación de las certificaciones del sistema de gestión?
- ¿Shenzhen Zhongan Xunshi admite muestras? ¿Qué certificados de calificación relacionados tiene?
factory_insight_factory_search (Búsqueda y filtrado de fábricas)
- ¿Qué fábricas de fabricación electrónica hay en la provincia de Guangdong? ¿Cuáles son sus capitales registrados?
- ¿Buscar fábricas cuyo producto principal sea "accesorios para teléfonos móviles"?
- ¿Qué fábricas textiles hay en la provincia de Zhejiang?