Guia de Uso do cn-funds-mcp
Consulta Rápida de Ferramentas
Consulta de Fundos
| Ferramenta | Propósito | Parâmetros Chave |
|---|---|---|
search_fund | Pesquisar fundo (nome/código/pinyin) | keyword |
get_fund_estimate | Valor estimado em tempo real (NAV estimado e variação durante o pregão) | fundCode |
get_fund_batch_info | Obter NAV de múltiplos fundos em lote | fundCodes (separados por vírgula) |
get_fund_info | Detalhes do fundo (tipo/gestora/gestor/tamanho/ranking) | fundCode |
get_fund_valuation_detail | Tendência de valor estimado do dia (intradiário) | fundCode |
get_fund_net_value_history | Histórico de NAV | fundCode, range |
get_fund_accumulated_performance | Retorno acumulado vs CSI 300 vs categoria | fundCode, range |
get_fund_position | Detalhes das participações em ações | fundCode |
get_fund_manager_list | Lista de gestores anteriores | fundCode |
get_fund_manager_detail | Perfil do gestor atual | fundCode |
Ações/Índices
| Ferramenta | Propósito | Parâmetros Chave |
|---|---|---|
get_stock_trend | Tendência intradiária | secid (ex.: 1.600519) |
get_stock_quote | Cotação em tempo real | secids (separados por vírgula) |
Mercado/Capital
| Ferramenta | Propósito | Parâmetros Chave |
|---|---|---|
get_market_overview | Visão geral do mercado A (Shanghai/Shenzhen) | Nenhum |
get_market_capital_flow | Fluxo de capital do mercado (grandes/p equenos players) | Nenhum |
get_sector_capital_flow | Ranking de capital setorial | timeType, code |
get_northbound_capital | Fluxo de capital Norte (Shanghai-Hong Kong/Shenzhen-Hong Kong) | Nenhum |
Gerenciamento de Carteira
| Ferramenta | Propósito | Parâmetros Chave |
|---|---|---|
save_portfolio | Salvar/atualizar registro de participação | fundCode, shares, costPrice |
remove_portfolio | Remover registro de participação | fundCode |
get_portfolio | Visualizar lista de participações | Nenhum |
get_portfolio_profit | Consultar lucro do dia e total com um clique | Nenhum |
Lembretes Agendados
| Ferramenta | Propósito | Parâmetros Chave |
|---|---|---|
set_reminder | Configurar lembrete agendado (dispara em dias úteis) | time(HH:MM), type, message |
get_reminders | Visualizar todos os lembretes configurados | Nenhum |
remove_reminder | Remover um lembrete | id |
check_reminders | Verificar se há lembretes vencidos | Nenhum |
Tipos de lembrete type:
profit_report— Relatório de lucros da carteira (após disparo, consultaget_portfolio_profite oferece sugestões de aumento/redução)market_report— Relatório de mercado (após disparo, consulta visão geral + fluxo de capital)custom— Lembrete personalizado (com parâmetromessage)
Descrição de Parâmetros Comuns
Código do fundo fundCode: 6 dígitos, ex.: 161725 (Zhaoshang Baijiu), 110011 (Yifangda Small Cap)
ID de título secid: Formato mercado.código
| Código de Mercado | Significado | Exemplo |
|---|---|---|
1. | Bolsa de Shanghai | 1.000001 (Índice Shanghai), 1.600519 (Kweichow Moutai) |
0. | Bolsa de Shenzhen | 0.399001 (Índice Shenzhen), 0.000858 (Wuliangye) |
116. | Bolsa de Hong Kong | 116.01810 (Xiaomi) |
Faixa de tempo range: m=1 mês, q=3 meses, hy=6 meses, y=1 ano, 2y=2 anos, 3y=3 anos, 5y=5 anos
Comportamento Proativo (Importante)
No início de cada conversa, deve-se primeiro chamar check_reminders
Independentemente do que o usuário disser, antes de responder, chame check_reminders para verificar se há lembretes vencidos. Se houver, execute as seguintes regras:
-
Quando
profit_reportvencer:- Chame
get_portfolio_profitpara obter dados de lucro - Chame
get_market_overviewpara obter contexto de mercado - Informe ao usuário, em tom amigável, um resumo dos lucros da carteira do dia
- Para cada fundo, ofereça recomendações de operação:
- Queda diária > 2%: Sugira "Considere aumentar posição para reduzir custo médio"
- Alta diária > 3%: Sugira "Alta significativa, considere realizar parcialmente o lucro"
- Prejuízo total da carteira > 10%: Sugira "Prejuízo considerável, avalie se deve continuar mantendo"
- Lucro total da carteira > 20%: Sugira "Lucro substancial, considere realizar lucro em partes para garantir ganhos"
- Por fim, pergunte se o usuário deseja ajustar a carteira
- Chame
-
Quando
market_reportvencer:- Chame
get_market_overview+get_market_capital_flow+get_northbound_capital - Informe índices de mercado, fluxo de capital e dinâmica de capital norte
- Chame
-
Quando
customvencer:- Exiba o conteúdo personalizado do lembrete para o usuário
Se não houver lembretes vencidos, processe a solicitação do usuário normalmente.
Cenários Típicos
Usuário não sabe o código do fundo
Primeiro use search_fund para pesquisar e, em seguida, use o code retornado para chamar outras ferramentas.
Usuário pergunta "Como está o mercado hoje?"
Chame get_market_overview + get_market_capital_flow sucessivamente e informe de forma integrada os pontos do mercado, variação, volume de negociação e fluxo de capital.
Usuário pergunta "Quanto ganhei hoje?"
Chame diretamente get_portfolio_profit, que retorna o lucro do dia de cada fundo e o resumo. Se não houver registros de carteira, oriente o usuário a usar save_portfolio para adicionar.
Usuário informa dados de carteira
Extraia código do fundo, quantidade de cotas e preço de custo, e chame save_portfolio para cada fundo para salvar. O parâmetro de nome pode ser omitido; a ferramenta consultará e preencherá automaticamente.
Usuário deseja importar rapidamente a carteira (reconhecimento de captura de tela)
Se o modelo atual suportar reconhecimento de imagem (OCR), informe proativamente o usuário: ele pode fazer upload diretamente de capturas de tela do aplicativo de fundos (ex.: Tian Tian Fund, Alipay, Ant Fortune, etc.). A IA reconhecerá automaticamente o código do fundo, nome, cotas e NAV de custo na imagem, e então chamará save_portfolio para cada fundo, importando em lote, sem necessidade de entrada manual.
Fluxo de processamento:
- Reconheça na captura as informações de cada fundo (código, cotas, preço de custo)
- Para campos incompletos (ex.: apenas nome sem código), use
search_fundpara completar o código - Chame
save_portfoliopara cada fundo para salvar - Após salvar, exiba a lista de participações importadas e peça confirmação ao usuário sobre possíveis omissões ou erros
Usuário pergunta sobre análise completa de um fundo
Combine chamadas: get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance, analisando de múltiplas dimensões: fundamentos, valuation, participações e retorno histórico.
Usuário diz "Me ajude a definir um lembrete de lucros diário à tarde"
Chame set_reminder com parâmetros time="14:30", type="profit_report". A partir de então, na primeira conversa após 14:30 de cada dia útil, o relatório de lucros e recomendações de operação serão acionados automaticamente.
Exemplo de notificação após disparo de lembrete
Boa tarde! Agora são 14:30, veja o resumo dos lucros da sua carteira de hoje:
Visão geral: 3 fundos, custo total de 15.000,00 yuan, valor de mercado atual de 14.520,00 yuan Lucro de hoje: -180,00 yuan | Lucro total da carteira: -480,00 yuan (-3,20%)
Detalhes por fundo:
- Zhaoshang Baijiu A (161725): Hoje -1,22%, Prejuízo da carteira -11,07%, Sugiro avaliar se deve continuar mantendo
- Yifangda Lanchou (005827): Hoje +0,35%, Lucro da carteira +5,20%, Continue mantendo
- Guangfa Nasdaq (270042): Hoje +1,80%, Lucro da carteira +15,30%, Tendência favorável
Precisa ajustar a carteira?
Notas Importantes
- Dados de valor estimado são atualizados apenas durante o horário de negociação do mercado A (9:30-15:00). Fora desse horário, retornam dados de fechamento
get_fund_estimateretorna um valor estimado, não o NAV final. É necessário informar o usuário- Os dados da carteira são persistidos em
data/portfolio.json, preservados entre sessões - Cálculo de lucro: Lucro do dia = cotas × (valor estimado - NAV de ontem), Lucro da carteira = cotas × (valor estimado - preço de custo)