Guía de uso de cn-funds-mcp
Consulta rápida de herramientas
Consulta de fondos
| Herramienta | Propósito | Parámetros clave |
|---|---|---|
search_fund | Buscar fondos (nombre/código/pinyin) | keyword |
get_fund_estimate | Valoración en tiempo real (valor estimado intradiario y cambio porcentual) | fundCode |
get_fund_batch_info | Obtener NAV de múltiples fondos en lote | fundCodes (separados por comas) |
get_fund_info | Detalles del fondo (tipo/compañía/gestor/tamaño/ranking) | fundCode |
get_fund_valuation_detail | Tendencia de valoración del día (intradiaria por hora) | fundCode |
get_fund_net_value_history | Historial de NAV | fundCode, range |
get_fund_accumulated_performance | Rendimiento acumulado vs CSI 300 vs pares | fundCode, range |
get_fund_position | Detalle de tenencias de acciones | fundCode |
get_fund_manager_list | Lista de gestores anteriores | fundCode |
get_fund_manager_detail | Perfil del gestor actual | fundCode |
Acciones/Índices
| Herramienta | Propósito | Parámetros clave |
|---|---|---|
get_stock_trend | Tendencia intradiaria por hora | secid (ej. 1.600519) |
get_stock_quote | Cotización en tiempo real | secids (separados por comas) |
Mercado/Capital
| Herramienta | Propósito | Parámetros clave |
|---|---|---|
get_market_overview | Resumen del mercado A (Shanghái/Shenzhen) | Ninguno |
get_market_capital_flow | Flujo de capital del mercado (grandes/pequeños) | Ninguno |
get_sector_capital_flow | Ranking de capital por sector | timeType, code |
get_northbound_capital | Flujo de capital Shanghai-Shenzhen-Hong Kong | Ninguno |
Gestión de cartera
| Herramienta | Propósito | Parámetros clave |
|---|---|---|
save_portfolio | Guardar/actualizar registro de tenencia | fundCode, shares, costPrice |
remove_portfolio | Eliminar registro de tenencia | fundCode |
get_portfolio | Ver lista de tenencias | Ninguno |
get_portfolio_profit | Consultar ganancias del día y totales de un solo golpe | Ninguno |
Recordatorios programados
| Herramienta | Propósito | Parámetros clave |
|---|---|---|
set_reminder | Configurar recordatorio programado (se activa cada día de negociación) | time(HH:MM), type, message |
get_reminders | Ver todos los recordatorios configurados | Ninguno |
remove_reminder | Eliminar un recordatorio | id |
check_reminders | Verificar si hay recordatorios vencidos | Ninguno |
Tipo de recordatorio type:
profit_report— Informe de ganancias de la cartera (al activarse, consultaget_portfolio_profity 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ámetromessage)
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 mercado | Significado | Ejemplo |
|---|---|---|
1. | Bolsa de Shanghái | 1.000001 (Índice Shanghái), 1.600519 (Kweichow Moutai) |
0. | Bolsa de Shenzhen | 0.399001 (Índice Shenzhen Component), 0.000858 (Wuliangye) |
116. | Bolsa de Hong Kong | 116.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:
-
Cuando
profit_reportvence:- Llame a
get_portfolio_profitpara obtener datos de ganancias - Llame a
get_market_overviewpara 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
- Llame a
-
Cuando
market_reportvence:- 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
- Llame a
-
Cuando
customvence:- 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:
- Reconocer la información de cada fondo en la captura (código, acciones, precio de costo)
- Para campos incompletos (como solo nombre sin código), use
search_fundpara completar el código del fondo - Llame a
save_portfoliopara guardar cada fondo - 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_estimatedevuelve un valor estimado, no el NAV final, advierta al usuario- Los datos de cartera se persisten en
data/portfolio.jsony 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)