企业风险分析洞察服务

Fornece análise abrangente de risco empresarial, incluindo registros de violações, informações de hipotecas, anomalias comerciais e casos judiciais.

Documentação

企业风险分析洞察服务

Este serviço MCP oferece funcionalidades abrangentes de análise de risco empresarial, incluindo consulta de registros de violações graves, informações de penhor de bens móveis, devedores inadimplentes, anomalias operacionais, penalidades administrativas e outras informações de risco, ajudando os usuários a realizar avaliações de risco de conformidade empresarial.

Principais funcionalidades

  • 🔍 Busca difusa por palavras-chave de empresas
  • ⚠️ Consulta de registros de violações graves
  • 🏦 Consulta de informações de penhor de bens móveis
  • 📋 Consulta de devedores inadimplentes
  • 🚫 Consulta de lista de anomalias operacionais
  • 💰 Consulta de informações de penalidades administrativas
  • ⚖️ Consulta de informações de casos judiciais

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-risk-insight-mcp-server
cd enterprise-risk-insight-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 do Cursor / Cherry Studio

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

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

Configurar MCP do Cursor / Cherry Studio

{
  "mcpServers": {
    "enterprise-risk-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 do Cursor / Cherry Studio

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

Funcionalidade: Busca difusa por palavras-chave de empresas

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

Valores de retorno:

  • total: Total

2. risk_insight_serious_violations

Funcionalidade: Consulta de registros de violações graves

Consulta os registros de violações graves de uma empresa sob supervisão governamental, incluindo informações detalhadas das violações graves e o status de tratamento.

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:

  • illegalCount: Quantidade de violações graves
  • illegalInfoList: Lista de violações graves
    • createAuthority: Órgão decisor (inclusão)
    • createDate: Data de inclusão
    • createReason: Motivo da inclusão
    • removeAuthority: Órgão decisor (remoção)
    • removeDate: Data de remoção
    • type: Categoria
    • removeReason: Motivo da remoção

3. risk_insight_chattel_mortgage

Funcionalidade: Consulta de informações de penhor de bens móveis

Consulta as informações de penhor de bens móveis de uma empresa, fornecendo dados detalhados sobre o penhor, incluindo quantidade de penhores, lista de informações e dados relacionados a entidades e créditos.

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:

  • mortgageCount: Quantidade de penhores de bens móveis
  • mortgageInfoList: Lista de penhores de bens móveis
    • authority: Órgão de registro
    • mortgageId: Número de registro
    • date: Data de registro
    • amount: Valor do crédito garantido
    • publicationDate: Data de divulgação
    • term: Prazo de cumprimento da obrigação do devedor
    • type: Tipo
    • guaranteedCreditorInfo: Informações da obrigação principal garantida
    • mortgageeList: Informações do credor hipotecário
    • pawnList: Informações do bem penhorado
    • revokeInfo: Informações de cancelamento

4. risk_insight_court_hearings

Funcionalidade: Consulta de avisos de audiências judiciais

Consulta informações de avisos de audiências relacionadas a uma determinada empresa, fornecendo detalhes de audiências e avisos.

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
  • pageSize (opcional): Tamanho da página
  • keywordType (opcional): Enumeração do tipo de entidade

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • address: Local da audiência
    • caseReason: Motivo do caso
    • date: Data da audiência
    • publishPage: Seção do aviso
    • publishDate: Data do aviso
    • publishUnit: Tribunal da audiência
    • caseType: Tipo de aviso
    • relatedCaseNumber: Número do caso
    • caseId: ID do aviso de audiência
    • caseRelatedPerson: Partes envolvidas

5. risk_insight_litigation_risk_profile

Funcionalidade: Consulta de perfil de risco de litígio

Consulta a situação de risco de litígio de uma empresa, gerando informações como avisos judiciais, avisos de registro de casos, avisos de audiências, documentos de decisão judicial, executados, devedores inadimplentes e restrições de consumo elevado.

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:

  • caList: Lista de avisos judiciais
  • caTotal: Total de avisos judiciais
  • caLianTotal: Total de avisos de registro de casos
  • caLianList: Lista de avisos de registro de casos
  • caKaitingTotal: Total de avisos de audiências
  • caKaitingList: Lista de avisos de audiências
  • jdTotal: Total de documentos de decisão judicial
  • jdList: Lista de documentos de decisão judicial
  • enforcementList: Lista de executados
  • edTotal: Total de devedores inadimplentes
  • edList: Lista de devedores inadimplentes
  • enforcementTotal: Total de executados
  • limitedTotal: Total de restrições de consumo elevado
  • limitedList: Lista de restrições de consumo elevado

6. risk_insight_court_announcements

Funcionalidade: Consulta de avisos judiciais

Consulta informações relacionadas a uma empresa específica em avisos judiciais, incluindo local da audiência, partes envolvidas, motivo do caso e outros detalhes.

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
  • pageSize (opcional): Tamanho da página
  • keywordType (opcional): Enumeração do tipo de entidade

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • caseType: Tipo de aviso
    • date: Data da audiência
    • caseRelatedPerson: Partes envolvidas
    • address: Local da audiência
    • publishDate: Data do aviso
    • publishUnit: Tribunal da audiência
    • caseReason: Motivo do caso
    • relatedCaseNumber: Número do caso
    • publishPage: Seção do aviso
    • caseId: ID do aviso judicial

7. risk_insight_intellectual_property_pledge

Funcionalidade: Consulta de penhor de propriedade intelectual

Recupera e retorna informações de penhor de propriedade intelectual de uma empresa, incluindo quantidade de penhores, listas relacionadas e informações detalhadas.

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:

  • iprPledgeCount: Quantidade de penhores de propriedade intelectual
  • iprPledgeList: Lista de penhores de propriedade intelectual
    • iprName: Nome da propriedade intelectual
    • iprPledgePeriod: Prazo de registro do penhor
    • iprPledgePublicDate: Data de divulgação da propriedade intelectual
    • iprPledgeeName: Credor do penhor de propriedade intelectual
    • iprRegisterNum: Número de registro da propriedade intelectual
    • iprPledgorName: Devedor do penhor de propriedade intelectual
    • iprType: Tipo de propriedade intelectual
    • iprPledgeRevokeDate: Data de cancelamento da propriedade intelectual
    • iprPledgeRevokeReason: Motivo do cancelamento da propriedade intelectual
    • iprStatus: Status da propriedade intelectual

8. risk_insight_penalties

Funcionalidade: Consulta de penalidades administrativas

Consulta os registros de penalidades administrativas de uma empresa, incluindo informações detalhadas das penalidades.

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:

  • taxPenaltyCount: Quantidade de penalidades administrativas fiscais
  • taxPenaltyList: Lista de penalidades administrativas fiscais
    • penaltyDate: Data da penalidade
    • penaltyAmount: Valor da penalidade
    • penaltyReason: Motivo da penalidade
    • penaltyType: Tipo de penalidade
    • penaltyAuthority: Órgão de penalidade
    • penaltyDecisionNumber: Número do documento de decisão de penalidade
    • legalBasis: Base legal
    • penaltyStatus: Status da penalidade

9. risk_insight_business_anomalies

Funcionalidade: Consulta de anomalias operacionais

Consulta informações de anomalias operacionais de uma empresa, incluindo quantidade de anomalias e lista detalhada de informações.

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:

  • anomalyCount: Quantidade de anomalias operacionais
  • anomalyList: Lista de anomalias operacionais
    • removeAuthority: Órgão decisor de remoção
    • createDate: Data de inclusão
    • removeDate: Data de remoção
    • createReason: Motivo da inclusão na lista de anomalias operacionais
    • removeReason: Motivo da remoção da lista de anomalias operacionais
    • createAuthority: Órgão decisor de inclusão

10. risk_insight_consumption_restrictions

Funcionalidade: Consulta de restrições de consumo elevado

Consulta se uma empresa específica ou seus responsáveis possuem registros judiciais de restrição de consumo elevado.

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
  • keywordType (opcional): Enumeração do tipo de entidade
  • pageSize (opcional): Tamanho da página

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • efCaseCreateTime: Data de registro do caso
    • efCaseNumber: Número do caso
    • efLimitedApplicant: Requerente
    • efExecutiveCourt: Tribunal de execução
    • efLimitedPersonCasePublishTime: Data de publicação
    • efLimitedPersonName: Pessoa com restrição de consumo
    • efLimitedPersonProvince: Província

11. enterprise_risk_insight_score

Funcionalidade: Consulta de pontuação de risco empresarial

Consulta a pontuação de risco e o nível de risco de uma empresa informando o nome completo da empresa, além de listar a situação detalhada da pontuação, para cenários como revisão de risco de admissão de empresas. Se o nome completo da empresa não estiver disponível, primeiro utilize a ferramenta de busca difusa de empresas para obter o nome completo.

Parâmetros:

  • matchKeyword (obrigatório): Nome da empresa / número de registro / código de crédito social unificado / ID da empresa. Se o nome completo da empresa não estiver disponível, primeiro utilize a ferramenta de busca difusa de empresas para obter o nome completo.
  • keywordType (opcional): Enumeração do 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:

  • riskReason: Lista de motivos de risco
  • riskScore: Pontuação de risco
  • riskLevel: Nível de risco

Cenários de uso

  1. Aprovação de empréstimos financeiros: Bancos ou instituições financeiras avaliam o risco de conformidade de empresas tomadoras de empréstimos
  2. Due diligence empresarial: Investidores ou parceiros obtêm o histórico de conformidade de empresas-alvo
  3. Verificação de antecedentes em contratações: Departamentos de RH verificam o histórico e a legalidade de empresas candidatas
  4. Conformidade regulatória: Órgãos reguladores governamentais realizam supervisão de conformidade e decisões de penalidades
  5. Gestão de risco comercial: Empresas realizam avaliação de risco antes de parcerias comerciais
  6. Due diligence jurídica: Escritórios de advocacia realizam avaliação de risco jurídico de empresas

Observações de uso

  1. Exigência de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se o nome completo não estiver disponível, primeiro utilize a interface risk_insight_fuzzy_search para obter o nome completo
  2. Atualidade dos dados: As informações de risco são atualizadas constantemente; recomenda-se consultas periódicas para obter o status mais recente
  3. Avaliação abrangente: Recomenda-se combinar informações de risco de múltiplas dimensões para uma avaliação abrangente
  4. Conformidade legal: Ao usar informações de risco, é necessário cumprir as leis, regulamentos e requisitos de proteção de privacidade aplicáveis

Exemplos de perguntas

risk_insight_fuzzy_search (Busca difusa por palavras-chave de empresas)

  1. Ajude-me a encontrar informações de empresas que contenham a palavra-chave "Tencent"
  2. Pesquise a lista de empresas relacionadas a "Alibaba"
  3. Consulte empresas cujo nome contenha "Douyin"

risk_insight_serious_violations (Consulta de registros de violações graves)

  1. Consulte os registros de violações graves da Tencent Technology Co., Ltd.
  2. Verifique se a Douyin possui violações graves
  3. Quais são os registros de violações do Alibaba Group?

risk_insight_chattel_mortgage (Consulta de informações de penhor de bens móveis)

  1. Consulte as informações de penhor de bens móveis da Tencent
  2. A Alibaba possui registros de penhor de bens móveis?
  3. Verifique a situação de penhor e garantia da Douyin

risk_insight_court_hearings (Consulta de avisos de audiências judiciais)

  1. Consulte as informações de avisos de audiências relacionadas à Tencent
  2. Quais avisos de audiências judiciais a Alibaba possui recentemente?
  3. Verifique as informações de audiências da Douyin

risk_insight_litigation_risk_profile (Consulta de perfil de risco de litígio)

  1. Analise a situação geral de risco de litígio da Tencent
  2. Como é o perfil de risco jurídico da Alibaba?
  3. Avaliação de risco judicial da Douyin

risk_insight_court_announcements (Consulta de avisos judiciais)

  1. Consulte as informações da Tencent em avisos judiciais
  2. Quais registros de avisos judiciais a Alibaba possui?
  3. Verifique a situação de avisos judiciais da Douyin

risk_insight_intellectual_property_pledge (Consulta de penhor de propriedade intelectual)

  1. Consulte a situação de penhor de propriedade intelectual da Tencent
  2. A Alibaba possui penhor de propriedade intelectual?
  3. Informações de penhor de propriedade intelectual da Douyin

risk_insight_tax_penalties (Consulta de penalidades administrativas fiscais)

  1. Consulte os registros de penalidades fiscais da Tencent
  2. A Alibaba possui penalidades por violações fiscais?
  3. Verifique a conformidade fiscal da Douyin

risk_insight_business_anomalies (Consulta de anomalias operacionais)

  1. Consulte se a Tencent foi incluída na lista de anomalias operacionais
  2. Como está a situação de anomalias operacionais da Alibaba?
  3. A Douyin possui registros de anomalias operacionais?

risk_insight_consumption_restrictions (Consulta de restrições de consumo elevado)

  1. Consulte se a Tencent e seus executivos possuem ordens de restrição de consumo
  2. Os executivos da Alibaba possuem registros de restrição de consumo elevado?
  3. Verifique a situação de restrição de consumo da Douyin

enterprise_risk_insight_score (Consulta de pontuação de risco empresarial)

  1. Consulte a pontuação de risco e o nível da Tencent Technology Co., Ltd.
  2. Analise a situação geral de pontuação de risco do Alibaba Group
  3. Qual é a pontuação de risco empresarial da Douyin?
  4. Avalie o nível de risco de admissão de uma empresa