mcpField
C
cotizacion-dolar-argentina

cotizacion-dolar-argentina

github.com/ferminrpOther3954 installsUpdated 13w ago
Repository

About cotizacion-dolar-argentina

A currency-quote lookup skill for Argentina using the public DolarAPI. It serves people checking dollar buying and selling rates or selected foreign currencies, with update times included and no financial recommendations.

Key features

  1. 01Retrieves multiple dollar quote types
  2. 02Looks up EUR, BRL, CLP, and UYU quotes
  3. 03Shows buying, selling, and update time
  4. 04Compares multiple quotes by provider

Use cases

  1. 01Check the blue dollar buying and selling rates
  2. 02Compare Argentina's listed dollar quote types
  3. 03Look up a euro or neighboring-country currency quote

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ferminrp/agent-skills --skill cotizacion-dolar-argentina

After installing, type/cotizacion-dolar-argentinain Claude Code to confirm it loaded.

Details

From the project README

Cotizacion Dolar Argentina

Consulta cotizaciones de dolar y monedas para Argentina con DolarAPI.

API Overview

  • Base URL: https://dolarapi.com
  • Auth: None required
  • Response format: JSON
  • Fuente: DolarAPI endpoint publico
  • Timestamp: fechaActualizacion viene en ISO UTC, por ejemplo 2026-02-17T13:59:00.000Z

Endpoints

Dolares (lista y por tipo)
  • GET /v1/dolares
  • GET /v1/dolares/{tipoCotizacion}

Tipos admitidos para {tipoCotizacion}:

  • oficial
  • blue
  • bolsa
  • contadoconliqui
  • tarjeta
  • mayorista
  • cripto

Ejemplos:

curl -s https://dolarapi.com/v1/dolares | jq '.'
curl -s https://dolarapi.com/v1/dolares/blue | jq '.'
Otras monedas
  • GET /v1/cotizaciones
  • GET /v1/cotizaciones/{codigoMoneda}

Codigos admitidos para {codigoMoneda}:

  • eur
  • brl
  • clp
  • uyu

Ejemplos:

curl -s https://dolarapi.com/v1/cotizaciones | jq '.'
curl -s https://dolarapi.com/v1/cotizaciones/eur | jq '.'

Valores admitidos

  • tipoCotizacion: oficial, blue, bolsa, contadoconliqui, tarjeta, mayorista, cripto
  • codigoMoneda: eur, brl, clp, uyu

Mapeos utiles para lenguaje del usuario:

  • "MEP" -> bolsa
  • "CCL" o "contado con liqui" -> contadoconliqui

Campos clave

Campos base de respuesta:

  • moneda
  • casa
  • nombre
  • compra
  • venta
  • fechaActualizacion

Campo opcional observado:

  • variacion (puede aparecer en algunos casos, por ejemplo mayorista)

Workflow

  1. Detectar intencion del usuario:
    • Dolar general o tipo especifico
    • Otra moneda (eur, brl, clp, uyu)
  2. Elegir endpoint correcto segun la intencion.
  3. Validar valor solicitado (tipoCotizacion o codigoMoneda).
  4. Ejecutar request con curl -s y parsear con jq.
  5. Mostrar resumen corto primero y detalle despues.
  6. Incluir siempre fechaActualizacion en la respuesta.
  7. Si hay multiples cotizaciones, presentar comparativa por casa.

Error Handling

  • 404 con body vacio:
    • Ocurre cuando tipoCotizacion o codigoMoneda no existe.
    • Responder con mensaje claro: "tipo no soportado" o "moneda no soportada".
  • Falla de red/timeout:
    • Reintentar hasta 2 veces con delay corto.
    • Si falla de nuevo, devolver endpoint consultado y error.
  • JSON inesperado:
    • Mostrar minimo crudo util y aclarar inconsistencia del origen.

Presenting Results

  • Priorizar compra, venta y spread (venta - compra).
  • Orden sugerido para dolares:
    • oficial, blue, bolsa, contadoconliqui, mayorista, cripto, tarjeta
  • Aclarar timezone del timestamp (UTC en origen).
  • No dar recomendaciones financieras; solo informar cotizaciones.

Out of Scope

Esta skill no debe usar en v1:

  • /v1/ambito/dolares*
  • /v1/estado
  • Endpoints de otros paises

Comments

Markdown supported