Developers API & Widget
API Reference
CA

Recursos

Integració amb assistents d'IA

Instal·la l'habilitat oficial de Wealth Reader al teu assistent de programació i deixa que generi la integració del widget, la devolució de trucades i l'actualització de dades seguint aquesta documentació.

Quina és l'habilitat

Una habilitat és una carpeta amb un fitxer SKILL.md que l'assistent d'IA carrega quan la tasca encaixa amb la seva descripció. Wealth Reader en publica una en format obert Agent Skills, llicenciat pel MIT, al repositori públichttps://github.com/Wealth-Reader/wealthreader-skills.

L'habilitat wealthreader-integration cobreix:

  • La integració del widget i la callback al backend.
  • Autenticació de redirecció (OAuth) per a aplicacions natives.
  • Actualització de dades amb la gestió de connexions token i errors.

No cobreix la iniciació de pagaments ni el desenvolupament de connectors bancaris. Tampoc substitueix el registre del client: encara necessitaràs configurar el teu api_keydomini autoritzat i la URL de retorn de trucada a l'àrea del client.

La mateixa carpeta funciona a Claude Code, Codex, Cursor, Antigravity, Gemini CLI, GitHub Copilot, Grok Build, Windsurf, OpenCode, Amp, Cline, Roo Code, Kiro i qualsevol altre mag d'IA que llegeixisSKILL.md.

Instal·lant una comanda

npx skills add Wealth-Reader/wealthreader-skills

L'instal·lador detecta els assistents que tens i et permet triar on copiar l'habilitat. També pots utilitzar l'instal·lador propi de la teva eina:

# 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

Instal·lació manual

Copia la carpeta skills/wealthreader-integration/ del repositori al directori que llegeixi el teu assistent d'IA i obre una nova sessió. .agents/skills/ (project) i ~/.agents/skills/ (user) són els camins compartits que la majoria d'assistents d'IA llegeixen. Claude Code, Cline i Kiro només llegeixen el seu propi directori.

Assistent d'IA Directori de projectes Directori d'usuaris Com invocar-lo
Claude Code .claude/skills/ ~/.claude/skills/ /wealthreader-integration o automàtic
Codex (CLI, IDE, ChatGPT) .agents/skills/ ~/.agents/skills/ $wealthreader-integration o /skills
Cursor .agents/skills/ o .cursor/skills/ ~/.agents/skills/ o ~/.cursor/skills/ Selector / o Auto
Antigravity .agents/skills/ ~/.gemini/config/skills/ Menciona l'habilitat pel nom
Gemini CLI .agents/skills/ o ~/.agents/skills/ ~/.gemini/skills/ o Automàtic;/skills list .gemini/skills/
GitHub Copilot .agents/skills/ o .github/skills/ ~/.agents/skills/ o ~/.copilot/skills/ Automàtic
Grok Build .grok/skills/ (també llegiu.claude/skills/) ~/.grok/skills/ o ~/.agents/skills/ /wealthreader-integration
Windsurf .agents/skills/ o .windsurf/skills/ ~/.agents/skills/ o ~/.codeium/windsurf/skills/ @wealthreader-integration
OpenCode .agents/skills/ o .opencode/skills/ ~/.agents/skills/ o ~/.config/opencode/skills/ Automàtic
Amp .agents/skills/ ~/.agents/skills/ o ~/.config/agents/skills/ Automàtic
Cline .cline/skills/ (també llegiu.claude/skills/) ~/.cline/skills/ /wealthreader-integration
Roo Code .agents/skills/ o .roo/skills/ ~/.agents/skills/ ~/.roo/skills/ o Automàtic
Kiro .kiro/skills/ ~/.kiro/skills/ /wealthreader-integration

Els camins es van comprovar amb la documentació pública de cada eina el 5 de setembre de 2026. La taula actualitzada sempre es troba al README repositori.

Com utilitzar-lo

Demana integració en el llenguatge i el marc de la teva aplicació. Un exemple de sol·licitud:

Utilitzar l'habilitat d'integració wealthreader per afegir el widget de Wealth Reader i la trucada backend a la meva aplicació. Recuperar comptes i transaccions i provar-ho localment sense fer sol·licituds bancàries reals.

L'habilitat guia l'assistent d'IA a través dels contractes documentats en aquesta guia en lloc d'improvisar amb altres API de banca oberta o OAuth. Per a cada flux, llegeix la pàgina corresponent:

Què comprova i què no

  • Genera proves locals amb dades sintètiques i amb els usuaris de prova del widget (MOCKDATA, , MOCKOTP``MOCKLOGINKO). No executa connexions bancàries reals per si sola.
  • Verificar que la devolució de la trucada persisteixi abans de{"status":"ok"} respondre, que els missatges postMessage es filtrin per font i que les credencials invàlides no entrin en bucles de reintent.
  • Assenyalar controls de producció que aquesta documentació no arregla, com ara l'autenticitat de callback, en lloc d'inventar-los. Resoldre'ls amb Suport abans d'entrar en producció.

L'habilitat mai demana tokens api_key o o al xat. Guarda secrets al servidor i fora del frontend, registres i repositori. Una prova local que supera no demostra que una connexió bancària real funcioni.

Manteniment

L'habilitat es construeix només a partir de documentació pública i enllaços a les fonts de cada contracte. Si notes una discrepància amb aquesta guia, obre un tiquet al repositori.

Última actualització