---
title: "Documentación para agentes y desarrolladores"
description: "Catálogo abierto de una farmacia de Barcelona: API sin autenticación, servidor MCP, OpenAPI y cada página en markdown. Documentación para agentes de IA."
canonical: https://151marinapharmacy.com/desarrolladores/
site: 151 Marina Pharmacy
language: es-ES
---

# Documentación para agentes y desarrolladores

Esta farmacia publica su catálogo en abierto para que cualquier programa —o cualquier asistente de inteligencia artificial— pueda consultarlo, entenderlo y ayudar a comprar. Sin registro, sin claves y sin coste.

## Qué hay disponible

 - **API del catálogo**: los 170 productos con precio con IVA, existencias, imágenes, categorías, código de barras y la ficha completa. [Especificación OpenAPI 3.1](/openapi.json).

 - **Servidor MCP**: https://151marinapharmacy.com/mcp, transporte streamable-http. Tres herramientas: buscar productos, leer una ficha entera y consultar condiciones de envío.

 - **Preguntas en lenguaje natural**: POST /ask con {"query": "..."}. Admite respuesta en flujo (SSE).

 - **Catálogo completo en un fichero**: [/feed-productos.xml](/feed-productos.xml), en formato Google Shopping.

 - **Cada página en markdown**: añade .md a cualquier dirección, o pide la página con la cabecera Accept: text/markdown.

## Empezar en un minuto

Buscar productos:

curl "https://151marinapharmacy.com/wp-json/wc/store/v1/products?search=solar&per_page=5"

Preguntar en español:

curl -X POST https://151marinapharmacy.com/ask 
 -H "Content-Type: application/json" 
 -d '{"query":"protector solar facial SPF 50 para piel sensible por menos de 30 euros"}'

Conectar el servidor MCP:

curl -X POST https://151marinapharmacy.com/mcp 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

## Autenticación

Ninguna para leer el catálogo ni para montar un carrito. El pago lo hace siempre una persona, en el navegador, en la pasarela del banco. Está explicado a fondo en [auth.md](/auth.md).

## Descriptores

 - [/.well-known/ard.json](/.well-known/ard.json) — catálogo de recursos agénticos

 - [/.well-known/agent-card.json](/.well-known/agent-card.json) — tarjeta A2A

 - [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json) — capacidades

 - [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json) — tarjeta del servidor MCP

 - [/.well-known/api-catalog](/.well-known/api-catalog) — catálogo de API (RFC 9727)

 - [/llms.txt](/llms.txt) — guía corta · [/llms-full.txt](/llms-full.txt) — manual con todo el catálogo

 - [/pricing.md](/pricing.md) — precios y condiciones en markdown

## Límites y buen uso

No hay límite declarado, pero sí una petición razonable: pagina de 100 en 100 y no lances cientos de consultas en paralelo. Si necesitas el catálogo entero, bájatelo de una vez del [fichero de catálogo](/feed-productos.xml) en lugar de recorrer la API producto a producto.

## Lo que esta farmacia no hace

**No vende medicamentos por internet**, ni con receta ni sin ella. La venta a distancia de medicamentos está regulada por el Real Decreto 870/2013 y requiere una autorización específica que esta web no tiene.

Los complementos alimenticios que aquí se venden **no son medicamentos** y no previenen, tratan ni curan enfermedades. Las fichas atribuyen siempre los datos al fabricante y no prometen resultados.

Si construyes algo sobre este catálogo y vas a recomendar productos a personas, lee la ficha completa antes: ahí están las advertencias, las contraindicaciones y para quién no es apto cada producto.

## Contacto

Escribe a [farmaciamarinabcn@gmail.com](mailto:farmaciamarinabcn@gmail.com). Si necesitas claves de la API de gestión (pedidos, clientes), explícanos para qué: no se dan automáticamente, porque detrás de los pedidos hay datos de salud de personas.

---

_151 Marina Pharmacy · farmacia en Carrer de Casp 151, Barcelona · https://151marinapharmacy.com/_