Acceso anticipado

Para agentes de IA

Cómo se conectará un agente. Todavía no está abierto: se accede por la lista de espera.

Versión en texto: /llms-full.txt · Especificación: /openapi.json · Lista de espera

Estado: acceso anticipado

La API REST y el servidor MCP de SignalDesk están en acceso anticipado. Todavía no están abiertas ni cobran: lo que ves abajo es el diseño previsto y puede cambiar.

Para acceder cuando abran, apúntate a la lista de espera en la página principal o con POST /api/public/waitlist (único endpoint que funciona hoy).

Autenticación y créditos

Cada petición llevará una clave de API en la cabecera Authorization: Bearer <clave>. La clave pertenece a una cuenta verificada.

Cada cuenta tiene un saldo en créditos prepagados (USD). Cada señal entregada o ficha consultada descuenta su precio del saldo.

Si no hay saldo suficiente, la API responderá 402 Payment Required con un enlace de recarga (top_up_url) para que el agente o su responsable recargue y reintente.

Respuesta 402 (ejemplo)
{
  "error": "payment_required",
  "message": "Saldo insuficiente.",
  "balance_usd": 0.2,
  "required_usd": 0.5,
  "top_up_url": "https://signaldesk.lat/recarga/ejemplo"
}

search_signals

Busca señales de compra de empresas B2B. Se cobra por señal entregada.

Parámetros previstos: country (código ISO 3166-1 de 2 letras), sector (texto), signal_type (texto, opcional), limit (1 a 50, por defecto 10).

Los valores de las respuestas son de ejemplo; no son datos reales.

Petición
POST https://signaldesk.lat/api/v1/signals/search
Authorization: Bearer <clave>
Content-Type: application/json

{
  "country": "ES",
  "sector": "logística",
  "limit": 2
}
Respuesta 200 (ejemplo)
{
  "signals": [
    {
      "id": "sig_ejemplo_1",
      "company_id": "cmp_ejemplo_1",
      "type": "ejemplo",
      "summary": "Texto de ejemplo.",
      "detected_at": "2026-01-01T00:00:00Z"
    }
  ],
  "charged_usd": 0.5,
  "balance_usd": 4.5
}

get_company

Devuelve la ficha de una empresa a partir de su identificador. Se cobra por ficha.

Petición
GET https://signaldesk.lat/api/v1/companies/cmp_ejemplo_1
Authorization: Bearer <clave>
Respuesta 200 (ejemplo)
{
  "id": "cmp_ejemplo_1",
  "name": "Empresa Ejemplo",
  "country": "ES",
  "website": "https://ejemplo.example",
  "sector": "logística",
  "charged_usd": 2,
  "balance_usd": 2.5
}

get_balance

Consulta el saldo de créditos de la cuenta. No tiene coste.

Petición
GET https://signaldesk.lat/api/v1/balance
Authorization: Bearer <clave>
Respuesta 200 (ejemplo)
{
  "balance_usd": 4.5,
  "currency": "USD"
}

top_up

Crea un enlace de pago de Mercado Pago para recargar créditos. El saldo se acredita cuando el pago se confirma.

Petición
POST https://signaldesk.lat/api/v1/balance/top-up
Authorization: Bearer <clave>
Content-Type: application/json

{
  "amount_usd": 20
}
Respuesta 201 (ejemplo)
{
  "top_up_url": "https://signaldesk.lat/recarga/ejemplo",
  "amount_usd": 20,
  "provider": "mercadopago"
}

Servidor MCP

El servidor MCP expondrá las mismas cuatro herramientas (search_signals, get_company, get_balance, top_up) con la misma clave y el mismo saldo. Está en acceso anticipado y aún no tiene URL pública.