招投标大数据服务

Fornece funções abrangentes de consulta de dados de comércio de importação e exportação, incluindo análise de tendências, estatísticas de produtos e distribuição geográfica.

GitHub
14
Experimente este MCPPatrocinado

Documentação

Serviço de Big Data para Licitações

Este serviço MCP oferece funcionalidades abrangentes de consulta a dados de comércio exterior, incluindo análise de tendências de exportação, estatísticas por categoria de mercadoria, distribuição geográfica de pedidos, informações de certificações no exterior, entre outros, ajudando os usuários a compreender a situação do comércio internacional das empresas.

Principais Funcionalidades

  • 🔍 Busca difusa por palavras-chave de empresas
  • 📈 Análise de tendências de exportação
  • 📦 Análise de mercadorias exportadas
  • 🌍 Distribuição geográfica de pedidos
  • 👥 Análise de recrutamento para comércio exterior
  • 📋 Consulta de certificações no exterior

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/customs-mcp-server
cd customs-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": {
    "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 o Serviço Remoto Oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

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

Observação: integrator_id, secret_id, secret_key e token exigem login em https://www.handaas.com/ para registrar e obter acesso à plataforma

Ferramentas Disponíveis

1. customs_bigdata_fuzzy_search

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

Consulta a 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
  • pageIndex (opcional): Posição inicial da paginação
  • pageSize (opcional): Posição final da paginação

Valores de retorno:

  • total: Total

2. customs_bigdata_export_trends

Função: Análise de tendências de exportação

Consulta as tendências de exportação da empresa com base nas informações de identificação da empresa, incluindo valores anuais de exportação e número de pedidos, entre outros dados.

Parâmetros:

  • matchKeyword (obrigatório): 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

Valores de retorno:

  • exportTrend: Lista de anos de exportação
    • amount: Valor (USD)
    • count: Número de pedidos
    • year: Ano
  • total: Total de anos de exportação

3. customs_bigdata_export_product_trends

Função: Análise de tendências de mercadorias exportadas

Consulta e analisa as tendências de desenvolvimento das mercadorias de comércio exterior da empresa, fornecendo informações sobre o volume de pedidos de exportação por ano e a distribuição dos códigos HS da alfândega.

Parâmetros:

  • matchKeyword (obrigatório): 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

Valores de retorno:

  • exportGoodsOrderDistribution: Distribuição do volume de pedidos de mercadorias exportadas
    • orderCountOfYear: Volume de pedidos por ano
    • count: Quantidade
    • hsCode: Código HS da alfândega
    • year: Ano
  • exportGoodsOrderTrend: Tendência do volume de pedidos de mercadorias exportadas
    • year: Ano
    • count: Quantidade
    • name: Nome

4. customs_bigdata_export_recruitment_profile

Função: Análise de recrutamento para comércio exterior

Obtém informações sobre o recrutamento de vagas relacionadas ao comércio exterior nos últimos três meses, com base nas informações de identificação da empresa fornecidas.

Parâmetros:

  • matchKeyword (obrigatório): 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

Valores de retorno:

  • recruitingLatestThreeMonthCount: Número de vagas de recrutamento nos últimos três meses
  • recruitingCityCount: Número de cidades com recrutamento
  • recruitingCityList: Cidades com recrutamento
  • recruitingCount: Número de vagas de recrutamento
  • recruitingPositions: Nome das vagas de recrutamento
  • recruitingPlatforms: Plataformas de vagas relacionadas ao comércio exterior
  • recruitingSourceCount: Número de canais de recrutamento
  • recruitingSourceList: Canais de recrutamento

5. customs_bigdata_export_order_regions

Função: Distribuição geográfica de pedidos de exportação

Consulta a distribuição geográfica dos pedidos de comércio exterior da empresa com base nas informações de identificação fornecidas, incluindo valores e quantidades de pedidos por região.

