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.
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, 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.

Descriptores

/.well-known/ard.json — catálogo de recursos agénticos
/.well-known/agent-card.json — tarjeta A2A
/.well-known/agent-skills/index.json — capacidades
/.well-known/mcp/server-card.json — tarjeta del servidor MCP
/.well-known/api-catalog — catálogo de API (RFC 9727)
/llms.txt — guía corta · /llms-full.txt — manual con todo el catálogo
/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 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. 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.