招投标大数据服务
Consulta información empresarial completa desde plataformas de comercio electrónico, incluyendo detalles de tiendas, datos de ventas y estadísticas de productos.
Documentación
招投标大数据服务
Funciones principales
- 🔍 Búsqueda difusa de empresas por palabras clave
- 🛒 Consulta de perfil de tiendas en línea globales
- 📊 Análisis de perfil de productos de comercio electrónico
- 🏬 Consulta de información de tiendas de comercio electrónico
- 📦 Estadísticas de categorías de productos
- 🌐 Análisis de distribución de plataformas
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/estore-mcp-server
cd estore-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": {
"estore-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 Remote oficial
1. Configurar directamente MCP en Cursor / Cherry Studio
{
"mcpServers": {
"estore-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/estore/estore_bigdata?token={token}"
}
}
}
Nota: integrator_id, secret_id, secret_key y token requieren iniciar sesión en https://www.handaas.com/ para registrarse y obtener acceso a la plataforma
Herramientas disponibles
1. estore_bigdata_fuzzy_search
Función: Consulta difusa de empresas por palabras clave
Consulta difusa de listas 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 - Consultar empresas cuya información variada contenga la palabra clave coincidentepageIndex(Opcional): Posición de inicio de paginaciónpageSize(Opcional): Posición de fin de paginación - Máximo 50 registros por página
Valor de retorno:
total: TotalnameId: ID de empresaname: Nombre de empresasocialCreditCode: Código de crédito social unificadolegalRepresentative: Representante legalenterpriseType: Tipo de entidad empresarialoperStatus: Estado de la empresaaddress: Dirección de registrofoundTime: Fecha de establecimientoregCapitalValue: Monto de capital registradocatchReason: Motivo de coincidencia
2. estore_bigdata_global_online_store_profile
Función: Consulta de perfil de tiendas en línea globales
Proporciona información de perfil de tiendas en línea de la empresa en el país y en el extranjero, incluyendo detalles como número de tiendas, volumen total de productos, plataformas de venta, marcas y productos principales.
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
Valor de retorno:
domesticEshopCount: Número de tiendas en línea nacionalesdomesticEshopProductCount: Volumen total de productos en tiendas en línea nacionalesdomesticEshopBrandList: Marcas principales de tiendas en línea nacionalesdomesticEshopPlatformList: Plataformas de publicación de tiendas en línea nacionalesdomesticEshopProductList: Productos principales de tiendas en línea nacionalesdomesticEshopSourceList: Fuente de tiendas en línea nacionalesforeignEshopCount: Número de tiendas en línea extranjerasforeignEshopProductCount: Volumen total de productos en tiendas en línea extranjerasforeignEshopBrandList: Marcas principales de tiendas en línea extranjerasforeignEshopPlatformList: Plataformas de publicación de tiendas en línea extranjerasforeignEshopProductList: Productos principales de tiendas en línea extranjerasforeignEshopSourceList: Fuente de tiendas en línea extranjeras
3. estore_bigdata_ecommerce_product_profile
Función: Análisis de perfil de productos de comercio electrónico
Consulta el perfil de tiendas y productos de la empresa en plataformas de comercio electrónico, incluyendo detalles como información de marca, calificaciones, fecha de creación, 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
Valor de retorno:
ecShopNumber: Número de tiendasecShopItemCount: Número total de productos en tiendasecShopAvgRates: Calificación promedio de tiendas (puntos)ecShopEarliestFoundTime: Fecha de creación de tiendasecShopItemCategories: Categorías de productosecShopBrands: Marcas principalesecShopProducts: Productos principalesecSources: Plataformas de publicación
4. estore_bigdata_ecommerce_store_info
Función: Consulta de información de tiendas de comercio electrónico
Consulta información de tiendas en línea asociadas a la empresa, devolviendo detalles de las tiendas y una visión general de los datos comerciales.
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
Valor de retorno:
eshopListCount: Número total de tiendas en línea asociadasenterpriseEshopCount: Número de tiendas en líneaenterpriseEshopProductsCount: Volumen total de productos en tiendas en líneaenterpriseEshopBrands: Marcas principalesenterpriseEshopProducts: Productos principalesenterpriseEshopPlatforms: Plataformas de publicación de tiendas en líneaeshopList: Lista de tiendas en línea asociadaseshopName: Nombre de la tienda en líneaeshopKeeper: Nombre del administrador de la tiendaeshopFoundTime: Fecha de apertura de la tiendaeshopUrl: URL de la tienda en líneaeshopIconLink: Logotipo de la tienda en líneaeshopProducts: Categoría principalenterpriseName: Empresa propietariaaddress: Ubicación de la tienda en líneabusinessStatistics: Estado operativoisExpired: Si la tienda en línea ha expirado
overview: Visión general de datos de tiendas en línea
Casos de uso
- Análisis de operaciones de comercio electrónico: comprender la situación operativa y el desempeño de mercado de la empresa en diversas plataformas de comercio electrónico
- Investigación de competidores: analizar la distribución de comercio electrónico y las estrategias de venta de los competidores
- Investigación de mercado: estudiar las tendencias de desarrollo del comercio electrónico y las oportunidades de mercado en industrias específicas
- Decisiones de inversión: evaluar el potencial de desarrollo del negocio de comercio electrónico y el valor comercial de la empresa
- Selección de socios: buscar socios y proveedores de comercio electrónico de alta calidad
- Monitoreo de marca: monitorear el desempeño y la reputación de la marca de la empresa en plataformas de comercio electrónico
- Análisis de cadena de suministro: comprender la cadena de suministro de comercio electrónico y la distribución de productos de la empresa
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 se debe llamar a la interfaz estore_bigdata_fuzzy_search para obtenerlo
- Diferencias de plataforma: las estructuras de datos y los métodos de estadística pueden variar entre diferentes plataformas de comercio electrónico
- Actualidad de los datos: los datos de comercio electrónico se actualizan con frecuencia, se recomienda prestar atención a las marcas de tiempo de los datos
- Datos de ventas: algunos datos de ventas pueden ser valores estimados, solo como referencia
- Datos internacionales: la integridad y precisión de los datos de tiendas en línea extranjeras pueden estar limitadas por la fuente de datos
- Estado de tiendas: preste atención a distinguir entre tiendas activas y tiendas cerradas
Ejemplos de preguntas de uso
estore_bigdata_global_online_store_profile (Consulta de perfil de tiendas en línea globales)
- ¿Cuántas tiendas en línea tiene Xiaomi en el país y en el extranjero? ¿Qué marcas y productos vende principalmente?
- ¿Cómo es la distribución global de tiendas en línea de Huawei? ¿Cuál es el volumen total de productos?
- ¿Qué plataformas cubre el negocio de comercio electrónico de BYD? ¿Cómo están las tiendas en línea en el extranjero?
estore_bigdata_ecommerce_product_profile (Análisis de perfil de productos de comercio electrónico)
- ¿Cuántas tiendas de comercio electrónico tiene Xiaomi? ¿Cuál es la calificación promedio?
- ¿Cuál es el número total de productos en las tiendas en línea de Huawei? ¿Cuáles son las principales categorías de productos?
- ¿Cuál es la fecha de creación más temprana de las tiendas de comercio electrónico de BYD? ¿Cuál es la marca principal?
estore_bigdata_ecommerce_store_info (Consulta de información de tiendas de comercio electrónico)
- ¿Cuántas tiendas en línea asociadas tiene Xiaomi en total? ¿Cómo son los detalles de las tiendas?
- ¿En qué plataformas se distribuyen principalmente las tiendas en línea de Huawei? ¿Cuáles son los nombres de los administradores?
- ¿Cuál es el estado operativo de las tiendas de comercio electrónico de BYD? ¿Hay tiendas vencidas?