Communitygithub.com

smallke/cn-funds-mcp

Assistente de consulta de dados de fundos e ações da China (API gratuita, sem necessidade de chave API). Consulte valor estimado de fundos, NAV, participações, informações do gestor, cotações de ações/índices, fluxo de capital do mercado, ranking setorial, capital norte, e gerencie sua carteira de fundos com cálculo de lucro usando ferramentas cn-funds-mcp.

O que é cn-funds-mcp?

Esta skill MCP integra o ecossistema cn-funds-mcp para oferecer consultas abrangentes de dados de fundos e ações da China, sem exigir chave API ou custos. Ela permite pesquisar fundos, obter valor estimado em tempo real, histórico de NAV, detalhes de participações e informações do gestor. Também fornece cotações de ações/índices, fluxo de capital do mercado e ranking setorial, além de gerenciar uma carteira pessoal de fundos com cálculo automático de lucros diários e totais. Suporta alertas programados em dias de negociação para relatórios de lucros ou notícias de mercado. O sistema lida proativamente com verificações de lembretes a cada início de conversa e oferece recomendações de trading com base nas flutuações do dia. É ideal para investidores que usam Claude, Cursor ou Codex e desejam monitorar facilmente seus investimentos em fundos e ações da China.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Guia de Uso do cn-funds-mcp

Consulta Rápida de Ferramentas

Consulta de Fundos

FerramentaPropósitoParâmetros Chave
search_fundPesquisar fundo (nome/código/pinyin)keyword
get_fund_estimateValor estimado em tempo real (NAV estimado e variação durante o pregão)fundCode
get_fund_batch_infoObter NAV de múltiplos fundos em lotefundCodes (separados por vírgula)
get_fund_infoDetalhes do fundo (tipo/gestora/gestor/tamanho/ranking)fundCode
get_fund_valuation_detailTendência de valor estimado do dia (intradiário)fundCode
get_fund_net_value_historyHistórico de NAVfundCode, range
get_fund_accumulated_performanceRetorno acumulado vs CSI 300 vs categoriafundCode, range
get_fund_positionDetalhes das participações em açõesfundCode
get_fund_manager_listLista de gestores anterioresfundCode
get_fund_manager_detailPerfil do gestor atualfundCode

Ações/Índices

FerramentaPropósitoParâmetros Chave
get_stock_trendTendência intradiáriasecid (ex.: 1.600519)
get_stock_quoteCotação em tempo realsecids (separados por vírgula)

Mercado/Capital

FerramentaPropósitoParâmetros Chave
get_market_overviewVisão geral do mercado A (Shanghai/Shenzhen)Nenhum
get_market_capital_flowFluxo de capital do mercado (grandes/p equenos players)Nenhum
get_sector_capital_flowRanking de capital setorialtimeType, code
get_northbound_capitalFluxo de capital Norte (Shanghai-Hong Kong/Shenzhen-Hong Kong)Nenhum

Gerenciamento de Carteira

FerramentaPropósitoParâmetros Chave
save_portfolioSalvar/atualizar registro de participaçãofundCode, shares, costPrice
remove_portfolioRemover registro de participaçãofundCode
get_portfolioVisualizar lista de participaçõesNenhum
get_portfolio_profitConsultar lucro do dia e total com um cliqueNenhum

Lembretes Agendados

FerramentaPropósitoParâmetros Chave
set_reminderConfigurar lembrete agendado (dispara em dias úteis)time(HH:MM), type, message
get_remindersVisualizar todos os lembretes configuradosNenhum
remove_reminderRemover um lembreteid
check_remindersVerificar se há lembretes vencidosNenhum

Tipos de lembrete type:

  • profit_report — Relatório de lucros da carteira (após disparo, consulta get_portfolio_profit e 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âmetro message)

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 MercadoSignificadoExemplo
1.Bolsa de Shanghai1.000001 (Índice Shanghai), 1.600519 (Kweichow Moutai)
0.Bolsa de Shenzhen0.399001 (Índice Shenzhen), 0.000858 (Wuliangye)
116.Bolsa de Hong Kong116.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:

  1. Quando profit_report vencer:

    • Chame get_portfolio_profit para obter dados de lucro
    • Chame get_market_overview para 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
  2. Quando market_report vencer:

    • Chame get_market_overview + get_market_capital_flow + get_northbound_capital
    • Informe índices de mercado, fluxo de capital e dinâmica de capital norte
  3. Quando custom vencer:

    • 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:

  1. Reconheça na captura as informações de cada fundo (código, cotas, preço de custo)
  2. Para campos incompletos (ex.: apenas nome sem código), use search_fund para completar o código
  3. Chame save_portfolio para cada fundo para salvar
  4. 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_estimate retorna 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)

Autor

smallke | [email protected]

Habilidades Relacionadas