← MCP de los portales

DOCUMENTACIÓN PÚBLICA · SMITH

20 instaladores de prueba.
Una identidad por cuenta.

Guía para dar de alta perfiles ficticios de España y Portugal y verificar cada uno mediante el MCP de Yokup. El lote está preparado; publicar esta guía no crea las cuentas.

Guía completa y comandos ↗Descargar 20 perfiles JSON ↓Schema MCP ↗
El alta ya está en el MCP: installer_register.

Sin token de titular, tools/list muestra esa herramienta. Campos: name, email, password, country, city, lat/long (o latitude/longitude), radius_km (40 por defecto), skills, language, available, notify_zone, request_key, demo. DEMO: available:false. El radio queda persistido en el perfil. REST POST /api/installer/register con Origin yokup.com sigue siendo válida. El token de flota de Yokup no opera estas cuentas.

El recorrido de Smith

  1. Preparar el lote. Descargar el JSON y generar una contraseña distinta por perfil en un directorio privado. Guardarla antes de enviar el alta para poder recuperar un intento incierto.
  2. Dar de alta cada cuenta. Preferir installer_register en https://data.yokup.com/mcp/installer (pública). Alternativa REST: POST https://data.yokup.com/api/installer/register con Origin: https://www.yokup.com. Comprobar id, available:false y radius_km:40.
  3. Crear acceso MCP de lectura. Con esa sesión, llamar a POST /api/installer/mcp-tokens: permiso installer:read, etiqueta de Smith y caducidad de 7 días. Guardar el token de forma privada.
  4. Verificar el titular. Conectar a https://data.yokup.com/mcp/installer, negociar initialize y consultar tools/list, installer_whoami, installer_profile e installer_inbox.
  5. Entregar resultados. Una tabla de 20 filas con ID confirmado, ciudad, especialidad, estado no disponible y resultado MCP. Indicar cualquier fila pendiente; no entregar credenciales.

La guía completa incluye cuerpos, comandos copiables, manejo de cookies, configuración del cliente, límites y recuperación tras errores.

Un lote claramente ficticio

14 perfiles en España y 6 en Portugal. Madrid, Barcelona, Valencia, Sevilla, Málaga, Murcia, Alicante, Zaragoza, Bilbao, Valladolid, A Coruña, Vigo, Salamanca, Badajoz, Lisboa, Porto, Braga, Coimbra, Évora y Faro.

Todos llevan DEMO en el nombre, correo no entregable @example.invalid y available:false. Las coordenadas son aproximaciones de las ciudades. No representan personas, domicilios ni cobertura real de mantenimiento.

Los perfiles de prueba quedan no disponibles desde el alta.

Así no reciben nuevas incidencias ni pueden aceptarlas. La etiqueta DEMO es visible; no constituye un entorno separado. No activar estos perfiles para atender trabajos reales.

Endpoints y credenciales

ServicioDirecciónCredencial
MCP generalhttps://yokup.com/mcpToken de flota de Smith
MCP altahttps://data.yokup.com/mcp/installer · installer_registerPública; sin token de titular
Alta RESThttps://data.yokup.com/api/installer/registerPerfil y contraseña nuevos; Origin yokup.com
MCP instaladorhttps://data.yokup.com/mcp/installerToken privado ykp_… de cada cuenta

Reintentos sin duplicados

Registro y login comparten un límite de 20 intentos por IP cada 15 minutos. Ante 429, detener el lote y esperar al reinicio. Conservar email, contraseña y resultados por fila; si hay conflicto o timeout, reconciliar la misma cuenta antes de repetir. No cambiar el correo para sortear un error.

Los tokens de este lote solo permiten lectura. La guía explica cómo revocar un token perdido o caducado; revocarlo no elimina la cuenta.