Parâmetros:

  • matchKeyword (obrigatório): 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): Enumeração do tipo de entidade

Valores de retorno:

  • resultList: Lista de distribuição regional de pedidos
    • amount: Valor (USD)
    • count: Número de pedidos
    • destCountry: País/Região
    • weight: Peso líquido (kg)
  • total: Total de regiões de distribuição

6. customs_bigdata_overseas_certifications

Função: Consulta de informações de certificações no exterior

Consulta as informações de certificações no exterior da empresa com base no nome, número de registro, etc., incluindo categorias de certificação, números de certificados e informações de produtos relacionados.

Parâmetros:

  • matchKeyword (obrigatório): 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

Valores de retorno:

  • certType: Categoria de certificação
  • certId: Número do certificado
  • certCount: Total
  • certDomain: Área de certificação
  • certProductName: Nome do produto

Casos de Uso

  1. Análise de comércio internacional de empresas: Compreender a capacidade de exportação e as tendências de participação de mercado das empresas
  2. Pesquisa de concorrentes: Analisar o desempenho dos concorrentes no mercado internacional
  3. Avaliação de risco financeiro: Bancos ou instituições de investimento avaliam os riscos e retornos do comércio internacional das empresas
  4. Estratégia de expansão de mercado: Desenvolver estratégias mais eficazes de expansão no mercado internacional
  5. Pesquisa estatística governamental: Governos ou associações industriais estatizam as tendências gerais de exportação das empresas
  6. Verificação de qualificações em licitações: Empresas apresentam comprovações de qualificações durante o processo de licitação

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 customs_bigdata_fuzzy_search para obter o nome completo
  2. Limite de paginação: Máximo de 50 registros por página
  3. Unidade monetária: Valores de exportação em dólares americanos (USD)
  4. Unidade de peso: Peso líquido em quilogramas (kg)
  5. Período de tempo: Informações de recrutamento referem-se aos últimos três meses
  6. Código HS: A classificação de mercadorias é baseada no padrão de códigos HS da alfândega

Exemplos de Perguntas

customs_bigdata_export_trends (Análise de tendências de exportação)

  1. Como está a tendência do valor de exportação da Huawei nos últimos anos? Houve mudanças no número de pedidos?
  2. Como está o desempenho das exportações da BYD?
  3. O negócio de exportação da Xiaomi está em crescimento ou declínio?

customs_bigdata_export_product_trends (Análise de tendências de mercadorias exportadas)

  1. Quais são as principais mercadorias exportadas pela Huawei? Como está a distribuição do volume de pedidos por categoria de produto?
  2. Como é a estrutura das mercadorias exportadas pela BYD? Como está a distribuição dos códigos HS?
  3. Quais mudanças ocorreram nas categorias de mercadorias exportadas pela Xiaomi ao longo dos anos?

customs_bigdata_export_recruitment_profile (Análise de recrutamento para comércio exterior)

  1. A Huawei está recrutando vagas relacionadas ao comércio exterior nos últimos três meses?
  2. Como está o recrutamento da equipe de comércio exterior da BYD? Em quais cidades estão contratando?
  3. Quais plataformas a Xiaomi utiliza principalmente para recrutamento de comércio exterior? A demanda por vagas é alta?

customs_bigdata_export_order_regions (Distribuição geográfica de pedidos de exportação)

  1. Em quais países e regiões os pedidos de exportação da Huawei estão distribuídos principalmente?
  2. Como está a cobertura do mercado internacional da BYD? Como estão os valores de pedidos por região?
  3. Para quais mercados os produtos da Xiaomi são exportados principalmente?

customs_bigdata_overseas_certifications (Consulta de certificações no exterior)

  1. Quais certificações internacionais a Huawei obteve? Quais são as principais áreas de certificação?
  2. Quantas certificações de produtos internacionais a BYD possui? Quais são as categorias de certificados?
  3. Quais certificações internacionais os produtos da Xiaomi obtiveram?