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.
{
"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.
POST https://signaldesk.lat/api/v1/signals/search
Authorization: Bearer <clave>
Content-Type: application/json
{
"country": "ES",
"sector": "logística",
"limit": 2
}{
"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.
GET https://signaldesk.lat/api/v1/companies/cmp_ejemplo_1
Authorization: Bearer <clave>{
"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.
GET https://signaldesk.lat/api/v1/balance
Authorization: Bearer <clave>{
"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.
POST https://signaldesk.lat/api/v1/balance/top-up
Authorization: Bearer <clave>
Content-Type: application/json
{
"amount_usd": 20
}{
"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.