Agent Skill

Enseña a tu agente de IA a usar la API de UpInvoice

La skill upinvoice-api da a un agente de IA lo que necesita para integrar la API sin adivinar: autenticación, formato de la petición, reglas de los campos, gestión de errores, reintentos seguros y cómo llevar el resultado a un ERP.

Qué contiene

  • SKILL.md: cuándo usar la API, formato de petición y respuesta, errores e idempotencia.
  • references/integration.md: flujo recomendado, lista de comprobaciones, correspondencia de campos y búsqueda de terceros y productos.
  • scripts/upinvoice_extract.py: script de línea de comandos con reintentos, solo con la biblioteca estándar.

Instalación

  • Claude Code: añade el marketplace de plugins de UpInvoice e instala el plugin, o descomprime el .zip en tu carpeta de skills (personal o del proyecto).
  • Apps de Claude: sube el .zip en Ajustes, dentro de Capacidades, Skills.
  • Otros agentes: instálala con el CLI de skills (npx skills add upinvoice/skills) o copia la carpeta donde carguen sus skills.
# Claude Code (plugin marketplace)
claude plugin marketplace add upinvoice/skills
claude plugin install upinvoice-api@upinvoice

# Other agents (skills CLI)
npx skills add upinvoice/skills

# Manual install, personal (all projects)
mkdir -p ~/.claude/skills && cd ~/.claude/skills
# or only this project: mkdir -p .claude/skills && cd .claude/skills
curl -sSLO https://upinvoice.eu/downloads/upinvoice-api-skill.zip
unzip upinvoice-api-skill.zip && rm upinvoice-api-skill.zip

export UPINVOICE_API_KEY=...   # https://upinvoice.eu/api/tokens

API key

La skill lee la clave de la variable de entorno UPINVOICE_API_KEY. Créala en upinvoice.eu/api/tokens y no la pegues nunca en el chat.

Después pide a tu agente algo como:

Usa la skill upinvoice-api para escribir un script que lea todos los PDF de ./facturas y guarde proveedor, número, fecha y totales en un CSV.