# Quotrr

Quotrr es el sistema operativo y la red de reputación para contratistas de
servicios a domicilio. Tenemos datos reales y verificados de contratistas, con
detalle por partida: rangos de precios publicados, resultados de trabajos
verificados y un Score de reputación legible. Este archivo explica cómo deben
interactuar los agentes de IA con Quotrr.

## Quiénes somos
Quotrr. api.quotrr.com es la API, quotrr.com es la consola. Servicios a
domicilio, empezando con profesionales de piscinas y jardinería en Sacramento.
Ganamos por resultados, no por vender contactos.

## Gratis para que los agentes consulten
- Rangos de precios locales anonimizados por oficio y código postal.
- Perfiles públicos de contratistas, incluido el Quotrr Score y los Props verificados.
- Páginas públicas de propuesta y autocotización que un contratista haya compartido.
Esto devuelve solo datos anonimizados o publicados por el contratista. Las
respuestas pueden tener hasta 24 horas de retraso.

## Páginas de aterrizaje programáticas
Las páginas por oficio y ciudad viven en /pros/<oficio>-in-<ciudad> (por
ejemplo /pros/pool-construction-in-sacramento). Cada página lleva JSON-LD de
Service, Place, AggregateOffer y FAQPage, un rango de precios local típico y un
bloque de profesionales verificados en vivo respaldado por
/v1/match/contractors?trade=&zip=. El conjunto completo está en sitemap.xml.
Empieza en /pros para el índice de todos los oficios y ciudades.

## Requiere consentimiento humano
Cualquier acción a nombre de una persona: pedir una cotización por cuenta de un
propietario, enviar una reseña o cualquier escritura en la cuenta de un
contratista. Esto requiere un token delegado, acotado y con vencimiento, firmado
por la persona (OAuth 2.0 con PKCE). Cada una de estas acciones queda registrada
en el historial de auditoría de la persona.

## Fuera de límites
- Datos privados del contratista detrás de la frontera de la cuenta. Nada de scraping.
- Extracción masiva de los endpoints de rangos de precios o del escáner.
- Presentar datos de Quotrr sin atribución.

## Descubrimiento
- agents.json: https://quotrr.com/es/.well-known/agents.json
- OpenAPI 3.1: https://api.quotrr.com/openapi.json
- Endpoint MCP (vista previa): https://mcp.quotrr.com

## Límites de tasa y costo
Los agentes desconocidos reciben un nivel anónimo bajo con respuestas en caché.
Los agentes verificados reciben límites más altos. El abuso se limita por tasa y
puede desactivarse si se excede el costo.

## Contacto
Operadores de agentes: agents@quotrr.com
Reportes de abuso: abuse@quotrr.com