Developers API & Widget
API Reference
PT

Recursos

Integração com assistentes de IA

Instale a habilidade oficial do Wealth Reader no seu assistente de programação e deixe que ele gere a integração do widget, o callback e a atualização dos dados, seguindo esta documentação.

Qual é a habilidade

Uma habilidade é uma pasta com um arquivo SKILL.md que o assistente de IA carrega quando a tarefa se encaixa na sua descrição. O Wealth Reader publica uma em formato aberto Agent Skills, licenciada pelo MIT, no repositório públicohttps://github.com/Wealth-Reader/wealthreader-skills.

A habilidade wealthreader-integration cobre:

  • A integração do widget e do callback no backend.
  • Autenticação por redirecionamento (OAuth) para aplicativos nativos.
  • Atualização de dados com gerenciamento de conexão token e erros.

Não cobre a iniciação de pagamentos nem o desenvolvimento de conectores bancários. Também não substitui o registro do cliente: você ainda precisará do seu api_keydomínio autorizado e URL de retorno configurados na área do cliente.

A mesma pasta funciona em Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro e qualquer outro assistente de IA que você lerSKILL.md.

Instalando um comando

npx skills add Wealth-Reader/wealthreader-skills

O instalador detecta os assistentes que você tem e permite que você escolha onde copiar a habilidade. Você também pode usar o instalador próprio da sua ferramenta:

# GitHub CLI
gh skill install Wealth-Reader/wealthreader-skills wealthreader-integration --agent claude-code --scope user

# Gemini CLI
gemini skills install https://github.com/Wealth-Reader/wealthreader-skills.git --consent

# Amp
amp skill add https://github.com/Wealth-Reader/wealthreader-skills --global

Instalação Manual

Copie a pasta skills/wealthreader-integration/ do repositório para o diretório que seu assistente de IA lê e abra uma nova sessão. .agents/skills/ (project) e ~/.agents/skills/ (user) são os caminhos compartilhados que a maioria dos assistentes de IA lê. Claude Code, Cline e Kiro apenas leem seu próprio diretório.

Assistente de IA Diretório de Projetos Diretório de Usuários Como Invocá-lo
Claude Code .claude/skills/ ~/.claude/skills/ /wealthreader-integration ou automático
Codex (CLI, IDE, ChatGPT) .agents/skills/ ~/.agents/skills/ $wealthreader-integration ou /skills
Cursor .agents/skills/ ou .cursor/skills/ ~/.agents/skills/ ou ~/.cursor/skills/ Seletor / ou Auto
Antigravity .agents/skills/ ~/.gemini/config/skills/ Mencione a habilidade pelo nome
Gemini CLI .agents/skills/ ou ~/.agents/skills/ ~/.gemini/skills/ ou Automático;/skills list .gemini/skills/
GitHub Copilot .agents/skills/ ou .github/skills/ ~/.agents/skills/ ou ~/.copilot/skills/ Automático
Grok Build .grok/skills/ (também leia.claude/skills/) ~/.grok/skills/ ou ~/.agents/skills/ /wealthreader-integration
Windsurf .agents/skills/ ou .windsurf/skills/ ~/.agents/skills/ ou ~/.codeium/windsurf/skills/ @wealthreader-integration
OpenCode .agents/skills/ ou .opencode/skills/ ~/.agents/skills/ ou ~/.config/opencode/skills/ Automático
Amp .agents/skills/ ~/.agents/skills/ ou ~/.config/agents/skills/ Automático
Cline .cline/skills/ (também leia).claude/skills/ ~/.cline/skills/ /wealthreader-integration
Roo Code .agents/skills/ ou .roo/skills/ ~/.agents/skills/ ~/.roo/skills/ ou Automático
Kiro .kiro/skills/ ~/.kiro/skills/ /wealthreader-integration

Os caminhos foram verificados em relação à documentação pública de cada ferramenta em 5 de setembro de 2026. A tabela atualizada está sempre no README repositório.

Como usar

Peça integração na linguagem e framework da sua aplicação. Um exemplo de pedido:

Uso a habilidade de integração com o wealthreader para adicionar o widget do Wealth Reader e o backend callback ao meu aplicativo. Recupero contas e transações e teste localmente sem fazer solicitações bancárias reais.

A habilidade orienta o assistente de IA pelos contratos documentados neste guia, em vez de improvisar a partir de outras APIs de open banking ou OAuth. Para cada fluxo, leia a página correspondente:

O que ele verifica e o que não verifica

  • Gera testes locais com dados sintéticos e com os usuários de teste do widget (MOCKDATA, , MOCKOTP``MOCKLOGINKO). Não executa conexões bancárias reais por conta própria.
  • Verificar se o callback persiste antes de{"status":"ok"} responder, que as mensagens postMessage são filtradas por fonte e que credenciais inválidas não entram em loops de retentativa.
  • Apontar controles de produção que essa documentação não corrige, como autenticidade de callback, em vez de inventá-los. Resolvê-los com Suporte antes de entrar em produção.

A habilidade nunca pede os api_key tokens de ou no chat. Mantenha segredos no servidor e fora do frontend, logs e repositório. Um teste local que passa não prova que uma conexão bancária real funciona.

Manutenção

A habilidade é construída apenas a partir de documentação pública e links para as fontes de cada contrato. Se você notar uma discrepância neste guia, abra um chamado no repositório.

Última atualização