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 callback 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 publicar-ne una en format obert Habilitats d'Agent, llicenciat pel MIT, al repositori públic https://github.com/Wealth-Reader/wealthreader-skills.

L'habilitat wealthreader-integration cobreix:

  • La integració del widget i el callback al backend.
  • Autenticació de redirecció (OAuth) per a aplicacions natives.
  • Actualitzant dades amb token de connexió i gestió d'errors.

No cobreix l'inici de pagament ni el desenvolupament de connectors bancaris. Tampoc substitueix el registre del compte del client: encara necessitaràs configurar la teva api_key, domini autoritzat i URL callback al Panell de Control.

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

Instal·lació en un comandament

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 el repositori skills/wealthreader-integration/ carpeta al directori que llegeixi el teu assistent d'IA i obre una nova sessió. .agents/skills/ (projecte) i ~/.agents/skills/ (usuari) 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/ / o selector automàtic
Antigravity .agents/skills/ ~/.gemini/config/skills/ Menciona l'habilitat pel teu nom
Gemini CLI .agents/skills/ o .gemini/skills/ ~/.agents/skills/ o ~/.gemini/skills/ Automàtic; /skills list
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/ o ~/.roo/skills/ 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 repositori README .

Com utilitzar-lo

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

Utilitza l'habilitat wealthreader-integration per afegir el widget de Wealth Reader i el callback de backend a la meva aplicació. Recupera comptes i transaccions i prova-ho localment sense fer cap petició bancària real.

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

Què comprova i què no comprova

  • Genera proves locals amb dades sintetiques i amb els usuaris de prova del widget (MOCKDATA, MOCKOTP, MOCKLOGINKO). No executa connexions bancàries reals pel teu compte.
  • Verifica que el callback persisteixi abans de respondre {"status":"ok"}, que postMessage missatges estiguin filtrats per font i que les claus d'accés invàlides no entrin en bucles de reintent.
  • Assenyala'ls controls de producció que aquesta documentació no arregla, com l'autenticitat del callback, en comptes d'inventar-los. Resoldre'ls amb Suport abans d'entrar en producció.

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

Manteniment

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

Última actualització