招投标大数据服务

Proporciona funciones completas de consulta de datos de comercio de importación y exportación, incluyendo análisis de tendencias, estadísticas de productos y distribución geográfica.

GitHub
14
Prueba este MCPPatrocinado

Documentación

招投标大数据服务

Este servicio MCP proporciona funciones integrales de consulta de datos de comercio de importación y exportación, incluyendo análisis de tendencias de exportación, estadísticas de categorías de productos, distribución geográfica de pedidos, información de certificaciones en el extranjero, etc., para ayudar a los usuarios a comprender la situación del comercio internacional de las empresas.

Funciones principales

  • 🔍 Búsqueda difusa por palabras clave de empresa
  • 📈 Análisis de tendencias de exportación
  • 📦 Análisis de productos de exportación
  • 🌍 Distribución geográfica de pedidos
  • 👥 Análisis de reclutamiento de comercio exterior
  • 📋 Consulta de certificaciones en el extranjero

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/customs-mcp-server
cd customs-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

Copiar la plantilla de variables de entorno y configurar:

cp .env.example .env

Editar el archivo .env y configurar las siguientes variables de entorno:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar el servicio 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 de 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 de Cursor / Cherry Studio

{
  "mcpServers": {
    "customs-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"
      }
    }
  }
}

Usar el servicio Remote oficial

1. Configurar directamente MCP de Cursor / Cherry Studio

