next-finance-mcp 0.6.2 → 0.6.4

package/dist/client.d.ts

@@ -24,6 +24,8 @@ export interface PaginaMeta {
 }
 export interface FiltroContas {
     busca?: string;
+    moeda?: string;
+    portfolio?: string;
     tipoConta?: string;
     pagina?: number;
     limite?: number;
@@ -31,7 +33,6 @@ export interface FiltroContas {
 export interface ResultadoContas {
     contas: Record<string, unknown>[];
     paginacao: PaginaMeta;
-    _fonte?: string;
 }
 export declare function listarContas(filtro?: FiltroContas): Promise<ResultadoContas>;
 export interface FiltroPlanoDeContas {

package/dist/client.js

@@ -70,14 +70,19 @@ const BASE_HEADERS = {
     "Accept-Language": "pt-BR,pt;q=0.9,en;q=0.8",
 };
 /** GET para páginas web (login, seleção de carteira) */
-async function webGet(path) {
+async function webGet(path, checkSession = false) {
     const res = await fetch(`${WEB_BASE}${path}`, {
         headers: { ...BASE_HEADERS, Cookie: getCookieHeader("finance.net.br"),
             Accept: "text/html,application/xhtml+xml,application/json,*/*;q=0.8" },
         redirect: "follow",
     });
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
-    return { status: res.status, text: await res.text(), headers: res.headers };
+    const text = await res.text();
+    if (checkSession && (res.status === 401 || res.status === 403 ||
+        (res.url?.includes("/Login") && !path.includes("/Login")))) {
+        throwSessionExpired();
+    }
+    return { status: res.status, text, headers: res.headers };
 }
 /** POST form-urlencoded para fluxo de login/seleção de carteira */
 async function webPost(path, body, contentType, followRedirect = true) {
@@ -92,15 +97,33 @@ async function webPost(path, body, contentType, followRedirect = true) {
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
     return { status: res.status, text: await res.text(), location: res.headers.get("location") ?? undefined };
 }
+/** Detecta se o servidor está sinalizando sessão expirada */
+function isSessionExpired(status, text) {
+    if (status === 401 || status === 403)
+        return true;
+    // O servidor pode retornar 200 com redirect HTML para /Login
+    if (status === 200 && text.includes("/Login"))
+        return true;
+    return false;
+}
+function throwSessionExpired() {
+    _loggedIn = false;
+    _selectedWallet = null;
+    clearCookies();
+    throw new Error("Sessão expirada. Use a ferramenta `login` para autenticar novamente.");
+}
 /** GET para a API REST — usa api.finance.net.br com o mesmo cookie de sessão */
 async function apiGet(path) {
     const res = await fetch(`${API_BASE}${path}`, {
         headers: { ...BASE_HEADERS, Cookie: getCookieHeader("finance.net.br"), Accept: "application/json" },
     });
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
+    const text = await res.text();
+    if (isSessionExpired(res.status, text))
+        throwSessionExpired();
     if (!res.ok)
         throw new Error(`API GET ${path}: ${res.status}`);
-    return res.json();
+    return JSON.parse(text);
 }
 /** POST JSON para a API REST — usa api.finance.net.br com o mesmo cookie de sessão */
 async function apiPost(path, body) {
@@ -111,9 +134,12 @@ async function apiPost(path, body) {
         body: JSON.stringify(body),
     });
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
+    const text = await res.text();
+    if (isSessionExpired(res.status, text))
+        throwSessionExpired();
     if (!res.ok)
         throw new Error(`API POST ${path}: ${res.status}`);
-    return res.json();
+    return JSON.parse(text);
 }
 function extractCsrf(html) {
     return html.match(/name="__RequestVerificationToken"[^>]+value="([^"]+)"/)?.[1] ?? "";
@@ -252,39 +278,49 @@ export async function selecionarCarteira(nomeCarteira) {
     const nomeExibir = String(encontrada["NomeCarteira"] ?? nomeCarteira);
     return { sucesso: ok, mensagem: ok ? `Carteira "${nomeExibir}" selecionada.` : `Falha ao selecionar carteira (${resp.status}).` };
 }
-// Campos a exibir de conta — sem IDs internos, sem Ativo (todas exibidas são ativas)
-const CAMPOS_EXIBIR_CONTA = new Set([
-    "Nome", "Descricao", "NomeConta", "NomeTipoConta",
-    "Saldo", "Banco", "Agencia", "Numero", "Moeda",
-]);
-/** Slim para exibição — sem IDs. Preserva Id internamente via _id para uso do buscarLancamentos. */
+/** Slim para exibição — captura os 4 níveis hierárquicos, sem IDs. */
 function slimConta(c) {
     if (!c || typeof c !== "object")
         return {};
     const o = c;
-    const slim = {};
-    // Preserva _id internamente (prefixo _ sinaliza "não exibir ao usuário")
-    if (o["Id"] !== undefined)
-        slim["_id"] = o["Id"];
-    for (const [k, v] of Object.entries(o)) {
-        if (CAMPOS_EXIBIR_CONTA.has(k) && v !== null && typeof v !== "object")
-            slim[k] = v;
-    }
-    // Fallback: primitivos sem IDs se lista ficou vazia
-    if (Object.keys(slim).filter(k => !k.startsWith("_")).length === 0) {
-        for (const [k, v] of Object.entries(o)) {
-            if (v !== null && typeof v !== "object" && !k.startsWith("Id") && k !== "id")
-                slim[k] = v;
-        }
-    }
-    // Extrai NomeTipoConta de objeto aninhado se necessário
-    if (!slim["NomeTipoConta"] && o["TipoConta"] && typeof o["TipoConta"] === "object") {
-        const tc = o["TipoConta"];
-        if (tc["Nome"])
-            slim["NomeTipoConta"] = tc["Nome"];
-        if (tc["Id"] && !slim["_idTipoConta"])
-            slim["_idTipoConta"] = tc["Id"];
+    // IDs preservados internamente com prefixo _ (nunca exibidos ao usuário)
+    const _id = o["Id"] ?? o["IdConta"] ?? o["id"] ?? o["idConta"];
+    const _idTipo = o["IdTipoConta"];
+    // Nível 1 — Moeda (ex: "BRL", "USD")
+    const moeda = String(o["NomeMoeda"] ?? o["Moeda"] ?? o["SiglaMoeda"] ?? o["CodigoMoeda"] ?? "").trim();
+    // Nível 2 — Portfolio (ex: "Tesouraria", "Renda Variável", "Previdência")
+    const portfolio = String(o["NomePortfolio"] ?? o["Portfolio"] ?? o["NomeGrupo"] ?? o["Grupo"] ?? "").trim();
+    // Nível 3 — Tipo de Conta (ex: "Conta Corrente", "Ações", "CDB")
+    let tipoConta = String(o["NomeTipoConta"] ?? "").trim();
+    if (!tipoConta && o["TipoConta"] && typeof o["TipoConta"] === "object") {
+        tipoConta = String(o["TipoConta"]["Nome"] ?? "").trim();
     }
+    // Nível 4 — Nome da Conta
+    const nome = String(o["Nome"] ?? o["NomeConta"] ?? o["Descricao"] ?? "").trim();
+    const slim = {};
+    // Campos internos (nunca retornados ao usuário final, usados pelo MCP)
+    if (_id !== undefined)
+        slim["_id"] = _id;
+    if (_idTipo !== undefined)
+        slim["_idTipo"] = _idTipo;
+    // Campos exibíveis
+    if (moeda)
+        slim["moeda"] = moeda;
+    if (portfolio)
+        slim["portfolio"] = portfolio;
+    if (tipoConta)
+        slim["tipo_conta"] = tipoConta;
+    if (nome)
+        slim["nome"] = nome;
+    // Campos financeiros extras se disponíveis
+    if (o["Saldo"] !== undefined && o["Saldo"] !== null)
+        slim["saldo"] = o["Saldo"];
+    if (o["Banco"] !== undefined && typeof o["Banco"] === "string")
+        slim["banco"] = o["Banco"];
+    if (o["Agencia"] !== undefined && typeof o["Agencia"] === "string")
+        slim["agencia"] = o["Agencia"];
+    if (o["Numero"] !== undefined && typeof o["Numero"] === "string")
+        slim["numero"] = o["Numero"];
     return slim;
 }
 /** Tenta endpoints em ordem até encontrar um que responda com dados */
@@ -319,21 +355,29 @@ async function fetchContas() {
     throw new Error("Nenhum endpoint de contas respondeu com dados. Verifique se a carteira está selecionada.");
 }
 export async function listarContas(filtro = {}) {
-    const { contas: raw, fonte } = await fetchContas();
+    const { contas: raw } = await fetchContas();
     // Apenas contas ativas (Ativo === true no cadastro)
     const ativas = raw.filter(c => c["Ativo"] !== false);
     let contas = ativas.map(slimConta);
-    // Filtro por nome (busca em Nome, Descricao, NomeConta)
+    // Nível 4 — filtro por nome da conta
     if (filtro.busca?.trim()) {
-        const termo = filtro.busca.trim().toLowerCase();
-        contas = contas.filter(c => [c["Nome"], c["Descricao"], c["NomeConta"]]
-            .some(v => typeof v === "string" && v.toLowerCase().includes(termo)));
+        const t = filtro.busca.trim().toLowerCase();
+        contas = contas.filter(c => String(c["nome"] ?? "").toLowerCase().includes(t));
+    }
+    // Nível 1 — filtro por moeda (ex: "BRL", "USD")
+    if (filtro.moeda?.trim()) {
+        const t = filtro.moeda.trim().toLowerCase();
+        contas = contas.filter(c => String(c["moeda"] ?? "").toLowerCase().includes(t));
+    }
+    // Nível 2 — filtro por portfolio (ex: "Renda Variável", "Tesouraria")
+    if (filtro.portfolio?.trim()) {
+        const t = filtro.portfolio.trim().toLowerCase();
+        contas = contas.filter(c => String(c["portfolio"] ?? "").toLowerCase().includes(t));
     }
-    // Filtro por nome do tipo de conta (ex: "Cartão de Crédito", "Conta Corrente")
+    // Nível 3 — filtro por tipo de conta (ex: "Conta Corrente", "Ações")
     if (filtro.tipoConta?.trim()) {
-        const termo = filtro.tipoConta.trim().toLowerCase();
-        contas = contas.filter(c => typeof c["NomeTipoConta"] === "string" &&
-            c["NomeTipoConta"].toLowerCase().includes(termo));
+        const t = filtro.tipoConta.trim().toLowerCase();
+        contas = contas.filter(c => String(c["tipo_conta"] ?? "").toLowerCase().includes(t));
     }
     // Paginação client-side
     const pagina = Math.max(1, filtro.pagina ?? 1);
@@ -502,7 +546,8 @@ export async function buscarLancamentos(opts) {
             .find(c => String(c["Nome"] ?? c["NomeConta"] ?? "").toLowerCase().includes(termo));
         if (!encontrada)
             throw new Error(`Conta "${opts.nomeConta}" não encontrada entre as contas ativas. Use listar_contas para ver as contas disponíveis.`);
-        idContaResolvido = String(encontrada["Id"] ?? encontrada["IdConta"] ?? "");
+        // Tenta todos os nomes possíveis de campo ID na resposta da API
+        idContaResolvido = String(encontrada["Id"] ?? encontrada["IdConta"] ?? encontrada["id"] ?? encontrada["idConta"] ?? "");
     }
     let lancamentos;
     // Tenta API REST primeiro; cai no endpoint legado se falhar

package/dist/index.js

@@ -44,13 +44,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         {
             name: "listar_contas",
             description: "Lista as contas ativas da carteira selecionada. " +
-                "Use 'busca' para filtrar por nome (ex: 'Inter', 'Nubank'). " +
-                "Use 'tipo_conta' para filtrar por tipo (ex: 'Cartão de Crédito', 'Conta Corrente').",
+                "As contas seguem hierarquia de 4 níveis: Moeda → Portfolio → Tipo de Conta → Conta. " +
+                "Portfolios: Liquidez, Previdência, Renda Fixa, Renda Variável, Tesouraria. " +
+                "Use os filtros para navegar nessa hierarquia.",
             inputSchema: {
                 type: "object",
                 properties: {
-                    busca: { type: "string", description: "Filtra pelo nome da conta (ex: 'Inter', 'Bradesco')" },
-                    tipo_conta: { type: "string", description: "Filtra pelo tipo de conta (ex: 'Cartão de Crédito', 'Conta Corrente', 'Poupança', 'Investimento')" },
+                    busca: { type: "string", description: "Filtra pelo nome da conta (ex: 'Inter', 'Bradesco', 'PETR4')" },
+                    moeda: { type: "string", description: "Filtra pela moeda (ex: 'BRL', 'USD', 'EUR')" },
+                    portfolio: { type: "string", description: "Filtra pelo portfolio (ex: 'Tesouraria', 'Renda Variável', 'Previdência', 'Liquidez')" },
+                    tipo_conta: { type: "string", description: "Filtra pelo tipo de conta (ex: 'Conta Corrente', 'Cartão de Crédito', 'Ações', 'CDB', 'Fundo de Previdência')" },
                     pagina: { type: "number", description: "Página (começa em 1, padrão: 1)" },
                     limite: { type: "number", description: "Contas por página (padrão: 50, máximo: 200)" },
                 },
@@ -185,6 +188,8 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     return walErr;
                 return ok(await client.listarContas({
                     busca: args["busca"],
+                    moeda: args["moeda"],
+                    portfolio: args["portfolio"],
                     tipoConta: args["tipo_conta"],
                     pagina: args["pagina"],
                     limite: args["limite"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "mcpName": "io.github.paivapiovesan/next-finance",
   "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
   "type": "module",