企业风险分析洞察服务
Proporciona un análisis integral de riesgos empresariales, incluyendo registros de infracciones, información hipotecaria, anomalías comerciales y casos judiciales.
Documentación
企业风险分析洞察服务
Funciones principales
- 🔍 Búsqueda difusa por palabras clave de empresa
- ⚠️ Consulta de registros de infracciones graves
- 🏦 Consulta de información de hipotecas de bienes muebles
- 📋 Consulta de personas ejecutadas por incumplimiento
- 🚫 Consulta de la lista de anomalías operativas
- 💰 Consulta de información de sanciones administrativas
- ⚖️ Consulta de información de casos judiciales
Requisitos del entorno
- Python 3.10+
- Paquetes de dependencias: python-dotenv, requests, mcp
Inicio rápido local
1. Clonar el proyecto
git clone https://github.com/handaas/enterprise-risk-insight-mcp-server
cd enterprise-risk-insight-mcp-server
2. Crear entorno virtual e instalar dependencias
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt
3. Configuración del entorno
Copia la plantilla de variables de entorno y configúrala:
cp .env.example .env
Edita el archivo .env y configura las siguientes variables de entorno:
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
4. Iniciar el servicio streamable-http
python server/mcp_server.py streamable-http
El servicio se iniciará en http://localhost:8000.
Métodos de inicio compatibles: stdio, sse o streamable-http
5. Configuración MCP de Cursor / Cherry Studio
{
"mcpServers": {
"enterprise-risk-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
Instalación e implementación de la versión STDIO
Configurar la configuración MCP de 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"
}
}
}
}
Uso del servicio Remote oficial
1. Configurar directamente la configuración MCP de Cursor / Cherry Studio
{
"mcpServers": {
"handaas-ent-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/enterprise/risk_insight?token={token}"
}
}
}
Nota: integrator_id, secret_id, secret_key y token requieren iniciar sesión en https://www.handaas.com/ para registrarse y obtenerlos en la plataforma
Herramientas disponibles
1. risk_insight_fuzzy_search
Función: Búsqueda difusa por palabras clave de empresa
Busca de forma difusa la lista de empresas relacionadas según palabras clave proporcionadas como nombre de empresa, nombre de persona, marca, producto, puesto, etc.
Parámetros:
matchKeyword(obligatorio): Palabra clave de coincidenciapageIndex(opcional): Posición inicial de paginaciónpageSize(opcional): Posición final de paginación
Valores de retorno:
total: Total
2. risk_insight_serious_violations
Función: Consulta de registros de infracciones graves
Consulta los registros de infracciones graves de una empresa bajo supervisión gubernamental, incluidos los detalles de las infracciones graves y su estado de tramitación.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
illegalCount: Cantidad de infracciones gravesillegalInfoList: Lista de infracciones gravescreateAuthority: Órgano decisorio (inclusión)createDate: Fecha de inclusióncreateReason: Motivo de inclusiónremoveAuthority: Órgano decisorio (eliminación)removeDate: Fecha de eliminacióntype: CategoríaremoveReason: Motivo de eliminación
3. risk_insight_chattel_mortgage
Función: Consulta de información de hipotecas de bienes muebles
Consulta la información de hipotecas de bienes muebles de una empresa, proporcionando datos detallados sobre las hipotecas de bienes muebles, incluida la cantidad de hipotecas, información de listas, así como información sobre las partes relacionadas y los derechos de crédito.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
mortgageCount: Cantidad de hipotecas de bienes mueblesmortgageInfoList: Lista de hipotecas de bienes mueblesauthority: Órgano de registromortgageId: Número de registrodate: Fecha de registroamount: Monto del crédito garantizadopublicationDate: Fecha de publicaciónterm: Plazo de cumplimiento de la deuda por parte del deudortype: TipoguaranteedCreditorInfo: Información del bono principal garantizadomortgageeList: Información del acreedor hipotecariopawnList: Información del bien hipotecadorevokeInfo: Información de cancelación
4. risk_insight_court_hearings
Función: Consulta de anuncios de audiencias judiciales
Consulta la información de anuncios de audiencias relacionada con una empresa determinada, proporcionando detalles de las audiencias y los anuncios.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresapageIndex(opcional): Número de páginapageSize(opcional): Tamaño de paginaciónkeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
total: TotalresultList: Lista de resultadosaddress: Lugar de la audienciacaseReason: Motivo del casodate: Fecha de la audienciapublishPage: Sección del anunciopublishDate: Fecha del anunciopublishUnit: Tribunal de la audienciacaseType: Tipo de anunciorelatedCaseNumber: Número de casocaseId: ID del anuncio de audienciacaseRelatedPerson: Partes involucradas
5. risk_insight_litigation_risk_profile
Función: Consulta de perfil de riesgo de litigios
Consulta la situación de riesgo de litigios legales de una empresa, con resultados que incluyen anuncios judiciales, anuncios de registro de casos, anuncios de audiencias, documentos de sentencias, personas ejecutadas, personas ejecutadas por incumplimiento y restricciones de alto consumo, entre otros.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
caList: Lista de anuncios judicialescaTotal: Total de anuncios judicialescaLianTotal: Total de anuncios de registro de casoscaLianList: Lista de anuncios de registro de casoscaKaitingTotal: Total de anuncios de audienciascaKaitingList: Lista de anuncios de audienciasjdTotal: Total de documentos de sentenciasjdList: Lista de documentos de sentenciasenforcementList: Lista de personas ejecutadasedTotal: Total de personas ejecutadas por incumplimientoedList: Lista de personas ejecutadas por incumplimientoenforcementTotal: Total de personas ejecutadaslimitedTotal: Total de restricciones de alto consumolimitedList: Lista de restricciones de alto consumo
6. risk_insight_court_announcements
Función: Consulta de anuncios judiciales
Consulta la información relevante de una empresa específica en los anuncios judiciales, incluidos detalles como el lugar de la audiencia, las partes involucradas y el motivo del caso.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresapageIndex(opcional): Número de páginapageSize(opcional): Tamaño de paginaciónkeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
total: TotalresultList: Lista de resultadoscaseType: Tipo de anunciodate: Fecha de la audienciacaseRelatedPerson: Partes involucradasaddress: Lugar de la audienciapublishDate: Fecha del anunciopublishUnit: Tribunal de la audienciacaseReason: Motivo del casorelatedCaseNumber: Número de casopublishPage: Sección del anunciocaseId: ID del anuncio judicial
7. risk_insight_intellectual_property_pledge
Función: Consulta de prenda de propiedad intelectual
Recupera y devuelve la información de prenda de propiedad intelectual de una empresa, incluida la cantidad de prendas, listas relacionadas e información detallada.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
iprPledgeCount: Cantidad de prendas de propiedad intelectualiprPledgeList: Lista de prendas de propiedad intelectualiprName: Nombre de la propiedad intelectualiprPledgePeriod: Plazo de registro de la prendaiprPledgePublicDate: Fecha de publicación de la propiedad intelectualiprPledgeeName: Acreedor prendario de la propiedad intelectualiprRegisterNum: Número de registro de la propiedad intelectualiprPledgorName: Deudor prendario de la propiedad intelectualiprType: Tipo de propiedad intelectualiprPledgeRevokeDate: Fecha de cancelación de la propiedad intelectualiprPledgeRevokeReason: Motivo de cancelación de la propiedad intelectualiprStatus: Estado de la propiedad intelectual
8. risk_insight_penalties
Función: Consulta de sanciones administrativas
Consulta los registros de sanciones administrativas de una empresa, incluidos los detalles de las sanciones.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
taxPenaltyCount: Cantidad de sanciones administrativas fiscalestaxPenaltyList: Lista de sanciones administrativas fiscalespenaltyDate: Fecha de la sanciónpenaltyAmount: Monto de la sanciónpenaltyReason: Motivo de la sanciónpenaltyType: Tipo de sanciónpenaltyAuthority: Órgano sancionadorpenaltyDecisionNumber: Número de documento de decisión de sanciónlegalBasis: Base legalpenaltyStatus: Estado de la sanción
9. risk_insight_business_anomalies
Función: Consulta de anomalías operativas
Consulta la información de anomalías operativas de una empresa, incluida la cantidad de anomalías e información detallada de la lista.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresakeywordType(opcional): Enumeración de tipo de entidad
Valores de retorno:
anomalyCount: Cantidad de anomalías operativasanomalyList: Lista de anomalías operativasremoveAuthority: Órgano decisorio de exclusióncreateDate: Fecha de inclusiónremoveDate: Fecha de exclusióncreateReason: Motivo de inclusión en la lista de anomalías operativasremoveReason: Motivo de exclusión de la lista de anomalías operativascreateAuthority: Órgano decisorio de inclusión
10. risk_insight_consumption_restrictions
Función: Consulta de restricciones de alto consumo
Consulta si una empresa específica o sus responsables tienen registros judiciales de restricciones de alto consumo.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresapageIndex(opcional): Número de páginakeywordType(opcional): Enumeración de tipo de entidadpageSize(opcional): Tamaño de paginación
Valores de retorno:
total: TotalresultList: Lista de resultadosefCaseCreateTime: Fecha de registro del casoefCaseNumber: Número de casoefLimitedApplicant: SolicitanteefExecutiveCourt: Tribunal de ejecuciónefLimitedPersonCasePublishTime: Fecha de publicaciónefLimitedPersonName: Persona con restricción de consumoefLimitedPersonProvince: Provincia
11. enterprise_risk_insight_score
Función: Consulta de puntuación de riesgo empresarial
Consulta la puntuación de riesgo y el nivel de riesgo de una empresa mediante el nombre completo de la empresa, y enumera los detalles de la puntuación, para escenarios como la revisión de riesgo de incorporación de empresas. Si no se dispone del nombre completo de la empresa, primero se debe utilizar la herramienta de búsqueda difusa de empresas para obtenerlo.
Parámetros:
matchKeyword(obligatorio): Nombre de la empresa / número de registro / código de crédito social unificado / ID de empresa; si no se dispone del nombre completo de la empresa, primero se debe utilizar la herramienta de búsqueda difusa de empresas para obtenerlokeywordType(opcional): Enumeración de tipo de entidad (name: nombre de la empresa, nameId: ID de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado)
Valores de retorno:
riskReason: Lista de motivos de riesgoriskScore: Puntuación de riesgoriskLevel: Nivel de riesgo
Escenarios de uso
- Aprobación de préstamos financieros: Bancos o instituciones financieras evalúan el riesgo de cumplimiento de las empresas prestatarias
- Debida diligencia empresarial: Inversores o socios obtienen el historial de cumplimiento de la empresa objetivo
- Verificación de antecedentes en contratación: El departamento de recursos humanos examina los antecedentes y la legalidad de las empresas candidatas
- Cumplimiento normativo: Los organismos reguladores gubernamentales supervisan el cumplimiento empresarial y toman decisiones de sanción
- Gestión de riesgos comerciales: Las empresas realizan evaluaciones de riesgo antes de la cooperación comercial
- Debida diligencia legal: Los despachos de abogados realizan evaluaciones de riesgo legal empresarial
Consideraciones de uso
- Requisito de nombre completo de la empresa: Al llamar a interfaces que requieren el nombre completo de la empresa, si no se dispone de él, primero se debe llamar a la interfaz risk_insight_fuzzy_search para obtenerlo
- Actualidad de los datos: La información de riesgo se actualiza en cualquier momento; se recomienda consultar periódicamente para obtener el estado más reciente
- Evaluación integral: Se recomienda realizar una evaluación integral combinando información de riesgo de múltiples dimensiones
- Cumplimiento legal: Al utilizar información de riesgo, se deben cumplir las leyes y regulaciones pertinentes y los requisitos de protección de la privacidad
Ejemplos de preguntas de uso
risk_insight_fuzzy_search (Búsqueda difusa por palabras clave de empresa)
- Ayúdame a buscar información de empresas que contengan la palabra clave "腾讯"
- Busca la lista de empresas relacionadas con "阿里"
- Consulta las empresas cuyo nombre contenga "抖音"
risk_insight_serious_violations (Consulta de registros de infracciones graves)
- Consulta los registros de infracciones graves de 腾讯科技有限公司
- Verifica si 抖音 tiene infracciones graves
- ¿Qué registros de infracciones tiene 阿里巴巴集团?
risk_insight_chattel_mortgage (Consulta de información de hipotecas de bienes muebles)
- Consulta la información de hipotecas de bienes muebles de 腾讯
- ¿Tiene 阿里巴巴 registros de hipotecas de bienes muebles?
- Verifica la situación de garantía hipotecaria de 抖音
risk_insight_court_hearings (Consulta de anuncios de audiencias judiciales)
- Consulta la información de anuncios de audiencias relacionada con 腾讯
- ¿Qué anuncios de audiencias judiciales tiene 阿里巴巴 recientemente?
- Verifica la información de audiencias de 抖音
risk_insight_litigation_risk_profile (Consulta de perfil de riesgo de litigios)
- Analiza la situación general de riesgo de litigios de 腾讯
- ¿Cómo es el perfil de riesgo legal de 阿里巴巴?
- Evaluación del riesgo judicial de 抖音
risk_insight_court_announcements (Consulta de anuncios judiciales)
- Consulta la información de 腾讯 en los anuncios judiciales
- ¿Qué registros de anuncios judiciales tiene 阿里巴巴?
- Verifica la situación de anuncios judiciales de 抖音
risk_insight_intellectual_property_pledge (Consulta de prenda de propiedad intelectual)
- Consulta la situación de prenda de propiedad intelectual de 腾讯
- ¿Tiene 阿里巴巴 prendas de propiedad intelectual?
- Información de prenda de propiedad intelectual de 抖音
risk_insight_tax_penalties (Consulta de sanciones administrativas fiscales)
- Consulta los registros de sanciones fiscales de 腾讯
- ¿Tiene 阿里巴巴 sanciones por infracciones fiscales?
- Verifica la situación de cumplimiento fiscal de 抖音
risk_insight_business_anomalies (Consulta de anomalías operativas)
- Consulta si 腾讯 ha sido incluido en la lista de anomalías operativas
- ¿Cómo es la situación de anomalías operativas de 阿里巴巴?
- ¿Tiene 抖音 registros de anomalías operativas?
risk_insight_consumption_restrictions (Consulta de restricciones de alto consumo)
- Consulta si 腾讯 y sus ejecutivos tienen órdenes de restricción de consumo
- ¿Tienen los ejecutivos de 阿里巴巴 registros de restricciones de alto consumo?
- Verifica la situación de restricción de consumo de 抖音
enterprise_risk_insight_score (Consulta de puntuación de riesgo empresarial)
- Consulta la puntuación y el nivel de riesgo de 腾讯科技有限公司
- Analiza la situación general de puntuación de riesgo de 阿里巴巴集团
- ¿Cuál es la puntuación de riesgo empresarial de 抖音?
- Evalúa el nivel de riesgo de incorporación de una empresa