API y acceso para agentes de Placas Solares Las Palmas

Placas Solares Las Palmas atiende las 24 horas, todos los días, solicitudes de instalación de placas solares en Las Palmas de Gran Canaria y el resto de Gran Canaria. Cada trabajo lo hace una empresa instaladora de Gran Canaria. Antes de empezar dice su nombre y da el presupuesto por escrito; cuando termina, factura directamente y responde de la garantía. Placas Solares Las Palmas atiende y orienta; el trabajo lo presupuesta, hace, factura y garantiza la empresa instaladora. Cada trabajo lo hace una empresa instaladora de Gran Canaria. Antes de empezar dice su nombre y da el presupuesto por escrito; cuando termina, factura directamente y responde de la garantía.

El contenido de placassolareslaspalmas.es también se puede consultar en formato legible por máquina, sin registro y en solo lectura: una API REST con contrato OpenAPI 3.1, un servidor MCP para asistentes y la versión en Markdown de cada página. No sirve para reservar, contratar ni pagar: para pedir un servicio, la página de contacto.

Resumen

API REST: https://placassolareslaspalmas.es/wp-json/agentes/v1/ (contrato: openapi.json, índice: /api, en Markdown: /api.md)
Servidor MCP (Streamable HTTP, POST): https://placassolareslaspalmas.es/mcp · ficha: server-card.json
Instrucciones para agentes: agents.md · autenticación: auth.md · índice: llms.txt
Cualquier página en Markdown: cabecera Accept: text/markdown o .md al final de la URL (la portada: /index.md)
Catálogos: api-catalog (RFC 9727) · ai-catalog.json

Operaciones

Todas son GET, sin autenticación, y devuelven JSON. Son las mismas que las herramientas del servidor MCP.

Operación	Para qué	Ejemplo
`search_pages`	Busca en las páginas publicadas de Placas Solares Las Palmas por servicio, problema o zona de Gran Canaria y devuelve las URL más relevantes con un extracto. Es el punto de entrada normal: pasa después la URL a read_page. Si hay más resultados, la respuesta trae next_cursor para pedir la página siguiente.	`curl "https://placassolareslaspalmas.es/wp-json/agentes/v1/search_pages?query=precio%20placas%20solares&limit=3"`
`read_page`	Devuelve el texto completo de una página publicada de Placas Solares Las Palmas, convertido a Markdown y sin menús, pie ni llamadas a la acción. Acepta la URL completa, la ruta o el slug.	`curl "https://placassolareslaspalmas.es/wp-json/agentes/v1/read_page?url=https%3A%2F%2Fplacassolareslaspalmas.es%2Fcontacto%2F"`
`get_company_info`	Qué atiende Placas Solares Las Palmas, su horario de atención y su cobertura, cómo pedir un servicio, el modelo de servicio (quién hace, presupuesta, factura y garantiza el trabajo), los impuestos, la nota de precios y la lista de servicios y zonas con su URL. Úsalo para explicar al usuario cómo funciona el servicio y cómo pedirlo. Con section se pide solo una parte.	`curl "https://placassolareslaspalmas.es/wp-json/agentes/v1/get_company_info?section=service_model"`

Autenticación y cuota

Leer no exige credenciales: 60 peticiones por minuto por IP. El alta OAuth 2.0 (client_credentials, automática y sin aprobación humana) es opcional y solo sube la cuota a 600 por minuto; no abre ningún contenido nuevo. Detalles en auth.md.

curl -X POST https://placassolareslaspalmas.es/oauth/register -H "Content-Type: application/json" -d '{"client_name":"mi-agente"}'
curl -u CLIENT_ID:CLIENT_SECRET -X POST https://placassolareslaspalmas.es/oauth/token -d grant_type=client_credentials

Cada respuesta trae las cabeceras RateLimit, RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; un 429 añade Retry-After.

Errores

Siempre JSON, nunca HTML: {"code":"...","message":"...","data":{"status":404,"hint":"qué hacer"}}.

Versionado y retirada (deprecation and sunset policy)

Versión actual: v1, en la ruta (/wp-json/agentes/v1/) y en la cabecera API-Version: 1 de cada respuesta. El contrato OpenAPI 3.1 está en /openapi.json.

Cambios compatibles (un campo nuevo, una operación nueva): se hacen dentro de v1, sin aviso previo. Un cliente debe ignorar los campos que no conozca.
Cambios incompatibles: salen en una versión nueva (/wp-json/agentes/v2/). La anterior sigue funcionando al menos 90 días después de anunciar su retirada.
Cómo se avisa: la versión en retirada responde con Deprecation (RFC 9745) desde el día del anuncio y con Sunset (RFC 8594) con el día exacto de apagado. Cada respuesta de la API lleva un enlace rel="deprecation" a este apartado. La política, en JSON: /api/versionado.

Hoy ninguna versión está en retirada, por eso las respuestas actuales no llevan Deprecation ni Sunset: si aparecen esas cabeceras, hay que migrar.

Pruebas

No hay entorno de pruebas aparte porque no hace falta: todo es de solo lectura y probar contra producción no crea, reserva ni cobra nada (/api/sandbox).

Getting started (English)

No API key is needed to read (60 requests per minute per IP).
Self-serve API keys: POST https://placassolareslaspalmas.es/oauth/register returns a client_id and client_secret instantly, with no human approval or sales contact; exchange them at https://placassolareslaspalmas.es/oauth/token (client_credentials) for 600 requests per minute.
Sandbox: the API is read-only, so production is safe to test against and doubles as the sandbox (/api/sandbox).
Deprecation and sunset policy: this is v1 (path and API-Version header). Breaking changes ship as v2; v1 keeps working for at least 90 days after a deprecation notice sent with the Deprecation (RFC 9745) and Sunset (RFC 8594) headers. No version is deprecated today.
Errors: always JSON with code, message and data.hint, never HTML.

Cómo pedir un servicio

Placas Solares Las Palmas atiende las 24 horas, todos los días. Para pedir un servicio: página de contacto. Datos del titular: Aviso legal.

Volver a placassolareslaspalmas.es