招投标大数据服务

Oferece serviços abrangentes de consulta a informações de licitações e concorrências, incluindo estatísticas, pesquisas e consultas a projetos planejados.

Documentação

招投标大数据服务

Este serviço MCP oferece funcionalidades abrangentes de consulta de informações de licitações, incluindo estatísticas de vitórias em licitações, estatísticas de licitações, estatísticas de compras, consulta de informações de licitações, consulta de projetos planejados, entre outras, ajudando os usuários na análise de licitações e na descoberta de oportunidades de mercado.

Principais funcionalidades

  • 🔍 Busca difusa por palavras-chave de empresas
  • 🏆 Análise estatística de vitórias em licitações de empresas
  • 📋 Análise estatística de licitações de empresas
  • 💼 Análise estatística de compras de empresas
  • 📄 Consulta de informações de licitações
  • 🏗️ Consulta de projetos planejados
  • 🔎 Busca de informações de licitações

Requisitos de ambiente

  • Python 3.10+
  • Pacotes de dependência: python-dotenv, requests, mcp

Início rápido local

1. Clonar o projeto

git clone https://github.com/handaas/bidding-mcp-server
cd bidding-mcp-server

2. Criar ambiente virtual e instalar dependências

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. Configuração de ambiente

Copie o modelo de variáveis de ambiente e configure:

cp .env.example .env

Edite o arquivo .env e configure as seguintes variáveis de ambiente:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar o serviço via streamable-http

python server/mcp_server.py streamable-http

O serviço será iniciado em http://localhost:8000.

Modos de inicialização suportados: stdio, sse ou streamable-http

5. Configuração MCP no Cursor / Cherry Studio

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Instalação e implantação da versão STDIO

Configurar MCP no 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"
      }
    }
  }
}

Usar o serviço Remote oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

{
  "mcpServers": {
    "bidding-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/bidding/bidding_bigdata?token={token}"  
      }
  }
}

Observação: integrator_id, secret_id, secret_key e token — é necessário acessar https://www.handaas.com/ para registrar e obter acesso à plataforma

Ferramentas disponíveis

1. bid_bigdata_fuzzy_search

Função: Consulta difusa por palavras-chave de empresas

Retorna uma lista de empresas relacionadas a partir de palavras-chave fornecidas, como nomes de empresas, nomes de pessoas, marcas, produtos, cargos, etc.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência — consulta empresas cujas informações contenham a palavra-chave
  • pageIndex (opcional): Posição inicial da paginação
  • pageSize (opcional): Posição final da paginação — máximo de 50 registros por página

Valores de retorno:

  • total: Total
  • Outras informações relacionadas à empresa

2. bid_bigdata_bid_win_stats

Função: Análise estatística de vitórias em licitações de empresas

