# Ferretería Clarita

> Ferretería en Ensenada, Berisso y La Plata. 4 sucursales, más de 56.000 artículos, duplicado de llaves y cuenta corriente para empresas.

Cadena de ferreterías con 4 sucursales (Ensenada, Berisso y La Plata, provincia de Buenos Aires, Argentina), más de 56.364 artículos y 766 marcas. Razón social Ferretería Clarita S.R.L., CUIT 30-71219868-7. Cada página HTML de este sitio tiene su versión Markdown: pedila con `Accept: text/markdown`.

## Páginas

- [Inicio](https://www.ferreteriaclarita.com.ar/): sucursales, rubros, servicios, tienda, empresas, preguntas frecuentes y contacto
- [Sucursales y horarios](https://www.ferreteriaclarita.com.ar/sucursales)
- [Quiénes somos](https://www.ferreteriaclarita.com.ar/about)
- [Contacto](https://www.ferreteriaclarita.com.ar/contact)
- [Privacidad](https://www.ferreteriaclarita.com.ar/privacy)
- [Desarrolladores y API](https://www.ferreteriaclarita.com.ar/developers): cómo integrarse, claves, servidor MCP, demo
- [Documentación de la API](https://www.ferreteriaclarita.com.ar/docs): endpoints públicos, autenticación, ejemplos, errores
- [Versionado y política de deprecación de la API](https://www.ferreteriaclarita.com.ar/docs/versionado): header API-Version, Deprecation/Sunset (RFC 8594), límites

## Cuándo usar este sitio o su API (when to use)

- **Saber si una sucursal está abierta ahora, horarios, dirección y teléfono**: leer https://www.ferreteriaclarita.com.ar/sucursales (o `GET https://www.ferreteriaclarita.com.ar/api/auth/identidad`, JSON con sucursales y horarios); la portada muestra el estado abierto/cerrado en vivo
- **Contactar al comercio (consulta, presupuesto, pedido)**: WhatsApp +5492213589100 (`ContactPoint` de ventas en el JSON-LD) o e-mail ferreteriaclarita@gmail.com; no hay formulario web
- **Verificar si hay tienda online y comprar**: `GET https://www.ferreteriaclarita.com.ar/api/tienda/config` → `tiendaActiva`; si es `true`, la tienda está en https://clarita.ferreteriaclarita.com.ar/tienda
- **Qué rubros y marcas trabaja, medios de pago, servicios (duplicado de llaves, cuenta corriente para empresas)**: portada https://www.ferreteriaclarita.com.ar/ y https://www.ferreteriaclarita.com.ar/about (también en Markdown con `Accept: text/markdown`)
- **Comprobar el estado del sistema de gestión**: `GET https://www.ferreteriaclarita.com.ar/api/publico/confianza` (versión, tiempo en línea, último backup) y `GET https://www.ferreteriaclarita.com.ar/api/health`
- **Consultar ventas, stock, caja o cuentas del comercio (solo con su autorización)**: servidor MCP `POST https://www.ferreteriaclarita.com.ar/api/mcp` o asistente `POST https://www.ferreteriaclarita.com.ar/api/asistente/externo`, con la clave de integración que emite la administración de Ferretería Clarita

Cuándo no (when not to use):
- Datos de otros comercios: este dominio es solo Ferretería Clarita; cada comercio del sistema ERProva tiene su propio dominio y su propia clave.
- Precios o stock sin clave: no se publican; pedilos por WhatsApp o integrate con la clave del comercio.
- Reservas o pedidos automáticos sin hablar con el comercio: la API pública no toma pedidos.

## Cómo llamar (how to call)

- Sin clave: los `GET` públicos de arriba y las páginas en Markdown (`Accept: text/markdown`).
- Con la clave del comercio (header `X-Api-Key`): MCP `POST https://www.ferreteriaclarita.com.ar/api/mcp` (JSON-RPC 2.0: `initialize` → `tools/list` → `tools/call`; herramientas de solo lectura) y asistente `POST https://www.ferreteriaclarita.com.ar/api/asistente/externo` con `{"pregunta": "…"}`.
- Respuestas siempre en JSON; errores `{ error, codigo }`; `API-Version: 2.0`; límites en `RateLimit`.

## API, OpenAPI y MCP de Ferretería Clarita (responden en este dominio)

- Especificación OpenAPI 3.1: https://www.ferreteriaclarita.com.ar/openapi.json
- Manifiesto del servidor MCP: https://www.ferreteriaclarita.com.ar/.well-known/mcp.json (servidor: POST https://www.ferreteriaclarita.com.ar/api/mcp, JSON-RPC 2.0; herramientas de solo lectura con clave del comercio)
- Identidad pública (sucursales, horarios, teléfonos): GET https://www.ferreteriaclarita.com.ar/api/auth/identidad
- Tienda online: GET https://www.ferreteriaclarita.com.ar/api/tienda/config (tiendaActiva) — la tienda vive en https://clarita.ferreteriaclarita.com.ar/tienda
- Estado del sistema (versión, backups): GET https://www.ferreteriaclarita.com.ar/api/publico/confianza
- Errores siempre en JSON: { error, codigo }

## Sistema de gestión (ERProva)

- Panel del equipo: https://clarita.ferreteriaclarita.com.ar/ — las mismas rutas técnicas también responden ahí: https://clarita.ferreteriaclarita.com.ar/developers · https://clarita.ferreteriaclarita.com.ar/openapi.json · https://clarita.ferreteriaclarita.com.ar/.well-known/mcp.json

## Contacto

- WhatsApp: +5492213589100
- Email: ferreteriaclarita@gmail.com
- Instagram: https://www.instagram.com/ferreteriaclarita/