Communitygithub.com

smallke/cn-funds-mcp

Asistente de datos de fondos y acciones de China (API gratuita, sin necesidad de clave API). Consulta valoración, NAV, tenencias, información del gestor, cotizaciones de acciones/índices, flujo de capital del mercado, ranking sectorial, capital del norte y gestiona la cartera de fondos del usuario con cálculo de ganancias mediante herramientas cn-funds-mcp.

¿Qué es cn-funds-mcp?

Este skill proporciona un asistente completo para consultar datos de fondos y acciones de China, utilizando la API gratuita de cn-funds-mcp sin necesidad de clave API. Incluye herramientas para buscar fondos, obtener valoraciones en tiempo real, consultar tenencias e información de gestores, así como cotizaciones de acciones e índices. También permite analizar el flujo de capital del mercado, rankings sectoriales y capital del norte (northbound). Además, el usuario puede gestionar su cartera de fondos guardando, actualizando o eliminando registros, y calcular ganancias diarias y totales. El skill soporta recordatorios programados que se activan automáticamente durante la conversación, ofreciendo informes de ganancias, resúmenes del mercado o mensajes personalizados. Está diseñado para ser usado en asistentes de IA como Claude Code, Cursor, Codex y otras plataformas que soporten herramientas MCP. Su funcionalidad es ideal para inversores chinos que desean monitorear sus inversiones de manera eficiente y recibir recomendaciones automatizadas basadas en datos en tiempo real.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Guía de uso de cn-funds-mcp

Consulta rápida de herramientas

Consulta de fondos

HerramientaPropósitoParámetros clave
search_fundBuscar fondos (nombre/código/pinyin)keyword
get_fund_estimateValoración en tiempo real (valor estimado intradiario y cambio porcentual)fundCode
get_fund_batch_infoObtener NAV de múltiples fondos en lotefundCodes (separados por comas)
get_fund_infoDetalles del fondo (tipo/compañía/gestor/tamaño/ranking)fundCode
get_fund_valuation_detailTendencia de valoración del día (intradiaria por hora)fundCode
get_fund_net_value_historyHistorial de NAVfundCode, range
get_fund_accumulated_performanceRendimiento acumulado vs CSI 300 vs paresfundCode, range
get_fund_positionDetalle de tenencias de accionesfundCode
get_fund_manager_listLista de gestores anterioresfundCode
get_fund_manager_detailPerfil del gestor actualfundCode

Acciones/Índices

HerramientaPropósitoParámetros clave
get_stock_trendTendencia intradiaria por horasecid (ej. 1.600519)
get_stock_quoteCotización en tiempo realsecids (separados por comas)

Mercado/Capital

HerramientaPropósitoParámetros clave
get_market_overviewResumen del mercado A (Shanghái/Shenzhen)Ninguno
get_market_capital_flowFlujo de capital del mercado (grandes/pequeños)Ninguno
get_sector_capital_flowRanking de capital por sectortimeType, code
get_northbound_capitalFlujo de capital Shanghai-Shenzhen-Hong KongNinguno

Gestión de cartera

HerramientaPropósitoParámetros clave
save_portfolioGuardar/actualizar registro de tenenciafundCode, shares, costPrice
remove_portfolioEliminar registro de tenenciafundCode
get_portfolioVer lista de tenenciasNinguno
get_portfolio_profitConsultar ganancias del día y totales de un solo golpeNinguno

Recordatorios programados

HerramientaPropósitoParámetros clave
set_reminderConfigurar recordatorio programado (se activa cada día de negociación)time(HH:MM), type, message
get_remindersVer todos los recordatorios configuradosNinguno
remove_reminderEliminar un recordatorioid
check_remindersVerificar si hay recordatorios vencidosNinguno

Tipo de recordatorio type:

  • profit_report — Informe de ganancias de la cartera (al activarse, consulta get_portfolio_profit y da sugerencias de aumentar/reducir posiciones)
  • market_report — Informe del mercado (al activarse, consulta resumen del mercado + flujo de capital)
  • custom — Recordatorio personalizado (acompañado del parámetro message)

Explicación de parámetros comunes

Código del fondo fundCode: Número de 6 dígitos, ej. 161725 (Zhaoshang Baijiu), 110011 (Yifangda Small Cap)

ID de valor secid: Formato mercado.código

Código de mercadoSignificadoEjemplo
1.Bolsa de Shanghái1.000001 (Índice Shanghái), 1.600519 (Kweichow Moutai)
0.Bolsa de Shenzhen0.399001 (Índice Shenzhen Component), 0.000858 (Wuliangye)
116.Bolsa de Hong Kong116.01810 (Grupo Xiaomi)

Rango de tiempo range: m=1 mes, q=3 meses, hy=6 meses, y=1 año, 2y=2 años, 3y=3 años, 5y=5 años

Comportamiento activo (Importante)

Al inicio de cada conversación, debe llamar a check_reminders primero

