招投标大数据服务

Proporciona servicios completos de consulta de información de licitaciones y ofertas, incluyendo estadísticas, búsquedas y consultas de proyectos planificados.

Documentación

招投标大数据服务

Este servicio MCP ofrece funciones integrales de consulta de información sobre licitaciones y adjudicaciones, incluyendo estadísticas de adjudicaciones, estadísticas de licitaciones, estadísticas de compras, consulta de información de licitaciones, consulta de proyectos planificados, entre otras, para ayudar a los usuarios en el análisis de licitaciones y la detección de oportunidades de mercado.

Funciones principales

  • 🔍 Búsqueda difusa por palabra clave de empresa
  • 🏆 Análisis estadístico de adjudicaciones de empresas
  • 📋 Análisis estadístico de licitaciones de empresas
  • 💼 Análisis estadístico de compras de empresas
  • 📄 Consulta de información de licitaciones y adjudicaciones
  • 🏗️ Consulta de proyectos planificados
  • 🔎 Búsqueda de información de licitaciones y adjudicaciones

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/bidding-mcp-server
cd bidding-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": {
    "bidding-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": {
    "bidding-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/bidding/bidding_bigdata?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. bid_bigdata_fuzzy_search

Función: Consulta difusa por palabra clave de empresa

Consulta la lista de empresas relacionadas mediante palabras clave como nombre de empresa, nombre de persona, marca, producto, puesto, 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
  • Otra información relacionada con la empresa

2. bid_bigdata_bid_win_stats

Función: Análisis estadístico de adjudicaciones de empresas

Obtiene los elementos estadísticos de adjudicaciones de la información de licitaciones de la empresa según nombre, código de crédito social unificado, etc., incluyendo distribución de objetos, distribución de montos, distribución regional y tendencias de adjudicaciones.

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): Tipo de entidad - name: nombre de empresa, nameId: id de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • winbidAmountStatList: Distribución de montos de adjudicaciones
    • range: Rango de montos
    • percent: Proporción
    • count: Cantidad
  • winbidAreaStat: Distribución regional
    • area: Región
    • count: Cantidad
  • winbidStatList: Distribución de objetos de adjudicaciones
    • subjectMatter: Objeto
    • count: Cantidad
    • percent: Proporción
  • winbidTrend: Tendencias de adjudicaciones
    • year: Año
    • count: Cantidad

3. bid_bigdata_bidding_info

Función: Consulta de información de licitaciones y adjudicaciones de empresas

Según el identificador de empresa ingresado, consulta y devuelve la información de licitaciones y adjudicaciones en las que participa la empresa, incluyendo tipo de anuncio, región del proyecto, detalles del anuncio e información de empresas 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 empresa
  • pageSize (opcional): Tamaño de página - Máximo 50 registros por página
  • keywordType (opcional): Tipo de entidad - name: nombre de empresa, nameId: id de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
  • pageIndex (opcional): Número de página - Comienza desde 1

Valores de retorno:

  • total: Total
  • biddingId: Id de licitación
  • infoType: Tipo de anuncio de licitación
  • projectRegion: Región del proyecto
  • publishDate: Fecha de publicación del anuncio
  • subjectMatterList: Objeto
  • title: Título del anuncio
  • role: Rol en la licitación - Licitación, adjudicación
  • projectAmount: Monto del proyecto
  • winningBidderList: Empresa adjudicataria
  • purchasingBidderList: Empresa licitante

4. bid_bigdata_tender_stats

Función: Análisis estadístico de licitaciones de empresas

Obtiene los elementos estadísticos de licitaciones de la información de licitaciones de la empresa según nombre, código de crédito social unificado, etc., incluyendo distribución de objetos, distribución de montos, distribución regional y tendencias de licitaciones.

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): Tipo de entidad - name: nombre de empresa, nameId: id de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • tenderAmountStatList: Distribución de montos de licitaciones
    • range: Rango de montos
    • percent: Proporción
    • count: Cantidad
  • tenderAreaStat: Distribución regional
    • area: Región
    • count: Cantidad
  • tenderStatList: Distribución de objetos de licitaciones
    • subjectMatter: Objeto
    • count: Cantidad
    • percent: Proporción
  • tenderTrend: Tendencias de licitaciones
    • year: Año
    • count: Cantidad

5. bid_bigdata_procurement_stats

Función: Análisis estadístico de compras de empresas

Según el nombre o id de la empresa, obtiene la información estadística de compras de la empresa, incluyendo distribución de productos de compra, distribución regional de compras, etc.

Parámetros:

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

Valores de retorno:

  • purchasingProductStatList: Distribución de productos de compra
    • count: Cantidad de compras
    • percent: Proporción
    • product: Nombre del producto
  • purchasingAreaStatList: Distribución regional de compras
    • times: Número de clientes
    • area: Región

6. bid_bigdata_bid_search

Función: Búsqueda de información de licitaciones y adjudicaciones

Consulta y filtra información de licitaciones y adjudicaciones, devolviendo los detalles de anuncios que cumplan las condiciones mediante múltiples filtros.

