faxin-mcp (Conector MCP de Faxin · Edición pública)

Envuelve Faxin (la plataforma de búsqueda jurídica del grupo editorial de leyes) en un servicio MCP (Model Context Protocol), de modo que cualquier cliente de IA compatible con MCP (Claude Desktop, Cherry Studio, diversos coding agents, etc.) pueda buscar directamente leyes y regulaciones chinas, reglas de adjudicación, conceptos del esquema de Faxin, casos similares (base de casos autoritativa), etc.

Cómo funciona: El inicio de sesión lo realizas tú mismo en el navegador que se abre, usando tu propia cuenta oficial de Faxin; todas las búsquedas y lecturas de detalles posteriores son llamadas HTTP puras con la cookie de esa sesión (el navegador solo sirve como contenedor de cookies, no renderiza páginas). Cada búsqueda tarda aproximadamente 2-8 segundos.

Funciones (9 herramientas)

Related MCP server: LexLink

Instalación

# 1. 克隆本仓库
git clone <repo-url>
cd faxin-mcp-public

# 2. 建虚拟环境并装依赖
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

# 3. 安装 Playwright 浏览器
.venv/bin/playwright install chromium

Primer inicio de sesión

.venv/bin/python login.py

• Se abre una ventana del navegador → ve al sitio oficial de Faxin → haz clic en «Iniciar sesión» → completa el inicio de sesión con tu propia cuenta de Faxin (usuario/contraseña, código SMS o escaneo de código QR, según los métodos que ofrezca el sitio oficial);

• Una vez confirmes que la página muestra el estado de sesión iniciada, vuelve a la terminal y presiona Enter para guardar la sesión;

• El script verificará automáticamente una vez la reutilización sin interfaz. A partir de entonces no necesitarás volver a iniciar sesión durante el uso normal; si la sesión caduca (la herramienta te lo indicará), simplemente vuelve a ejecutar el script.

Este script no lee, registra ni sube tu usuario y contraseña — todas las credenciales pasan únicamente por la página oficial de Faxin.

Configuración del cliente MCP

Con Claude Desktop (claude_desktop_config.json) como ejemplo:

{
  "mcpServers": {
    "faxin": {
      "type": "stdio",
      "command": "/你的路径/faxin-mcp-public/.venv/bin/python",
      "args": ["/你的路径/faxin-mcp-public/server.py"]
    }
  }
}

Para otros clientes MCP (Cherry Studio, etc.) el procedimiento es el mismo: indica la ruta del intérprete de Python + la ruta de server.py.

Variables de entorno opcionales

Sugerencias de uso (estrategia de palabras clave)

• Para buscar, prioriza términos de causa (como «disputa por contrato de compraventa» o «disputa por préstamo entre particulares») o redacciones literales de disposiciones (como «el que roba bienes públicos o privados»); los conceptos jurídicos abstractos tienen menor tasa de acierto;

• Para localizar disposiciones: si conoces el nombre de la ley + número de artículo, usa directamente faxin_get_tiao (es lo más rápido); si solo conoces el tema, usa faxin_search_law;

• Si no sabes qué término usar, empieza con faxin_search_outline para descubrir conceptos y luego profundiza en la biblioteca correspondiente según los recuentos agregados del concepto;

• La base de reglas de adjudicación es extensa; una sola búsqueda puede tardar entre 7 y 17 segundos, lo cual es normal; úsala con moderación y evita llamadas consecutivas a alta frecuencia (la plataforma puede imponer límites temporales; suele recuperarse en unos 60 segundos).

Compatibilidad verificada con el sitio principal (2026-08-22, pruebas duales en www.faxin.cn: anónimo + con sesión)

Accesible de forma anónima (sin necesidad de iniciar sesión):

Verificado tras iniciar sesión (con cuenta personal de Faxin):

Conclusión: Las rutas de las interfaces del sitio principal son equivalentes a las de la edición VIP para colegios de abogados. La búsqueda de leyes, el acceso directo a disposiciones, los conceptos del esquema y la lectura de detalles funcionan tras iniciar sesión; la base de reglas de adjudicación está limitada por los permisos de la cuenta (no es un problema del conector); la búsqueda de casos similares aún no es compatible debido a la diferencia en el mecanismo de token del sitio principal (la edición para colegios de abogados sí funciona).

⚠️ Declaración de cumplimiento (lectura obligatoria antes de usar)

Este proyecto es únicamente una capa de adaptación del protocolo MCP, con el siguiente alcance y límites:

1. No elude ningún mecanismo de autenticación. El inicio de sesión debe realizarlo el propio usuario en el navegador que se abre, con su propia cuenta de Faxin. Este proyecto no contiene ningún código de descifrado, simulación de inicio de sesión, reconocimiento de captchas ni análisis de algoritmos de cifrado.

2. No evade ninguna medida de detección o anti-rastreo. Este proyecto no utiliza ningún parámetro de inicio ni inyección de scripts para ocultar la automatización.

3. No accede más allá de los permisos. Solo accede al contenido permitido por los permisos de la cuenta del usuario. Algunas bibliotecas (como la de reglas de adjudicación o la de casos similares) pueden requerir una cuenta de pago de Faxin para acceso completo — ajústate siempre a los permisos reales de tu propia cuenta.

4. No realiza rastreo masivo ni construye bases de datos locales. Solo ofrece búsquedas puntuales bajo demanda; úsalo con moderación y respeta el acuerdo de usuario y las reglas robots de la plataforma Faxin.

5. Los derechos de autor del contenido intermediado por este proyecto pertenecen a la plataforma original. Los resultados de búsqueda son exclusivamente para investigación y estudio personal; no pueden utilizarse para reventa comercial.

Aviso legal

• Este proyecto es una herramienta de código abierto de carácter personal y educativo; no tiene ninguna afiliación ni autorización con la plataforma Faxin;

• La estructura de páginas y las interfaces de la plataforma Faxin pueden cambiar en cualquier momento; este proyecto no garantiza disponibilidad a largo plazo;

• El usuario es responsable de asegurarse de que su uso cumple con el acuerdo de usuario de la plataforma Faxin y las leyes y regulaciones aplicables; todas las consecuencias derivadas del uso de este proyecto son responsabilidad exclusiva del usuario;

• Los resultados de búsqueda son solo de referencia y no constituyen asesoramiento legal; para citar formalmente disposiciones legales, consulte siempre el texto oficial publicado.

• Cualquier persona que modifique este código (por ejemplo, desarrollo secundario tras un fork) y lo publique o utilice, asume todos los riesgos legales derivados de sus modificaciones y de su uso; el autor original no tiene ninguna responsabilidad al respecto.

• Este proyecto no incluye ninguna función de rastreo masivo, anti-detección ni descifrado. Si la plataforma Faxin actualiza su acuerdo de usuario y prohíbe expresamente el uso de herramientas automatizadas para acceder a sus interfaces, el usuario debe dejar de usar este proyecto por su cuenta; el autor original no asume ninguna responsabilidad por ello.

Licencia

Licencia MIT (ver LICENSE). Los derechos de autor del contenido de la plataforma Faxin no se ven alterados por la licencia MIT de este proyecto.