{
  "mcpServers": {
    "customs-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/customs/customs_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. customs_bigdata_fuzzy_search

Función: Consulta difusa por palabras clave de empresa

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
  • pageIndex (Opcional): Posición inicial de paginación
  • pageSize (Opcional): Posición final de paginación

Valor de retorno:

  • total: Total

2. customs_bigdata_export_trends

Función: Análisis de tendencias de exportación

Consulta las tendencias de exportación de comercio exterior de la empresa según su información de identificación, incluyendo datos como el monto de exportación anual y el número de pedidos.

Parámetros:

  • matchKeyword (Obligatorio): 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

Valor de retorno:

  • exportTrend: Lista de años de exportación
    • amount: Monto (USD)
    • count: Número de pedidos
    • year: Año
  • total: Total de años de exportación

3. customs_bigdata_export_product_trends

Función: Análisis de tendencias de productos de exportación

Consulta y analiza las tendencias de desarrollo de los productos de comercio exterior de la empresa, proporcionando información sobre el volumen de pedidos de productos de exportación y la distribución de códigos HS aduaneros en diferentes años.

Parámetros:

  • matchKeyword (Obligatorio): 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

Valor de retorno:

  • exportGoodsOrderDistribution: Distribución del volumen de pedidos de productos de exportación
    • orderCountOfYear: Volumen de pedidos anual
    • count: Cantidad
    • hsCode: Código de producto HS aduanero
    • year: Año
  • exportGoodsOrderTrend: Tendencia del volumen de pedidos de productos de exportación
    • year: Año
    • count: Cantidad
    • name: Nombre

4. customs_bigdata_export_recruitment_profile

Función: Análisis de reclutamiento de comercio exterior

Según la información de identificación de la empresa ingresada, obtiene la situación de reclutamiento de puestos relacionados con comercio exterior de la empresa en los últimos tres meses.

Parámetros:

  • matchKeyword (Obligatorio): 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

Valor de retorno:

  • recruitingLatestThreeMonthCount: Número de puestos de reclutamiento en los últimos tres meses
  • recruitingCityCount: Número de ciudades de reclutamiento
  • recruitingCityList: Ciudades de reclutamiento
  • recruitingCount: Número de puestos de reclutamiento
  • recruitingPositions: Nombre del puesto de reclutamiento
  • recruitingPlatforms: Plataformas de puestos relacionados con comercio exterior
  • recruitingSourceCount: Número de canales de reclutamiento
  • recruitingSourceList: Canales de reclutamiento

5. customs_bigdata_export_order_regions

Función: Distribución geográfica de pedidos de exportación

Consulta la distribución geográfica de los pedidos de comercio exterior de la empresa según la información de identificación proporcionada, incluyendo el monto y la cantidad de pedidos por región.

Parámetros:

  • matchKeyword (Obligatorio): Nombre de empresa/Número de registro/Código de crédito social unificado/ID de empresa
  • pageIndex (Opcional): Número de página - comienza desde 1
  • pageSize (Opcional): Tamaño de página - máximo 50 registros por página
  • keywordType (Opcional): Enumeración de tipo de entidad

Valor de retorno:

  • resultList: Lista de distribución de pedidos por región
    • amount: Monto (USD)
    • count: Número de pedidos
    • destCountry: País/Región
    • weight: Peso neto (kg)
  • total: Total de regiones de distribución

6. customs_bigdata_overseas_certifications

Función: Consulta de información de certificaciones en el extranjero

Consulta la información de certificaciones en el extranjero de la empresa según su nombre, número de registro, etc., incluyendo categoría de certificación, número de certificado e información de productos relacionados.

Parámetros:

  • matchKeyword (Obligatorio): 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

Valor de retorno:

  • certType: Categoría de certificación
  • certId: Número de certificado
  • certCount: Total
  • certDomain: Ámbito de certificación
  • certProductName: Nombre del producto

Casos de uso

  1. Análisis de comercio internacional de la empresa: Comprender la capacidad de exportación y las tendencias de cambio en la cuota de mercado de la empresa
  2. Investigación de competidores: Analizar el desempeño de los competidores en el mercado internacional
  3. Evaluación de riesgo financiero: Bancos o instituciones de inversión evalúan los riesgos y beneficios del comercio internacional de la empresa
  4. Estrategia de expansión de mercado: Desarrollar estrategias más efectivas de expansión en el mercado internacional
  5. Investigación estadística gubernamental: Gobiernos o asociaciones industriales estadísticas sobre las tendencias generales de exportación de comercio exterior de las empresas
  6. Verificación de calificaciones para licitaciones: La empresa presenta certificados de calificación durante el proceso de solicitud de licitaciones

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 tiene el nombre completo, primero se debe llamar a la interfaz customs_bigdata_fuzzy_search para obtenerlo
  2. Límite de paginación: Máximo 50 registros por página
  3. Unidad de monto: El monto de exportación está en dólares estadounidenses
  4. Unidad de peso: El peso neto está en kilogramos
  5. Rango de tiempo: La información de reclutamiento corresponde a los últimos tres meses
  6. Código HS: La clasificación de productos se basa en el estándar de códigos HS aduaneros

Ejemplos de preguntas de uso

customs_bigdata_export_trends (Análisis de tendencias de exportación)

  1. ¿Cómo ha sido la tendencia del monto de exportación de Huawei en los últimos años? ¿Qué cambios ha habido en el número de pedidos?
  2. ¿Cómo es el desempeño de exportación de comercio exterior de BYD?
  3. ¿El negocio de exportación de Xiaomi tiene una tendencia de crecimiento o disminución?

customs_bigdata_export_product_trends (Análisis de tendencias de productos de exportación)

  1. ¿Qué productos exporta principalmente Huawei? ¿Cómo es la distribución del volumen de pedidos por categoría de producto?
  2. ¿Cómo es la estructura de productos de exportación de BYD? ¿Cómo es la distribución de códigos HS?
  3. ¿Qué cambios han tenido las categorías de productos de exportación de Xiaomi en diferentes años?

customs_bigdata_export_recruitment_profile (Análisis de reclutamiento de comercio exterior)

  1. ¿Huawei ha estado reclutando puestos relacionados con comercio exterior en los últimos tres meses?
  2. ¿Cómo es la situación de reclutamiento del equipo de comercio exterior de BYD? ¿En qué ciudades están reclutando?
  3. ¿A través de qué plataformas recluta principalmente Xiaomi para comercio exterior? ¿Es alta la demanda de puestos?

customs_bigdata_export_order_regions (Distribución geográfica de pedidos de exportación)

  1. ¿En qué países y regiones se distribuyen principalmente los pedidos de exportación de Huawei?
  2. ¿Cómo es la cobertura del mercado exterior de BYD? ¿Cómo son los montos de pedidos por región?
  3. ¿A qué mercados se exportan principalmente los productos de Xiaomi?

customs_bigdata_overseas_certifications (Consulta de certificaciones en el extranjero)

  1. ¿Qué certificaciones en el extranjero ha obtenido Huawei? ¿Cuáles son los principales ámbitos de certificación?
  2. ¿Cuántas certificaciones de productos en el extranjero tiene BYD? ¿Cuáles son las categorías de certificados?
  3. ¿Qué certificaciones internacionales han aprobado los productos de Xiaomi?