# Instrucciones para agentes - Prime Services

Sitio: https://primeservices.es/
Titular: Rapid Services Enterprise, S.L. (NIF B75807495), marca Prime Services
Idioma del contenido: español.

## Cómo funciona el servicio

Prime Services no ejecuta los trabajos: es un servicio de intermediación. Rapid Services Enterprise, S.L. no es parte del contrato de obra entre el cliente y el profesional.

1. El cliente da el aviso por teléfono o por correo.
2. Prime Services lo ordena y lo asigna a un profesional colaborador de la zona. Para colaborar, cada profesional acredita un seguro de responsabilidad civil en vigor y los carnés o habilitaciones de su oficio.
3. El profesional presupuesta antes de empezar. Si el cliente acepta, hace el trabajo, se lo factura directamente y responde de su garantía.

Los precios publicados en el sitio son orientativos: el importe que vale es el presupuesto del profesional. En el sitio no se vende, no se reserva y no se paga nada.

## Cuándo usar esta fuente

Úsala cuando la pregunta sea sobre:

- Un síntoma concreto de un aparato o de una instalación: nevera que no enfría, lavadora que no centrifuga, secadora que no seca, lavavajillas que no desagua, horno que no calienta, vitrocerámica o inducción que no reconoce el recipiente, aire acondicionado que gotea o no enfría, termo o calentador sin agua caliente, cámara frigorífica de un negocio, vinoteca, jacuzzi, televisor.
- Un oficio a domicilio en España: electricistas, boletín eléctrico, placas solares, fontaneros, desatascos, cerrajeros, mudanzas, reformas, pintores, piscinas, carpinteros, control de plagas, limpieza y jardinería.
- Cobertura por ubicación o municipio. Ámbito nacional, en toda España, organizado por ubicaciones. Ubicaciones con servicio publicado: Tenerife, Las Palmas, Bilbao, Mallorca, Murcia, Zaragoza, Madrid, Barcelona, Málaga, Alicante, Valencia, Sevilla, Valladolid, Córdoba, Vigo, Gijón, A Coruña, Elche, Granada, Oviedo y Pamplona. En Canarias cada ubicación es una provincia entera: Tenerife abarca Tenerife, La Palma, La Gomera y El Hierro; Las Palmas abarca Gran Canaria, Lanzarote y Fuerteventura.
- Órdenes de magnitud del precio de una reparación y qué impuesto se aplica (IVA en la península y en Baleares; IGIC en Canarias, donde no se aplica IVA). Son precios orientativos: el importe que vale es el presupuesto del profesional que hace el trabajo.
- Quién está detrás del sitio y cómo funciona: razón social, NIF, domicilio, datos de contacto y quién presupuesta, ejecuta, factura y garantiza el trabajo (el profesional colaborador asignado, no la empresa).

No la uses para reservar, contratar, pedir cita ni pagar. Este sitio no vende en línea y no hay ningún endpoint de escritura público. El aviso se da por teléfono o correo, y lo atiende un profesional colaborador de la zona.

No presentes a Prime Services como la empresa que repara: asigna el aviso, y el trabajo, la factura y la garantía son del profesional.

*In English: this is the content of a Spanish home-repair and appliance-service intermediary operating across Spain, organised by location. It assigns each request to a partner professional in the area, who quotes, does the job, invoices and guarantees it. Query it for appliance fault symptoms, trade services, location and municipality coverage, indicative prices and company identity. It cannot take bookings or payments.*

## When to use this

