企业风险分析洞察服务

Proporciona un análisis integral de riesgos empresariales, incluyendo registros de infracciones, información hipotecaria, anomalías comerciales y casos judiciales.

Documentación

企业风险分析洞察服务

Este servicio MCP ofrece funciones integrales de análisis de riesgo empresarial, incluyendo consultas de registros de infracciones graves, información de hipotecas de bienes muebles, personas ejecutadas por incumplimiento, anomalías operativas, sanciones administrativas y otra información de riesgo, ayudando a los usuarios a realizar evaluaciones de riesgo de cumplimiento empresarial.

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 coincidencia
  • pageIndex (opcional): Posición inicial de paginación
  • pageSize (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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • illegalCount: Cantidad de infracciones graves
  • illegalInfoList: Lista de infracciones graves
    • createAuthority: Órgano decisorio (inclusión)
    • createDate: Fecha de inclusión
    • createReason: Motivo de inclusión
    • removeAuthority: Órgano decisorio (eliminación)
    • removeDate: Fecha de eliminación
    • type: Categoría
    • removeReason: 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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • mortgageCount: Cantidad de hipotecas de bienes muebles
  • mortgageInfoList: Lista de hipotecas de bienes muebles
    • authority: Órgano de registro
    • mortgageId: Número de registro
    • date: Fecha de registro
    • amount: Monto del crédito garantizado
    • publicationDate: Fecha de publicación
    • term: Plazo de cumplimiento de la deuda por parte del deudor
    • type: Tipo
    • guaranteedCreditorInfo: Información del bono principal garantizado
    • mortgageeList: Información del acreedor hipotecario
    • pawnList: Información del bien hipotecado
    • revokeInfo: 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 empresa
  • pageIndex (opcional): Número de página
  • pageSize (opcional): Tamaño de paginación
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • address: Lugar de la audiencia
    • caseReason: Motivo del caso
    • date: Fecha de la audiencia
    • publishPage: Sección del anuncio
    • publishDate: Fecha del anuncio
    • publishUnit: Tribunal de la audiencia
    • caseType: Tipo de anuncio
    • relatedCaseNumber: Número de caso
    • caseId: ID del anuncio de audiencia
    • caseRelatedPerson: 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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • caList: Lista de anuncios judiciales
  • caTotal: Total de anuncios judiciales
  • caLianTotal: Total de anuncios de registro de casos
  • caLianList: Lista de anuncios de registro de casos
  • caKaitingTotal: Total de anuncios de audiencias
  • caKaitingList: Lista de anuncios de audiencias
  • jdTotal: Total de documentos de sentencias
  • jdList: Lista de documentos de sentencias
  • enforcementList: Lista de personas ejecutadas
  • edTotal: Total de personas ejecutadas por incumplimiento
  • edList: Lista de personas ejecutadas por incumplimiento
  • enforcementTotal: Total de personas ejecutadas
  • limitedTotal: Total de restricciones de alto consumo
  • limitedList: 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 empresa
  • pageIndex (opcional): Número de página
  • pageSize (opcional): Tamaño de paginación
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • caseType: Tipo de anuncio
    • date: Fecha de la audiencia
    • caseRelatedPerson: Partes involucradas
    • address: Lugar de la audiencia
    • publishDate: Fecha del anuncio
    • publishUnit: Tribunal de la audiencia
    • caseReason: Motivo del caso
    • relatedCaseNumber: Número de caso
    • publishPage: Sección del anuncio
    • caseId: 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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • iprPledgeCount: Cantidad de prendas de propiedad intelectual
  • iprPledgeList: Lista de prendas de propiedad intelectual
    • iprName: Nombre de la propiedad intelectual
    • iprPledgePeriod: Plazo de registro de la prenda
    • iprPledgePublicDate: Fecha de publicación de la propiedad intelectual
    • iprPledgeeName: Acreedor prendario de la propiedad intelectual
    • iprRegisterNum: Número de registro de la propiedad intelectual
    • iprPledgorName: Deudor prendario de la propiedad intelectual
    • iprType: Tipo de propiedad intelectual
    • iprPledgeRevokeDate: Fecha de cancelación de la propiedad intelectual
    • iprPledgeRevokeReason: Motivo de cancelación de la propiedad intelectual
    • iprStatus: 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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • taxPenaltyCount: Cantidad de sanciones administrativas fiscales
  • taxPenaltyList: Lista de sanciones administrativas fiscales
    • penaltyDate: Fecha de la sanción
    • penaltyAmount: Monto de la sanción
    • penaltyReason: Motivo de la sanción
    • penaltyType: Tipo de sanción
    • penaltyAuthority: Órgano sancionador
    • penaltyDecisionNumber: Número de documento de decisión de sanción
    • legalBasis: Base legal
    • penaltyStatus: 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 empresa
  • keywordType (opcional): Enumeración de tipo de entidad

Valores de retorno:

  • anomalyCount: Cantidad de anomalías operativas
  • anomalyList: Lista de anomalías operativas
    • removeAuthority: Órgano decisorio de exclusión
    • createDate: Fecha de inclusión
    • removeDate: Fecha de exclusión
    • createReason: Motivo de inclusión en la lista de anomalías operativas
    • removeReason: Motivo de exclusión de la lista de anomalías operativas
    • createAuthority: Ó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 empresa
  • pageIndex (opcional): Número de página
  • keywordType (opcional): Enumeración de tipo de entidad
  • pageSize (opcional): Tamaño de paginación

Valores de retorno:

  • total: Total
  • resultList: Lista de resultados
    • efCaseCreateTime: Fecha de registro del caso
    • efCaseNumber: Número de caso
    • efLimitedApplicant: Solicitante
    • efExecutiveCourt: Tribunal de ejecución
    • efLimitedPersonCasePublishTime: Fecha de publicación
    • efLimitedPersonName: Persona con restricción de consumo
    • efLimitedPersonProvince: 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 obtenerlo
  • keywordType (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 riesgo
  • riskScore: Puntuación de riesgo
  • riskLevel: Nivel de riesgo

Escenarios de uso

  1. Aprobación de préstamos financieros: Bancos o instituciones financieras evalúan el riesgo de cumplimiento de las empresas prestatarias
  2. Debida diligencia empresarial: Inversores o socios obtienen el historial de cumplimiento de la empresa objetivo
  3. Verificación de antecedentes en contratación: El departamento de recursos humanos examina los antecedentes y la legalidad de las empresas candidatas
  4. Cumplimiento normativo: Los organismos reguladores gubernamentales supervisan el cumplimiento empresarial y toman decisiones de sanción
  5. Gestión de riesgos comerciales: Las empresas realizan evaluaciones de riesgo antes de la cooperación comercial
  6. Debida diligencia legal: Los despachos de abogados realizan evaluaciones de riesgo legal empresarial

Consideraciones de uso

  1. 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
  2. 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
  3. Evaluación integral: Se recomienda realizar una evaluación integral combinando información de riesgo de múltiples dimensiones
  4. 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)

  1. Ayúdame a buscar información de empresas que contengan la palabra clave "腾讯"
  2. Busca la lista de empresas relacionadas con "阿里"
  3. Consulta las empresas cuyo nombre contenga "抖音"

risk_insight_serious_violations (Consulta de registros de infracciones graves)

  1. Consulta los registros de infracciones graves de 腾讯科技有限公司
  2. Verifica si 抖音 tiene infracciones graves
  3. ¿Qué registros de infracciones tiene 阿里巴巴集团?

risk_insight_chattel_mortgage (Consulta de información de hipotecas de bienes muebles)

  1. Consulta la información de hipotecas de bienes muebles de 腾讯
  2. ¿Tiene 阿里巴巴 registros de hipotecas de bienes muebles?
  3. Verifica la situación de garantía hipotecaria de 抖音

risk_insight_court_hearings (Consulta de anuncios de audiencias judiciales)

  1. Consulta la información de anuncios de audiencias relacionada con 腾讯
  2. ¿Qué anuncios de audiencias judiciales tiene 阿里巴巴 recientemente?
  3. Verifica la información de audiencias de 抖音

risk_insight_litigation_risk_profile (Consulta de perfil de riesgo de litigios)

  1. Analiza la situación general de riesgo de litigios de 腾讯
  2. ¿Cómo es el perfil de riesgo legal de 阿里巴巴?
  3. Evaluación del riesgo judicial de 抖音

risk_insight_court_announcements (Consulta de anuncios judiciales)

  1. Consulta la información de 腾讯 en los anuncios judiciales
  2. ¿Qué registros de anuncios judiciales tiene 阿里巴巴?
  3. Verifica la situación de anuncios judiciales de 抖音

risk_insight_intellectual_property_pledge (Consulta de prenda de propiedad intelectual)

  1. Consulta la situación de prenda de propiedad intelectual de 腾讯
  2. ¿Tiene 阿里巴巴 prendas de propiedad intelectual?
  3. Información de prenda de propiedad intelectual de 抖音

risk_insight_tax_penalties (Consulta de sanciones administrativas fiscales)

  1. Consulta los registros de sanciones fiscales de 腾讯
  2. ¿Tiene 阿里巴巴 sanciones por infracciones fiscales?
  3. Verifica la situación de cumplimiento fiscal de 抖音

risk_insight_business_anomalies (Consulta de anomalías operativas)

  1. Consulta si 腾讯 ha sido incluido en la lista de anomalías operativas
  2. ¿Cómo es la situación de anomalías operativas de 阿里巴巴?
  3. ¿Tiene 抖音 registros de anomalías operativas?

risk_insight_consumption_restrictions (Consulta de restricciones de alto consumo)

  1. Consulta si 腾讯 y sus ejecutivos tienen órdenes de restricción de consumo
  2. ¿Tienen los ejecutivos de 阿里巴巴 registros de restricciones de alto consumo?
  3. Verifica la situación de restricción de consumo de 抖音

enterprise_risk_insight_score (Consulta de puntuación de riesgo empresarial)

  1. Consulta la puntuación y el nivel de riesgo de 腾讯科技有限公司
  2. Analiza la situación general de puntuación de riesgo de 阿里巴巴集团
  3. ¿Cuál es la puntuación de riesgo empresarial de 抖音?
  4. Evalúa el nivel de riesgo de incorporación de una empresa