Desarrolladores

API de FineRx y servidor MCP

Lleva los datos de precios de FineRx a tu propia app o asistente de IA. Una API REST de solo lectura expone los mismos datos de medicamentos, presentaciones y comparación de precios que muestra el sitio —además de las farmacias más cercanas— y un servidor MCP permite que los agentes de IA los consulten directamente.

Qué ofrece la API

La API pública es de solo lectura y devuelve exactamente lo que muestra el sitio: medicamentos, sus presentaciones (NDC), comparaciones de precios entre cadenas de farmacias y programas de descuento, y farmacias cercanas. Cada precio lleva fecha y cada respuesta incluye la fuente y un aviso legal. Nunca expone proveedores ocultos, filas de origen sin procesar ni precios de referencia internos.

Endpoints

Todos los endpoints están bajo la ruta base versionada y devuelven JSON:

Endpoint	Descripción
GET /api/public/v1/drugs/search?q=	Busca medicamentos por nombre o alias; devuelve candidatos con slugs y el precio más bajo observado.
GET /api/public/v1/drugs/{slug}	Estadísticas de un medicamento y sus variantes de concentración/forma.
GET /api/public/v1/drugs/{slug}/packages	Las presentaciones (NDC) disponibles para un medicamento, con precio inicial y frescura de los datos.
GET /api/public/v1/prices/compare?ndc=&quantity=	La matriz de ofertas de una presentación: cadena × programa de descuento × precio × fecha de observación.
GET /api/public/v1/pharmacies/nearby?zip=	Farmacias más cercanas por cadena alrededor de un código postal de EE. UU.
GET /api/public/v1/meta	Cobertura del conjunto de datos, frescura y los términos de atribución/aviso legal.

La documentación interactiva de OpenAPI (con botón "Authorize") está en /api/public/v1/docs y el esquema legible por máquina está junto a ella.

Autenticación

Cada solicitud necesita una clave de desarrollador (formato frx_live_...), enviada en cualquiera de estos encabezados:

Authorization: Bearer frx_live_...
X-Api-Key: frx_live_...

curl -H "X-Api-Key: frx_live_..." \
  "https://finerxfinder.com/api/public/v1/drugs/search?q=atorvastatin"

Las solicitudes tienen un límite por clave: 60 por minuto y 5000 por día. Al superar un límite se devuelve HTTP 429 con un encabezado Retry-After.

Solicitar una clave

Aún no hay registro automático: las claves se emiten a solicitud. Cuéntanos qué estás construyendo y escríbenos a partners@finerxfinder.com.

Servidor MCP (para agentes de IA)

El paquete finerx-mcp es un cliente ligero sobre esta API que expone FineRx como herramientas a un asistente de IA. Ejecútalo con uvx finerx-mcp y agrégalo a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "finerx": {
      "command": "uvx",
      "args": ["finerx-mcp"],
      "env": { "FINERX_API_KEY": "frx_live_..." }
    }
  }
}

Ofrece cinco herramientas:

search_drugs — buscar medicamentos por nombre
get_drug — estadísticas y variantes de un medicamento
compare_prices — la matriz de ofertas de una presentación
find_nearby_pharmacies — farmacias más cercanas por código postal
get_dataset_info — cobertura, frescura y términos

Términos de atribución y aviso legal

El uso de la API está sujeto a estos términos:

Se requiere atribución: muestra "Prices via FineRx" dondequiera que presentes datos de FineRx.
Los precios son estimaciones observadas recientemente de programas de descuento de terceros —no precios garantizados ni con seguro— y pueden estar desactualizados. No los presentes como garantizados.
Los datos no constituyen asesoramiento médico.

Consulta también nuestra metodología · términos del servicio · política de privacidad.