Obtém itens estatísticos de informações de vitórias em licitações da empresa com base no nome da empresa, código de crédito social unificado, etc., incluindo distribuição de objetos licitados, distribuição de valores, distribuição regional e tendências de vitórias.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência — nome da empresa/número de registro/código de crédito social unificado/id da empresa
  • keywordType (opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • winbidAmountStatList: Distribuição de valores de vitórias
    • range: Faixa de valores
    • percent: Proporção
    • count: Quantidade
  • winbidAreaStat: Distribuição regional
    • area: Região
    • count: Quantidade
  • winbidStatList: Distribuição de objetos licitados vencidos
    • subjectMatter: Objeto licitado
    • count: Quantidade
    • percent: Proporção
  • winbidTrend: Tendência de vitórias
    • year: Ano
    • count: Quantidade

3. bid_bigdata_bidding_info

Função: Consulta de informações de licitações da empresa

Com base no identificador da empresa informado, consulta e retorna as informações de licitações em que a empresa participou, incluindo tipo de anúncio de licitação, região do projeto, detalhes do anúncio e informações de empresas relacionadas.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência — nome da empresa/número de registro/código de crédito social unificado/id da empresa
  • pageSize (opcional): Tamanho da página — máximo de 50 registros por página
  • keywordType (opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
  • pageIndex (opcional): Número da página — começa em 1

Valores de retorno:

  • total: Total
  • biddingId: ID da licitação
  • infoType: Tipo de anúncio de licitação
  • projectRegion: Região do projeto
  • publishDate: Data de publicação do anúncio
  • subjectMatterList: Objeto licitado
  • title: Título do anúncio
  • role: Papel na licitação — licitante, vencedor
  • projectAmount: Valor do projeto
  • winningBidderList: Empresa vencedora
  • purchasingBidderList: Empresa licitante

4. bid_bigdata_tender_stats

Função: Análise estatística de licitações de empresas

Obtém itens estatísticos de informações de licitações da empresa com base no nome da empresa, código de crédito social unificado, etc., incluindo distribuição de objetos licitados, distribuição de valores, distribuição regional e tendências de licitações.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência — nome da empresa/número de registro/código de crédito social unificado/id da empresa
  • keywordType (opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • tenderAmountStatList: Distribuição de valores de licitações
    • range: Faixa de valores
    • percent: Proporção
    • count: Quantidade
  • tenderAreaStat: Distribuição regional
    • area: Região
    • count: Quantidade
  • tenderStatList: Distribuição de objetos de licitação
    • subjectMatter: Objeto licitado
    • count: Quantidade
    • percent: Proporção
  • tenderTrend: Tendência de licitações
    • year: Ano
    • count: Quantidade

5. bid_bigdata_procurement_stats

Função: Análise estatística de compras de empresas

Com base no nome ou ID da empresa, obtém informações estatísticas de compras da empresa, incluindo distribuição de produtos adquiridos, distribuição regional de compras, etc.

Parâmetros:

  • keywordType (opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
  • matchKeyword (obrigatório): Palavra-chave de correspondência — nome da empresa/número de registro/código de crédito social unificado/id da empresa

Valores de retorno:

  • purchasingProductStatList: Distribuição de produtos adquiridos
    • count: Quantidade adquirida
    • percent: Percentual
    • product: Nome do produto
  • purchasingAreaStatList: Distribuição regional de compras
    • times: Número de clientes
    • area: Região

6. bid_bigdata_bid_search

Função: Busca de informações de licitações

Consulta e filtra informações de licitações, retornando detalhes de anúncios de licitação que atendam às condições por meio de diversos filtros.

Parâmetros:

  • matchKeyword (opcional): Palavra-chave de busca — por padrão, retorna tudo ordenado pela data de publicação mais recente
  • biddingType (opcional): Tipo de informação — enumeração de tipos de licitação
  • biddingRegion (opcional): Região do projeto — seleção múltipla, suporta províncias e cidades
  • biddingAnncPubStartTime (opcional): Data inicial de publicação — formato: "2024-08-01"
  • biddingAnncPubEndTime (opcional): Data final de publicação — formato: "2024-11-01"
  • searchMode (opcional): Modo de busca — correspondência por título, correspondência por objeto licitado, correspondência por texto completo
  • biddingProjectMaxAmount (opcional): Valor máximo do projeto — unidade: dez mil
  • biddingPurchasingType (opcional): Tipo de unidade licitante — governo, escola, hospital, etc.
  • biddingProjectMinAmount (opcional): Valor mínimo do projeto — unidade: dez mil
  • pageIndex (opcional): Índice de paginação
  • pageSize (opcional): Tamanho da página — máximo de 50 registros por página

Valores de retorno:

  • total: Total
  • biddingAnncTitle: Título do anúncio
  • biddingContent: Conteúdo
  • biddingId: ID do anúncio
  • biddingInfoType: Tipo de anúncio
  • biddingProjectType: Tipo de projeto
  • biddingPublishTime: Data do anúncio
  • biddingEndTime: Prazo final de licitação
  • biddingProjectID: Número do projeto
  • biddingAgentInfoList: Lista de informações da agência de licitação
  • biddingPurchasingInfoList: Lista de informações da unidade licitante
  • biddingWinningInfoList: Lista de informações da unidade vencedora
  • biddingRegion: Região da licitação
  • hasFile: Possui anexos

7. bid_bigdata_planned_projects

Função: Consulta de projetos planejados

Consulta informações de anúncios de projetos planejados de empresas, permitindo recuperar detalhes de projetos planejados por nome da empresa, número de registro, código de crédito social ou ID da empresa.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência — nome da empresa/número de registro/código de crédito social unificado/id da empresa
  • pageIndex (opcional): Número da página — começa em 1
  • pageSize (opcional): Tamanho da página — máximo de 50 registros por página
  • keywordType (opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • total: Total
  • ppId: ID do projeto
  • deviceList: Equipamentos a adquirir
  • ppRegion: Local de construção
  • ppTitle: Nome do projeto
  • ppContent: Conteúdo do projeto
  • ppPublishTime: Data de publicação
  • ppApprovalTime: Data de avaliação

Casos de uso

  1. Compras governamentais: Consultar projetos de licitação adequados e acompanhar as dinâmicas de licitações
  2. Licitação empresarial: Encontrar oportunidades de licitação e analisar a situação dos concorrentes
  3. Análise de mercado: Analisar tendências do mercado de licitações e definir estratégias comerciais
  4. Avaliação de risco: Avaliar a capacidade de licitação e execução contratual das empresas
  5. Expansão comercial: Descobrir potenciais oportunidades de negócio e parceiros
  6. Pesquisa setorial: Compreender a atividade de licitações em setores específicos

Observações de uso

  1. Exigência de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se não houver o nome completo, primeiro chame a interface bid_bigdata_fuzzy_search para obter o nome completo da empresa
  2. Limite de paginação: Máximo de 50 registros por página
  3. Formato de data: O formato dos parâmetros de data é "YYYY-MM-DD"
  4. Unidade de valores: A unidade dos valores de projeto é dez mil (10.000)
  5. Filtro regional: Suporta seleção múltipla por província e cidade

Exemplos de perguntas de uso

bid_bigdata_fuzzy_search (Busca difusa por palavras-chave de empresas)

  1. Me ajude a encontrar informações de empresas que contenham a palavra-chave "中建"
  2. Buscar a lista de empresas relacionadas a "中铁"
  3. Consultar empresas cujo nome contenha "华为"

bid_bigdata_bid_win_stats (Análise estatística de vitórias em licitações de empresas)

  1. Analisar as estatísticas de vitórias em licitações da China State Construction Engineering Corporation
  2. Consultar a distribuição de valores de vitórias da Huawei Technologies
  3. Análise de tendências de vitórias da China Railway Construction Group

bid_bigdata_bidding_info (Consulta de informações de licitações de empresas)

  1. Consultar as informações de projetos de licitação em que a China State Construction participou
  2. Quais são os registros recentes de licitações da Huawei?
  3. Detalhes dos anúncios de licitação da China Railway Construction

bid_bigdata_tender_stats (Análise estatística de licitações de empresas)

  1. Analisar as estatísticas de licitações da State Grid
  2. Consultar a distribuição de valores de licitações da PetroChina
  3. Análise de tendências de licitações da China Mobile

bid_bigdata_procurement_stats (Análise estatística de compras de empresas)

  1. Analisar a distribuição de produtos adquiridos pela Huawei
  2. Consultar a distribuição regional de compras da Alibaba
  3. Dados estatísticos de compras da Tencent

bid_bigdata_bid_search (Busca de informações de licitações)

  1. Buscar projetos recentes de licitação para construção de estações 5G
  2. Encontrar informações de licitações de compras governamentais na província de Guangdong
  3. Buscar projetos de engenharia licitados com valor acima de 10 milhões

bid_bigdata_planned_projects (Consulta de projetos planejados)

  1. Consultar informações de projetos planejados da China State Construction
  2. Quais projetos de engenharia planejados a Huawei possui?
  3. Detalhes dos projetos planejados da China Railway Construction