Crea tus claves en el panel, en «API y MCP». Esquema OpenAPI 3.1: https://watcherwolf.com/v1/openapi.json
Autenticación
Todas las peticiones llevan tu clave en la cabecera Authorization:
Authorization: Bearer ak_wolf_a1b2c3…La clave se enseña una sola vez, al crearla. Hay dos permisos: solo lectura y lectura y escritura.
Endpoints REST
| Método | Ruta | Qué hace | Permiso |
|---|---|---|---|
GET | /v1/status | Resumen de la cuenta: webs arriba y abajo, uptime de 24 h e incidentes activos | lectura |
GET | /v1/monitors | Listar monitores (filtros: status, active, limit, offset) | lectura |
POST | /v1/monitors | Crear un monitor. Campos: url*, name, check_interval, keyword, notify_email | escritura |
GET | /v1/monitors/{id} | Detalle de un monitor con el uptime de 24 h y 7 días | lectura |
PATCH | /v1/monitors/{id} | Cambiar un monitor (los mismos campos que al crear, más is_active) | escritura |
DELETE | /v1/monitors/{id} | Borrar un monitor y su historial (no se puede deshacer) | escritura |
GET | /v1/monitors/{id}/checks | Últimas comprobaciones: estado, tiempos y código HTTP (limit ≤ 500) | lectura |
POST | /v1/monitors/{id}/pause | Pausar el monitor | escritura |
POST | /v1/monitors/{id}/resume | Reanudar el monitor | escritura |
GET | /v1/incidents | Incidentes (filtros: status, monitor_id, days, limit) | lectura |
GET | /v1/pagespeed | Resultados recientes de PageSpeed y Core Web Vitals | lectura |
GET | /v1/ssl | Certificados SSL: validez y días hasta que caducan | lectura |
GET | /v1/domains | Caducidad de los dominios vigilados | lectura |
GET | /v1/guardian | Anomalías del Guardián | lectura |
Ejemplos
Estado de la cuenta:
curl https://watcherwolf.com/v1/status \
-H "Authorization: Bearer ak_wolf_…"Crear un monitor:
curl -X POST https://watcherwolf.com/v1/monitors \
-H "Authorization: Bearer ak_wolf_…" \
-H "Content-Type: application/json" \
-d '{"url": "https://mitienda.com", "name": "Mi tienda", "check_interval": 60}'Servidor MCP
Conecta WatcherWolf a Claude u otro asistente compatible con MCP y pregúntale por tus webs: «¿está todo funcionando?», «¿qué certificados caducan este mes?», «crea un monitor para mitienda.com».
# Claude Code
claude mcp add watcherwolf --transport http https://watcherwolf.com/mcp \
--header "Authorization: Bearer ak_wolf_…"| Herramienta | Qué hace |
|---|---|
list_monitors | Lista los monitores con su estado actual |
get_monitor | Detalle y uptime de 24 h y 7 días de un monitor |
create_monitor | Crea un monitor (permiso de escritura) |
pause_monitor / resume_monitor | Pausa o reanuda un monitor (permiso de escritura) |
list_incidents | Caídas recientes con su duración y motivo |
get_uptime_summary | Resumen de la cuenta |
get_pagespeed_scores | Puntuaciones de PageSpeed y Core Web Vitals |
get_ssl_status | Certificados SSL ordenados por urgencia |
get_domain_expiry | Dominios por fecha de caducidad |
list_guardian_anomalies | Anomalías de rendimiento detectadas |
Errores y límites
{"error": {"message": "La API está disponible en los planes Agency y Business…", "type": "plan_not_included"}}401 unauthorized·403 plan_not_included·403 limit_reached·404 not_found·400 validation_error·429 rate_limited- Límites: 200 peticiones por minuto en REST y 600 en MCP, por clave.
- Los límites del plan (número de monitores, intervalo mínimo) se aplican igual que en el panel. check_interval va en segundos, 60 como mínimo en todos los planes.