Parámetros:

  • matchKeyword (opcional): Palabra clave de búsqueda - Por defecto devuelve todo ordenado por fecha de publicación más reciente
  • biddingType (opcional): Tipo de información - Enumeración de tipos de licitación
  • biddingRegion (opcional): Región del proyecto - Selección múltiple, admite provincias y ciudades
  • biddingAnncPubStartTime (opcional): Fecha de inicio de publicación - Formato: "2024-08-01"
  • biddingAnncPubEndTime (opcional): Fecha de fin de publicación - Formato: "2024-11-01"
  • searchMode (opcional): Modo de búsqueda - Coincidencia por título, coincidencia por objeto, coincidencia por texto completo
  • biddingProjectMaxAmount (opcional): Monto máximo del proyecto - Unidad: diez mil
  • biddingPurchasingType (opcional): Tipo de unidad licitante - Gobierno, escuela, hospital, etc.
  • biddingProjectMinAmount (opcional): Monto mínimo del proyecto - Unidad: diez mil
  • pageIndex (opcional): Índice de paginación
  • pageSize (opcional): Tamaño de página - Máximo 50 registros por página

Valores de retorno:

  • total: Total
  • biddingAnncTitle: Título del anuncio
  • biddingContent: Contenido
  • biddingId: Id del anuncio
  • biddingInfoType: Tipo de anuncio
  • biddingProjectType: Tipo de proyecto
  • biddingPublishTime: Fecha del anuncio
  • biddingEndTime: Fecha límite de licitación
  • biddingProjectID: Número del proyecto
  • biddingAgentInfoList: Lista de información de la agencia de licitación
  • biddingPurchasingInfoList: Lista de información de la unidad licitante
  • biddingWinningInfoList: Lista de información de la unidad adjudicataria
  • biddingRegion: Región de la licitación
  • hasFile: Si tiene adjuntos

7. bid_bigdata_planned_projects

Función: Consulta de proyectos planificados

Consulta la información de anuncios de proyectos planificados de empresas, ofreciendo múltiples métodos de búsqueda como nombre de empresa, número de registro, código de crédito social o id de empresa para recuperar los detalles relevantes de proyectos planificados.

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
  • 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): Tipo de entidad - name: nombre de empresa, nameId: id de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • total: Total
  • ppId: Id del proyecto
  • deviceList: Equipos a adquirir
  • ppRegion: Ubicación de construcción
  • ppTitle: Nombre del proyecto
  • ppContent: Contenido del proyecto
  • ppPublishTime: Fecha de publicación
  • ppApprovalTime: Fecha de evaluación

Escenarios de uso

  1. Compras gubernamentales: Consultar proyectos de licitación adecuados y conocer la dinámica de licitaciones
  2. Licitación empresarial: Buscar oportunidades de licitación y analizar la situación de los competidores
  3. Análisis de mercado: Analizar tendencias del mercado de licitaciones y formular estrategias comerciales
  4. Evaluación de riesgos: Evaluar la capacidad de licitación y cumplimiento de las empresas
  5. Expansión comercial: Descubrir oportunidades comerciales potenciales y socios
  6. Investigación sectorial: Conocer la actividad de licitaciones en sectores específicos

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 bid_bigdata_fuzzy_search para obtener el nombre completo
  2. Límite de paginación: Máximo 50 registros por página
  3. Formato de fecha: El formato de los parámetros de fecha es "YYYY-MM-DD"
  4. Unidad de montos: La unidad de los montos de proyectos es diez mil yuanes
  5. Filtro regional: Admite selección múltiple por provincia y ciudad

Ejemplos de preguntas de uso

bid_bigdata_fuzzy_search (Búsqueda difusa por palabra clave de empresa)

  1. Ayúdame a buscar información de empresas que contengan la palabra clave "中建"
  2. Buscar la lista de empresas relacionadas con "中铁"
  3. Consultar empresas cuyo nombre contenga "华为"

bid_bigdata_bid_win_stats (Análisis estadístico de adjudicaciones de empresas)

  1. Analizar las estadísticas de adjudicaciones de China State Construction Engineering Corporation
  2. Consultar la distribución de montos de adjudicaciones de Huawei Technologies Co., Ltd.
  3. Análisis de tendencias de adjudicaciones de China Railway Construction Group

bid_bigdata_bidding_info (Consulta de información de licitaciones y adjudicaciones de empresas)

  1. Consultar la información de proyectos de licitación en los que participa China State Construction
  2. ¿Cuáles son los registros de licitaciones más recientes de Huawei?
  3. Detalles de anuncios de licitaciones de China Railway Construction

bid_bigdata_tender_stats (Análisis estadístico de licitaciones de empresas)

  1. Analizar las estadísticas de licitaciones de State Grid
  2. Consultar la distribución de montos de licitaciones de PetroChina
  3. Análisis de tendencias de licitaciones de China Mobile

bid_bigdata_procurement_stats (Análisis estadístico de compras de empresas)

  1. Analizar la distribución de productos de compra de Huawei
  2. Consultar la distribución regional de compras de Alibaba
  3. Datos estadísticos de compras de Tencent

bid_bigdata_bid_search (Búsqueda de información de licitaciones y adjudicaciones)

  1. Buscar proyectos de licitación recientes de construcción de estaciones base 5G
  2. Buscar información de licitaciones de compras gubernamentales en la provincia de Guangdong
  3. Buscar proyectos de licitación de ingeniería con montos superiores a 10 millones

bid_bigdata_planned_projects (Consulta de proyectos planificados)

  1. Consultar la información de proyectos planificados de China State Construction
  2. ¿Qué proyectos de ingeniería planificados tiene Huawei?
  3. Detalles de proyectos planificados de China Railway Construction