招投标大数据服务
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
招投标大数据服务
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-chavepageIndex(opcional): Posição inicial da paginaçãopageSize(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 empresakeywordType(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óriasrange: Faixa de valorespercent: Proporçãocount: Quantidade
winbidAreaStat: Distribuição regionalarea: Regiãocount: Quantidade
winbidStatList: Distribuição de objetos licitados vencidossubjectMatter: Objeto licitadocount: Quantidadepercent: Proporção
winbidTrend: Tendência de vitóriasyear: Anocount: 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 empresapageSize(opcional): Tamanho da página — máximo de 50 registros por páginakeywordType(opcional): Tipo de entidade — name: nome da empresa, nameId: id da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificadopageIndex(opcional): Número da página — começa em 1
Valores de retorno:
total: TotalbiddingId: ID da licitaçãoinfoType: Tipo de anúncio de licitaçãoprojectRegion: Região do projetopublishDate: Data de publicação do anúnciosubjectMatterList: Objeto licitadotitle: Título do anúnciorole: Papel na licitação — licitante, vencedorprojectAmount: Valor do projetowinningBidderList: Empresa vencedorapurchasingBidderList: 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 empresakeywordType(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çõesrange: Faixa de valorespercent: Proporçãocount: Quantidade
tenderAreaStat: Distribuição regionalarea: Regiãocount: Quantidade
tenderStatList: Distribuição de objetos de licitaçãosubjectMatter: Objeto licitadocount: Quantidadepercent: Proporção
tenderTrend: Tendência de licitaçõesyear: Anocount: 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 unificadomatchKeyword(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 adquiridoscount: Quantidade adquiridapercent: Percentualproduct: Nome do produto
purchasingAreaStatList: Distribuição regional de comprastimes: Número de clientesarea: 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 recentebiddingType(opcional): Tipo de informação — enumeração de tipos de licitaçãobiddingRegion(opcional): Região do projeto — seleção múltipla, suporta províncias e cidadesbiddingAnncPubStartTime(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 completobiddingProjectMaxAmount(opcional): Valor máximo do projeto — unidade: dez milbiddingPurchasingType(opcional): Tipo de unidade licitante — governo, escola, hospital, etc.biddingProjectMinAmount(opcional): Valor mínimo do projeto — unidade: dez milpageIndex(opcional): Índice de paginaçãopageSize(opcional): Tamanho da página — máximo de 50 registros por página
Valores de retorno:
total: TotalbiddingAnncTitle: Título do anúnciobiddingContent: ConteúdobiddingId: ID do anúnciobiddingInfoType: Tipo de anúnciobiddingProjectType: Tipo de projetobiddingPublishTime: Data do anúnciobiddingEndTime: Prazo final de licitaçãobiddingProjectID: Número do projetobiddingAgentInfoList: Lista de informações da agência de licitaçãobiddingPurchasingInfoList: Lista de informações da unidade licitantebiddingWinningInfoList: Lista de informações da unidade vencedorabiddingRegion: Região da licitaçãohasFile: 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 empresapageIndex(opcional): Número da página — começa em 1pageSize(opcional): Tamanho da página — máximo de 50 registros por páginakeywordType(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: TotalppId: ID do projetodeviceList: Equipamentos a adquirirppRegion: Local de construçãoppTitle: Nome do projetoppContent: Conteúdo do projetoppPublishTime: Data de publicaçãoppApprovalTime: Data de avaliação
Casos de uso
- Compras governamentais: Consultar projetos de licitação adequados e acompanhar as dinâmicas de licitações
- Licitação empresarial: Encontrar oportunidades de licitação e analisar a situação dos concorrentes
- Análise de mercado: Analisar tendências do mercado de licitações e definir estratégias comerciais
- Avaliação de risco: Avaliar a capacidade de licitação e execução contratual das empresas
- Expansão comercial: Descobrir potenciais oportunidades de negócio e parceiros
- Pesquisa setorial: Compreender a atividade de licitações em setores específicos
Observações de uso
- 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
- Limite de paginação: Máximo de 50 registros por página
- Formato de data: O formato dos parâmetros de data é "YYYY-MM-DD"
- Unidade de valores: A unidade dos valores de projeto é dez mil (10.000)
- 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)
- Me ajude a encontrar informações de empresas que contenham a palavra-chave "中建"
- Buscar a lista de empresas relacionadas a "中铁"
- Consultar empresas cujo nome contenha "华为"
bid_bigdata_bid_win_stats (Análise estatística de vitórias em licitações de empresas)
- Analisar as estatísticas de vitórias em licitações da China State Construction Engineering Corporation
- Consultar a distribuição de valores de vitórias da Huawei Technologies
- 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)
- Consultar as informações de projetos de licitação em que a China State Construction participou
- Quais são os registros recentes de licitações da Huawei?
- Detalhes dos anúncios de licitação da China Railway Construction
bid_bigdata_tender_stats (Análise estatística de licitações de empresas)
- Analisar as estatísticas de licitações da State Grid
- Consultar a distribuição de valores de licitações da PetroChina
- Análise de tendências de licitações da China Mobile
bid_bigdata_procurement_stats (Análise estatística de compras de empresas)
- Analisar a distribuição de produtos adquiridos pela Huawei
- Consultar a distribuição regional de compras da Alibaba
- Dados estatísticos de compras da Tencent
bid_bigdata_bid_search (Busca de informações de licitações)
- Buscar projetos recentes de licitação para construção de estações 5G
- Encontrar informações de licitações de compras governamentais na província de Guangdong
- Buscar projetos de engenharia licitados com valor acima de 10 milhões
bid_bigdata_planned_projects (Consulta de projetos planejados)
- Consultar informações de projetos planejados da China State Construction
- Quais projetos de engenharia planejados a Huawei possui?
- Detalhes dos projetos planejados da China Railway Construction