企业风险分析洞察服务
Fornece análise abrangente de risco empresarial, incluindo registros de violações, informações de hipotecas, anomalias comerciais e casos judiciais.
Documentação
企业风险分析洞察服务
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ênciapageIndex(opcional): Posição inicial da paginaçãopageSize(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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
illegalCount: Quantidade de violações gravesillegalInfoList: Lista de violações gravescreateAuthority: Órgão decisor (inclusão)createDate: Data de inclusãocreateReason: Motivo da inclusãoremoveAuthority: Órgão decisor (remoção)removeDate: Data de remoçãotype: CategoriaremoveReason: 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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
mortgageCount: Quantidade de penhores de bens móveismortgageInfoList: Lista de penhores de bens móveisauthority: Órgão de registromortgageId: Número de registrodate: Data de registroamount: Valor do crédito garantidopublicationDate: Data de divulgaçãoterm: Prazo de cumprimento da obrigação do devedortype: TipoguaranteedCreditorInfo: Informações da obrigação principal garantidamortgageeList: Informações do credor hipotecáriopawnList: Informações do bem penhoradorevokeInfo: 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 empresapageIndex(opcional): Número da páginapageSize(opcional): Tamanho da páginakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
total: TotalresultList: Lista de resultadosaddress: Local da audiênciacaseReason: Motivo do casodate: Data da audiênciapublishPage: Seção do avisopublishDate: Data do avisopublishUnit: Tribunal da audiênciacaseType: Tipo de avisorelatedCaseNumber: Número do casocaseId: ID do aviso de audiênciacaseRelatedPerson: 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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
caList: Lista de avisos judiciaiscaTotal: Total de avisos judiciaiscaLianTotal: Total de avisos de registro de casoscaLianList: Lista de avisos de registro de casoscaKaitingTotal: Total de avisos de audiênciascaKaitingList: Lista de avisos de audiênciasjdTotal: Total de documentos de decisão judicialjdList: Lista de documentos de decisão judicialenforcementList: Lista de executadosedTotal: Total de devedores inadimplentesedList: Lista de devedores inadimplentesenforcementTotal: Total de executadoslimitedTotal: Total de restrições de consumo elevadolimitedList: 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 empresapageIndex(opcional): Número da páginapageSize(opcional): Tamanho da páginakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
total: TotalresultList: Lista de resultadoscaseType: Tipo de avisodate: Data da audiênciacaseRelatedPerson: Partes envolvidasaddress: Local da audiênciapublishDate: Data do avisopublishUnit: Tribunal da audiênciacaseReason: Motivo do casorelatedCaseNumber: Número do casopublishPage: Seção do avisocaseId: 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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
iprPledgeCount: Quantidade de penhores de propriedade intelectualiprPledgeList: Lista de penhores de propriedade intelectualiprName: Nome da propriedade intelectualiprPledgePeriod: Prazo de registro do penhoriprPledgePublicDate: Data de divulgação da propriedade intelectualiprPledgeeName: Credor do penhor de propriedade intelectualiprRegisterNum: Número de registro da propriedade intelectualiprPledgorName: Devedor do penhor de propriedade intelectualiprType: Tipo de propriedade intelectualiprPledgeRevokeDate: Data de cancelamento da propriedade intelectualiprPledgeRevokeReason: Motivo do cancelamento da propriedade intelectualiprStatus: 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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
taxPenaltyCount: Quantidade de penalidades administrativas fiscaistaxPenaltyList: Lista de penalidades administrativas fiscaispenaltyDate: Data da penalidadepenaltyAmount: Valor da penalidadepenaltyReason: Motivo da penalidadepenaltyType: Tipo de penalidadepenaltyAuthority: Órgão de penalidadepenaltyDecisionNumber: Número do documento de decisão de penalidadelegalBasis: Base legalpenaltyStatus: 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 empresakeywordType(opcional): Enumeração do tipo de entidade
Valores de retorno:
anomalyCount: Quantidade de anomalias operacionaisanomalyList: Lista de anomalias operacionaisremoveAuthority: Órgão decisor de remoçãocreateDate: Data de inclusãoremoveDate: Data de remoçãocreateReason: Motivo da inclusão na lista de anomalias operacionaisremoveReason: Motivo da remoção da lista de anomalias operacionaiscreateAuthority: Ó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 empresapageIndex(opcional): Número da páginakeywordType(opcional): Enumeração do tipo de entidadepageSize(opcional): Tamanho da página
Valores de retorno:
total: TotalresultList: Lista de resultadosefCaseCreateTime: Data de registro do casoefCaseNumber: Número do casoefLimitedApplicant: RequerenteefExecutiveCourt: Tribunal de execuçãoefLimitedPersonCasePublishTime: Data de publicaçãoefLimitedPersonName: Pessoa com restrição de consumoefLimitedPersonProvince: 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 riscoriskScore: Pontuação de riscoriskLevel: Nível de risco
Cenários de uso
- Aprovação de empréstimos financeiros: Bancos ou instituições financeiras avaliam o risco de conformidade de empresas tomadoras de empréstimos
- Due diligence empresarial: Investidores ou parceiros obtêm o histórico de conformidade de empresas-alvo
- Verificação de antecedentes em contratações: Departamentos de RH verificam o histórico e a legalidade de empresas candidatas
- Conformidade regulatória: Órgãos reguladores governamentais realizam supervisão de conformidade e decisões de penalidades
- Gestão de risco comercial: Empresas realizam avaliação de risco antes de parcerias comerciais
- Due diligence jurídica: Escritórios de advocacia realizam avaliação de risco jurídico de empresas
Observações de uso
- 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
- Atualidade dos dados: As informações de risco são atualizadas constantemente; recomenda-se consultas periódicas para obter o status mais recente
- Avaliação abrangente: Recomenda-se combinar informações de risco de múltiplas dimensões para uma avaliação abrangente
- 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)
- Ajude-me a encontrar informações de empresas que contenham a palavra-chave "Tencent"
- Pesquise a lista de empresas relacionadas a "Alibaba"
- Consulte empresas cujo nome contenha "Douyin"
risk_insight_serious_violations (Consulta de registros de violações graves)
- Consulte os registros de violações graves da Tencent Technology Co., Ltd.
- Verifique se a Douyin possui violações graves
- 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)
- Consulte as informações de penhor de bens móveis da Tencent
- A Alibaba possui registros de penhor de bens móveis?
- Verifique a situação de penhor e garantia da Douyin
risk_insight_court_hearings (Consulta de avisos de audiências judiciais)
- Consulte as informações de avisos de audiências relacionadas à Tencent
- Quais avisos de audiências judiciais a Alibaba possui recentemente?
- Verifique as informações de audiências da Douyin
risk_insight_litigation_risk_profile (Consulta de perfil de risco de litígio)
- Analise a situação geral de risco de litígio da Tencent
- Como é o perfil de risco jurídico da Alibaba?
- Avaliação de risco judicial da Douyin
risk_insight_court_announcements (Consulta de avisos judiciais)
- Consulte as informações da Tencent em avisos judiciais
- Quais registros de avisos judiciais a Alibaba possui?
- Verifique a situação de avisos judiciais da Douyin
risk_insight_intellectual_property_pledge (Consulta de penhor de propriedade intelectual)
- Consulte a situação de penhor de propriedade intelectual da Tencent
- A Alibaba possui penhor de propriedade intelectual?
- Informações de penhor de propriedade intelectual da Douyin
risk_insight_tax_penalties (Consulta de penalidades administrativas fiscais)
- Consulte os registros de penalidades fiscais da Tencent
- A Alibaba possui penalidades por violações fiscais?
- Verifique a conformidade fiscal da Douyin
risk_insight_business_anomalies (Consulta de anomalias operacionais)
- Consulte se a Tencent foi incluída na lista de anomalias operacionais
- Como está a situação de anomalias operacionais da Alibaba?
- A Douyin possui registros de anomalias operacionais?
risk_insight_consumption_restrictions (Consulta de restrições de consumo elevado)
- Consulte se a Tencent e seus executivos possuem ordens de restrição de consumo
- Os executivos da Alibaba possuem registros de restrição de consumo elevado?
- Verifique a situação de restrição de consumo da Douyin
enterprise_risk_insight_score (Consulta de pontuação de risco empresarial)
- Consulte a pontuação de risco e o nível da Tencent Technology Co., Ltd.
- Analise a situação geral de pontuação de risco do Alibaba Group
- Qual é a pontuação de risco empresarial da Douyin?
- Avalie o nível de risco de admissão de uma empresa