ComparaPA

ComparaPA Developer Portal

APIs machine-readable, esquema OpenAPI 3.1 y servidor MCP para agentes de IA que necesitan datos financieros verificados de Panamá.

OpenAPI 3.1

Descubre todos los endpoints públicos en formato estándar. El esquema describe los cuatro endpoints REST v1 con sus parámetros, cuerpos de solicitud y respuestas.

JSON

/api/openapi.json

curl https://www.comparapa.com/api/openapi.json

YAML

/openapi.yaml

curl https://www.comparapa.com/openapi.yaml

Ejemplos de llamado

cURL

curl -X GET \
  "https://www.comparapa.com/api/v1/products?category=tarjetas-de-credito&bank=Banco%20General" \
  -H "Accept: application/json"

Python

import requests

r = requests.get(
    "https://www.comparapa.com/api/v1/products",
    params={"category": "tarjetas-de-credito", "tag": "cashback"},
)
print(r.json())

TypeScript

const res = await fetch(
  "https://www.comparapa.com/api/v1/products?category=tarjetas-de-credito",
  { headers: { Accept: "application/json" } },
);
const data = await res.json();

Endpoints REST v1

Todos los endpoints responden JSON, incluyen cabeceras CORS y usan Edge runtime para baja latencia.

GET /api/v1/products

Catálogo de productos financieros filtrable.

  • category: slug público de categoría (ej. tarjetas-de-credito).
  • bank: nombre o slug del banco/aseguradora.
  • tag: etiqueta de beneficio (ej. cashback, low_interest).
curl "https://www.comparapa.com/api/v1/products?category=tarjetas-de-credito&tag=cashback"

GET /api/v1/rates

Tasas y parámetros legales de referencia: CSS 9.75%, Seguro Educativo 1.25% e ISR.

curl "https://www.comparapa.com/api/v1/rates"

GET /api/v1/banks

Directorio de entidades bancarias y aseguradoras reguladas en Panamá.

curl "https://www.comparapa.com/api/v1/banks"

POST /api/v1/calculators/salario-neto

Motor de cálculo de salario neto e ISR.

curl -X POST \
  "https://www.comparapa.com/api/v1/calculators/salario-neto" \
  -H "Content-Type: application/json" \
  -d '{"grossMonthly": 1500}'

Model Context Protocol (MCP)

Conecta agentes de IA a ComparaPA a través del estándar MCP. Registra la URL del manifiesto en clientes compatibles como Claude Code, Cursor, Windsurf, Gemini o OpenAI Agents.

URL del manifiesto

https://www.comparapa.com/.well-known/mcp.json

curl "https://www.comparapa.com/.well-known/mcp.json"

Herramientas disponibles:

Negociación de contenido Markdown (RFC 9110)

Los agentes pueden solicitar representaciones Markdown enviando el encabezado Accept: text/markdown o usando la extensión .md en la URL. Esto es útil para consumir páginas de guía y recuperación 404 en formato legible para LLMs.

GET /tarjetas-de-credito HTTP/1.1
Host: www.comparapa.com
Accept: text/markdown

Equivalente con extensión .md:

curl "https://www.comparapa.com/tarjetas-de-credito.md"

B2B Webhooks y cumplimiento Ley 81

ComparaPA distribuye leads hacia bancos y corredores independientes bajo un flujo de verificación por WhatsApp OTP. Cada lead queda registrado en una traza de auditoría compatible con los requisitos de la ANTAI y la Ley 81 de 2009.

Recursos adicionales