招投标大数据服务

Serviço de Big Data de Licitações

Este serviço MCP oferece funcionalidades abrangentes de consulta de informações empresariais em plataformas de e-commerce, incluindo informações de lojas online, análise de dados de vendas, estatísticas de categorias de produtos, entre outros, ajudando os usuários a entender o layout de negócios de e-commerce das empresas.

Principais Funcionalidades

• 🔍 Busca difusa por palavras-chave de empresas
• 🛒 Consulta de perfil de lojas online globais
• 📊 Análise de perfil de produtos de e-commerce
• 🏬 Consulta de informações de lojas de e-commerce
• 📦 Estatísticas de categorias de produtos
• 🌐 Análise de distribuição de plataformas

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/estore-mcp-server
cd estore-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 do 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 o MCP no 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"
      }
    }
  }
}

Usar o Serviço Remoto Oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

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

Observação: integrator_id, secret_id, secret_key e token precisam ser obtidos fazendo login em https://www.handaas.com/ para registrar e ativar a plataforma

Ferramentas Disponíveis

1. estore_bigdata_fuzzy_search

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

Busca difusa por lista de empresas relacionadas com base em palavras-chave fornecidas, como nome da empresa, nome de pessoa, marca, produto, cargo, 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
  • nameId: ID da empresa
  • name: Nome da empresa
  • socialCreditCode: Código de crédito social unificado
  • legalRepresentative: Representante legal
  • enterpriseType: Tipo de entidade empresarial
  • operStatus: Status da empresa
  • address: Endereço de registro
  • foundTime: Data de fundação
  • regCapitalValue: Valor do capital registrado
  • catchReason: Motivo da correspondência

2. estore_bigdata_global_online_store_profile

Função: Consulta de perfil de lojas online globais

Fornece informações de perfil das lojas online da empresa no país e no exterior, incluindo número de lojas online, volume total de produtos, plataformas de vendas, principais marcas e produtos, entre outros detalhes.

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): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode

Valores de retorno:

• domesticEshopCount: Número de lojas online domésticas
• domesticEshopProductCount: Volume total de produtos em lojas online domésticas
• domesticEshopBrandList: Principais marcas das lojas online domésticas
• domesticEshopPlatformList: Plataformas de listagem das lojas online domésticas
• domesticEshopProductList: Principais produtos das lojas online domésticas
• domesticEshopSourceList: Fonte das lojas online domésticas
• foreignEshopCount: Número de lojas online no exterior
• foreignEshopProductCount: Volume total de produtos em lojas online no exterior
• foreignEshopBrandList: Principais marcas das lojas online no exterior
• foreignEshopPlatformList: Plataformas de listagem das lojas online no exterior
• foreignEshopProductList: Principais produtos das lojas online no exterior
• foreignEshopSourceList: Fonte das lojas online no exterior

3. estore_bigdata_ecommerce_product_profile

Função: Análise de perfil de produtos de e-commerce

Consulta o perfil das lojas e produtos da empresa em plataformas de e-commerce, incluindo informações de marca, avaliações, data de criação, entre outros detalhes.

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): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode

Valores de retorno:

• ecShopNumber: Número de lojas
• ecShopItemCount: Total de produtos nas lojas
• ecShopAvgRates: Avaliação média das lojas (pontos)
• ecShopEarliestFoundTime: Data de criação das lojas
• ecShopItemCategories: Categorias de produtos
• ecShopBrands: Principais marcas
• ecShopProducts: Principais produtos
• ecSources: Plataformas de listagem

4. estore_bigdata_ecommerce_store_info

Função: Consulta de informações de lojas de e-commerce

Consulta informações de lojas online associadas à empresa, retornando detalhes das lojas e uma visão geral dos dados de negócios.

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): Enumeração do tipo de entidade - name/nameId/regNumber/socialCreditCode

Valores de retorno:

• eshopListCount: Total de lojas online associadas
• enterpriseEshopCount: Número de lojas online
• enterpriseEshopProductsCount: Volume total de produtos nas lojas online
• enterpriseEshopBrands: Principais marcas
• enterpriseEshopProducts: Principais produtos
• enterpriseEshopPlatforms: Plataformas de listagem das lojas online
• eshopList: Lista de lojas online associadas
  • eshopName: Nome da loja online
  • eshopKeeper: Nome do gerente da loja
  • eshopFoundTime: Data de abertura da loja
  • eshopUrl: URL da loja online
  • eshopIconLink: Logotipo da loja online
  • eshopProducts: Categoria principal
  • enterpriseName: Empresa proprietária
  • address: Localização da loja online
  • businessStatistics: Situação operacional
  • isExpired: Se a loja online está expirada
• overview: Visão geral dos dados da loja online

Cenários de Uso

1. Análise de operações de e-commerce: Entender a situação operacional e o desempenho de mercado da empresa nas plataformas de e-commerce
2. Pesquisa de concorrentes: Analisar o layout de e-commerce e as estratégias de vendas dos concorrentes
3. Pesquisa de mercado: Estudar tendências de desenvolvimento e oportunidades de mercado do e-commerce em setores específicos
4. Decisões de investimento: Avaliar o potencial de desenvolvimento e o valor comercial dos negócios de e-commerce da empresa
5. Seleção de parceiros: Encontrar parceiros e fornecedores de e-commerce de qualidade
6. Monitoramento de marca: Monitorar o desempenho e a reputação da marca da empresa nas plataformas de e-commerce
7. Análise da cadeia de suprimentos: Entender a cadeia de suprimentos de e-commerce e a distribuição de produtos da empresa

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 estore_bigdata_fuzzy_search para obter o nome completo
2. Diferenças entre plataformas: A estrutura de dados e os métodos de estatística podem variar entre diferentes plataformas de e-commerce
3. Atualidade dos dados: Os dados de e-commerce são atualizados com frequência, recomenda-se observar os carimbos de data/hora dos dados
4. Dados de vendas: Alguns dados de vendas podem ser valores estimados, apenas para referência
5. Dados internacionais: A integridade e a precisão dos dados de lojas online no exterior podem ser limitadas pela fonte dos dados
6. Status das lojas: Preste atenção para distinguir entre lojas ativas e lojas fechadas

Exemplos de Perguntas de Uso

estore_bigdata_global_online_store_profile (Consulta de perfil de lojas online globais)

3. Quantas lojas online a Xiaomi possui no país e no exterior? Quais são as principais marcas e produtos vendidos?
4. Como está a distribuição das lojas online globais da Huawei? Qual é o volume total de produtos?
5. Quais plataformas a BYD cobre em seus negócios de e-commerce? Como estão as lojas online no exterior?

estore_bigdata_ecommerce_product_profile (Análise de perfil de produtos de e-commerce)

6. Quantas lojas de e-commerce a Xiaomi possui? Como está a avaliação média?
7. Qual é o total de produtos nas lojas online da Huawei? Quais são as principais categorias de produtos?
8. Qual é a data de criação mais antiga das lojas de e-commerce da BYD? Quais são as principais marcas?

estore_bigdata_ecommerce_store_info (Consulta de informações de lojas de e-commerce)

9. Qual é o total de lojas online associadas à Xiaomi? Quais são os detalhes das lojas?
10. Em quais plataformas as lojas online da Huawei estão distribuídas principalmente? Quais são os nomes dos gerentes das lojas?
11. Como está a situação operacional das lojas de e-commerce da BYD? Existem lojas expiradas?