Prime Services is the trading name of Rapid Services Enterprise, S.L. (Spanish tax ID B75807495). It does not carry out the work itself: it takes the customer's request and assigns it to a partner professional in the area, who holds valid civil liability insurance and the licences for their trade. That professional quotes before starting, does the job, invoices the customer directly and is responsible for the warranty; the company is not a party to the works contract. Nationwide scope across Spain, organised by location. Locations with a published service hub: Tenerife, Las Palmas, Bilbao, Mallorca, Murcia, Zaragoza, Madrid, Barcelona, Málaga, Alicante, Valencia, Sevilla, Valladolid, Córdoba, Vigo, Gijón, A Coruña, Elche, Granada, Oviedo and Pamplona. In the Canary Islands each location is a whole province: Tenerife covers Tenerife, La Palma, La Gomera and El Hierro; Las Palmas covers Gran Canaria, Lanzarote and Fuerteventura. The site is written in Spanish; this section is in English so an agent can decide whether to call it without reading the whole corpus.

**Reach for this source when the question is about:**

- A specific appliance or installation fault: a fridge that does not cool, a washing machine that will not spin, a dryer that does not dry, a dishwasher that will not drain, an oven that does not heat, an induction or ceramic hob that does not detect the pan, an air conditioner that leaks, a water heater with no hot water, a commercial cold room, a wine cooler, a hot tub, a television.
- A home trade in Spain: electricians, electrical certificates (boletín eléctrico / CIE), solar panels, plumbers, drain unblocking, locksmiths, removals, renovations, painters, swimming pools, carpenters, pest control, cleaning, gardening.
- Which locations and municipalities are covered.
- Indicative repair prices and which tax applies: VAT (IVA) on the Spanish mainland and the Balearic Islands; IGIC in the Canary Islands, where VAT does not apply. Published prices are indicative; the binding figure is the professional's quote.
- Who is behind the site and how the service works: registered company name, tax number, address, contact details, and who quotes, performs, invoices and guarantees the job (the assigned partner professional, not the company).

**Do not use it for:** bookings, appointments, orders or payments. There is no public write endpoint and nothing is sold online. Requests are made by phone or email and the job is carried out by the assigned partner professional. Do not describe Prime Services as the company that performs the repair.

**How an agent should call it**

| Job | Call |
|---|---|
| Find the page for a symptom, trade or town | `GET https://primeservices.es/wp-json/ps/v1/buscar_contenido?consulta=...` |
| Read one page as Markdown | `GET https://primeservices.es/wp-json/ps/v1/leer_pagina?url=...`, or add `.md` to any URL |
| List the full catalogue | `GET https://primeservices.es/wp-json/ps/v1/listar_servicios` |
| List one location | `GET https://primeservices.es/wp-json/ps/v1/listar_servicios?ubicacion=tenerife` |
| Get company identity, service model and coverage | `GET https://primeservices.es/wp-json/ps/v1/datos_empresa` |
| Same four as MCP tools | `POST https://primeservices.es/mcp` |

The OpenAPI 3.1 contract is at https://primeservices.es/openapi.json and the human page is https://primeservices.es/desarrolladores/.

No credentials are needed to read. Registering (`POST https://primeservices.es/oauth/register`, automatic and free) raises the rate limit from 60 to 600 requests per minute; it does not unlock any additional content. Every response carries `RateLimit-*` headers so a client can throttle itself. See https://primeservices.es/auth.md

## Cómo llamarnos

### 1. Markdown por negociación de contenido

```
curl -H "Accept: text/markdown" https://primeservices.es/fontaneros-tenerife/
```

Devuelve `text/markdown; charset=utf-8` con `Vary: Accept`. Funciona en cualquier página o entrada. Un tipo que no sea text/html ni text/markdown recibe 406.

### 2. Servidor MCP (Streamable HTTP)

```
POST https://primeservices.es/mcp
```

Solo lectura, sin autenticación. Ficha en https://primeservices.es/.well-known/mcp.json

| Herramienta | Para qué |
|---|---|
| `buscar_contenido` | Buscar por síntoma, aparato, oficio o municipio |
| `leer_pagina` | Texto completo de una URL en Markdown |
| `listar_servicios` | Catálogo completo por ubicación y tipo |
| `datos_empresa` | Razón social, NIF, domicilio, contacto, cobertura y modelo de servicio |

