企业基础信息服务

Fornece serviços básicos de informações empresariais, incluindo registro comercial, perfis de empresas, acionistas e principais executivos.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Serviço de Big Data Empresarial

Este serviço MCP oferece funções básicas de consulta, como informações de registro comercial de empresas, resumo da empresa, tags da empresa, negócios da empresa, informações de acionistas controladores, informações de investimentos externos, informações de filiais e informações dos principais funcionários.

Principais Funcionalidades

  • 🔍 Pesquisa difusa por palavras-chave de empresas
  • 🏢 Consulta de informações básicas da empresa
  • 👥 Informações de acionistas controladores
  • 💰 Informações de investimentos externos
  • 🏪 Informações de filiais
  • 👨‍💼 Informações dos principais funcionários

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/enterprise-mcp-server
cd enterprise-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 do 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 com 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": {
    "enterprise-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"
      }
    }
  }
}

Usando o Serviço Remoto Oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

{
  "mcpServers": {
    "enterprise-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/enterprise/enterprise_profile?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. enterprise_get_keyword_search

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

Consulta difusa de 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 correspondente
  • 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:

  • catchReason: Motivo da correspondência
  • address: Endereço
  • enterpriseType: Tipo de empresa
  • foundTime: Data de fundação
  • homepage: Site oficial
  • legalRepresentative: Representante legal
  • name: Nome da empresa
  • operStatus: Status operacional
  • regCapitalCoinType: Moeda do capital registrado
  • regCapitalValue: Capital registrado
  • annualTurnover: Faturamento anual

2. enterprise_get_enterprise_base_info

Função: Consultar informações básicas da empresa

Consulta informações relacionadas aos negócios da empresa inserindo o nome completo da empresa, identificando o que a empresa faz.

Parâmetros:

  • keyword (obrigatório): Nome completo da empresa

Valores de retorno:

  • base_info: Informações de registro comercial da empresa
  • desc: Resumo da empresa
  • business_info: Negócios da empresa
  • tag: Tags da empresa

3. enterprise_get_enterprise_holder_info

Função: Consultar informações de acionistas controladores

Consulta informações de acionistas controladores inserindo o nome completo da empresa. Essas informações são obtidas por meio da análise de dados de registro comercial e de todos os dados da 旷湖.

Parâmetros:

  • keyword (obrigatório): Nome completo da empresa

Valores de retorno:

  • holderList: Lista de acionistas (divulgação comercial)
    • entityType: Tipo de entidade
    • holderType: Tipo de acionista
    • name: Nome do acionista
    • nameId: ID da empresa
    • humanId: ID da pessoa
    • payAmount: Valor integralizado
    • ratio: Percentual de participação
    • subscriptionDetail: Informações de subscrição
  • stockHolderList: Lista de acionistas (divulgação mais recente) proveniente de informações de listagem em bolsa

4. enterprise_get_enterprise_invest_info

Função: Consultar informações de investimentos externos da empresa

Consulta informações de investimentos externos da empresa inserindo o nome completo da empresa. Essas informações são obtidas por meio da análise de dados de registro comercial e de todos os dados da 旷湖.

Parâmetros:

  • keyword (obrigatório): Nome completo da empresa

Valores de retorno:

  • resultList: Lista de resultados de investimentos externos
    • addressValue: Região da empresa investida
    • business: Escopo de operações da empresa investida
    • foundTime: Data de fundação da empresa investida
    • isListed: Status de listagem da empresa investida
    • legalRepresentative: Representante legal da empresa investida
    • name: Nome da empresa que realiza o investimento externo
    • operStatus: Status operacional da empresa que realiza o investimento externo
    • ratio: Percentual de participação acionária
    • regCapital: Capital registrado da empresa investida
    • scCode: Código de crédito unificado da empresa que realiza o investimento externo
    • subscriptionAmount: Informações do valor do investimento

5. enterprise_get_enterprise_branch_info

Função: Consultar informações de filiais da empresa

Consulta informações de filiais da empresa inserindo o nome completo da empresa. As informações de filiais são provenientes da divulgação comercial.

Parâmetros:

  • keyword (obrigatório): Nome completo da empresa

Valores de retorno:

  • resultList: Lista de resultados de filiais
    • addressValue: Informações de endereço
    • foundTime: Data de fundação
    • legalRepresentative: Representante legal
    • name: Nome da instituição
    • operStatus: Status operacional
    • orgCode: Código da organização
    • registrationAuthority: Órgão de registro
    • socialCreditCode: Código de crédito social unificado

6. enterprise_get_enterprise_main_person_info

Função: Consultar informações dos principais funcionários da empresa

Consulta informações dos principais funcionários da empresa inserindo o nome completo da empresa. As informações dos principais funcionários são provenientes da divulgação comercial.

Parâmetros:

  • keyword (obrigatório): Nome completo da empresa

Valores de retorno:

  • resultList: Lista de resultados dos principais funcionários
    • name: Nome do membro
    • position: Cargo
    • ratio: Percentual de participação
    • relatedEnterpriseCurrentNum: Número de empresas em que atua atualmente
    • relatedEnterpriseHistoryNum: Número de empresas em que atuou anteriormente

Observações de Uso

  1. Requisito de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, é necessário primeiro chamar a interface de pesquisa difusa por palavras-chave para completar o nome e, em seguida, chamar a interface.
  2. Limite da API: Em consultas paginadas, o máximo é de 50 registros por página.
  3. Tratamento de erros: Todas as interfaces incluem tratamento de erros; quando a consulta falha, uma mensagem de erro correspondente é retornada.

Exemplos de Perguntas de Uso

enterprise_get_keyword_search (Pesquisa difusa por palavras-chave de empresas)

  1. Ajude-me a encontrar informações de empresas que contenham a palavra-chave "探迹"
  2. Pesquise a lista de empresas relacionadas à "腾讯"
  3. Consulte empresas cujo nome contenha "阿里巴巴"

enterprise_get_enterprise_base_info (Consulta de informações básicas da empresa)

  1. O que a 探迹科技 faz?
  2. Qual é o negócio principal da 腾讯科技有限公司?
  3. Resumo da empresa 北京字节跳动科技有限公司

enterprise_get_enterprise_holder_info (Informações de acionistas controladores)

  1. Quais são os acionistas da 探迹科技?
  2. Quem são os acionistas controladores da 腾讯?
  3. Consulte as informações da estrutura acionária da 字节跳动

enterprise_get_enterprise_invest_info (Informações de investimentos externos da empresa)

  1. Em quais empresas a 探迹科技 investiu externamente?
  2. Em quais empresas a 腾讯 investiu?
  3. Qual é o portfólio de investimentos da 阿里巴巴?

enterprise_get_enterprise_branch_info (Informações de filiais da empresa)

  1. Quais filiais a 探迹科技 possui?
  2. Quais filiais a 腾讯 possui em todo o país?
  3. Distribuição das filiais da 华为

enterprise_get_enterprise_main_person_info (Informações dos principais funcionários da empresa)

  1. Quais são os principais gestores da 探迹科技?
  2. Informações da equipe executiva da 腾讯
  3. Composição dos funcionários principais da 字节跳动