Independientemente de lo que diga el usuario, antes de responder, llame a check_reminders para verificar si hay recordatorios vencidos. Si los hay, ejecute las siguientes reglas:

  1. Cuando profit_report vence:

    • Llame a get_portfolio_profit para obtener datos de ganancias
    • Llame a get_market_overview para obtener el contexto del mercado
    • Informe al usuario, en tono amigable, el resumen de ganancias de la cartera del día
    • Dé sugerencias de operación para cada fondo:
      • Caída hoy > 2%: Sugerir "considere aumentar posición para reducir costo promedio"
      • Subida hoy > 3%: Sugerir "subida considerable, considere tomar ganancias parciales"
      • Pérdida total de cartera > 10%: Sugerir "pérdida significativa, evalúe si mantener"
      • Ganancia total de cartera > 20%: Sugerir "ganancia considerable, considere tomar ganancias en lotes para asegurar"
    • Finalmente, pregunte si el usuario desea ajustar la cartera
  2. Cuando market_report vence:

    • Llame a get_market_overview + get_market_capital_flow + get_northbound_capital
    • Informe sobre índices del mercado, flujo de capital y dinámica del capital del norte
  3. Cuando custom vence:

    • Muestre al usuario el contenido del recordatorio personalizado

Si no hay recordatorios vencidos, procese la solicitud del usuario normalmente.

Escenarios típicos

El usuario no conoce el código del fondo

Primero use search_fund para buscar y luego use el code devuelto para llamar a otras herramientas.

El usuario pregunta "¿Cómo está el mercado hoy?"

Llame secuencialmente a get_market_overview + get_market_capital_flow, e informe de manera integral sobre los puntos del mercado, cambios, volumen de negociación y flujo de capital.

El usuario pregunta "¿Cuánto gané hoy?"

Llame directamente a get_portfolio_profit, devuelve las ganancias del día de cada fondo y un resumen. Si no hay registros de cartera, guíe al usuario para usar save_portfolio y agregarlos.

El usuario proporciona información de cartera

Analice el código del fondo, las acciones y el precio de costo, luego guarde uno por uno con save_portfolio. El parámetro de nombre se puede omitir; la herramienta lo consultará y completará automáticamente.

El usuario quiere importar cartera rápidamente (reconocimiento de captura de pantalla)

Si el modelo actual admite reconocimiento de imágenes (OCR), indique activamente al usuario: puede cargar directamente capturas de pantalla de la aplicación de fondos (como Tiantian Fund, Alipay, Ant Fortune, etc.), la IA reconocerá automáticamente los códigos de fondos, nombres, acciones en tenencia, NAV de costos, etc., y luego llamará a save_portfolio para importar la cartera en lote, sin necesidad de ingresar manualmente uno por uno.

Proceso de manejo:

  1. Reconocer la información de cada fondo en la captura (código, acciones, precio de costo)
  2. Para campos incompletos (como solo nombre sin código), use search_fund para completar el código del fondo
  3. Llame a save_portfolio para guardar cada fondo
  4. Después de guardar, muestre un resumen de la lista de cartera importada y pida al usuario que confirme si hay omisiones o errores

El usuario pide un análisis completo de un fondo

Combine llamadas: get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance, analizando desde perspectivas fundamental, de valoración, tenencias y rendimiento histórico.

El usuario dice "Ayúdame a configurar un recordatorio de ganancias por la tarde"

Llame a set_reminder con parámetros time="14:30", type="profit_report". A partir de entonces, en la primera conversación después de las 14:30 de cada día de negociación, se activará automáticamente el informe de ganancias y las sugerencias de operación.

Ejemplo de informe después de activar recordatorio

¡Buenas tardes! Son las 14:30, le informo sobre las ganancias de su cartera hoy:

Resumen de cartera: 3 fondos, costo total 15,000.00 yuanes, valor actual de mercado 14,520.00 yuanes Ganancias de hoy: -180.00 yuanes | Ganancias totales de cartera: -480.00 yuanes (-3.20%)

Detalle por fondo:

  • Zhaoshang Baijiu A (161725): Hoy -1.22%, pérdida de cartera -11.07%, sugiero evaluar si mantener
  • Yifangda Blue Chip (005827): Hoy +0.35%, ganancia de cartera +5.20%, mantener
  • Guangfa Nasdaq (270042): Hoy +1.80%, ganancia de cartera +15.30%, buena tendencia

¿Necesita ajustar la cartera?

Notas importantes

  • Los datos de valoración solo se actualizan durante el horario de negociación del mercado A (9:30-15:00); fuera de este horario, se devuelven los datos de cierre
  • get_fund_estimate devuelve un valor estimado, no el NAV final, advierta al usuario
  • Los datos de cartera se persisten en data/portfolio.json y se conservan entre sesiones
  • Cálculo de ganancias: Ganancia del día = Acciones × (Valoración - NAV de ayer), Ganancia de cartera = Acciones × (Valoración - Precio de costo)

Autor

smallke | [email protected]

Skills relacionados