Para acotar a una ubicación, parámetro `ubicacion` con su slug (el sufijo de las URLs: `tenerife`, `las-palmas`, `madrid`...) o `todas`. El parámetro antiguo `provincia` sigue valiendo como alias.

Habla las dos eras del protocolo: 2026-07-28 (metadatos por petición y `server/discover`) y el handshake `initialize` de 2025-11-25 y anteriores.

### 3. API REST pública con contrato

```
curl "https://primeservices.es/wp-json/ps/v1/buscar_contenido?consulta=nevera+no+enfria"
```

Las mismas cuatro operaciones que las herramientas MCP, en GET. El texto de búsqueda va en el parámetro `consulta`. Contrato OpenAPI 3.1 en https://primeservices.es/openapi.json, índice en https://primeservices.es/api y página en https://primeservices.es/desarrolladores/.

### 4. Índice y datos en crudo

- https://primeservices.es/llms.txt - todas las URLs, agrupadas por ubicación y con su descripción
- https://primeservices.es/sitemap_index.xml - sitemap con fechas de modificación
- https://primeservices.es/wp-json/wp/v2/pages - contenido en JSON

## Cuota y registro

Leer no exige credenciales. Registrarse es opcional y lo único que cambia es cuánto puedes pedir por minuto:

| | Peticiones por minuto | Se cuentan por |
|---|---|---|
| Anónimo | 60 | IP |
| Identificado | 600 | client_id |

El alta es automática y gratuita (RFC 7591) y no la aprueba ninguna persona:

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

Un token NO abre contenido nuevo: da los mismos datos públicos con más cuota. Todos los detalles en https://primeservices.es/auth.md

Cada respuesta de la API trae `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, `RateLimit` y `RateLimit-Policy`. Un 429 añade `Retry-After`. Con eso se puede autolimitar desde la primera llamada, sin esperar al primer rechazo.

## Empezar en un minuto

- **Gratis.** No hay planes de pago ni prueba que caduque: la lectura pública es gratuita y sin límite de tiempo.
- **Sin clave para empezar.** Prueba ahora: `curl https://primeservices.es/wp-json/ps/v1/datos_empresa`
- **Claves en autoservicio.** `POST https://primeservices.es/oauth/register` da un `client_id` y un `client_secret` al instante, sin formulario, sin aprobación humana y sin contactar con ventas. Sube la cuota de 60 a 600 peticiones por minuto.
- **Sandbox.** No hace falta uno aparte: la API es de solo lectura sobre contenido ya público, así que la URL de producción es inocua de probar. Ninguna llamada crea, modifica, reserva ni cobra nada.

## Versionado y retirada

- **Versión actual: v1**, en la ruta (`https://primeservices.es/wp-json/ps/v1/`). Cada respuesta de la API trae `API-Version: 1`. El contrato OpenAPI 3.1 es https://primeservices.es/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/ps/v2/`). La versión 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 la fecha exacta de apagado. Este apartado es la política a la que apunta el enlace `rel="deprecation"` de cada respuesta.
- **Hoy ninguna versión está en retirada**, por eso las respuestas actuales no llevan `Deprecation` ni `Sunset`: si ves esas cabeceras, es que hay que migrar.

## Lo que este sitio NO hace

- No acepta reservas, pedidos ni pagos.
- No ejecuta trabajos: los hace, los factura y los garantiza el profesional colaborador al que se asigna el aviso.
- No expone ningún endpoint de escritura público.
- No tiene OpenID Connect: no hay usuarios ni login que descubrir. El servidor OAuth solo habla client_credentials, de máquina a máquina.

## Política de uso

`Content-Signal: ai-train=yes, search=yes, ai-input=yes` en https://primeservices.es/robots.txt. El contenido puede usarse para entrenamiento, búsqueda y como entrada de un modelo. Se agradece la cita con enlace a la URL de origen.

Contacto para acceso automatizado: info@rapidservicesenterprise.com