Saka

npx add-mcp 'https://saka.run/api/mcp'

Descubrimiento de negocios, con evidencia

Portal para desarrolladores de Saka

DesarrolladoresDocumentación de APIAutenticaciónSandboxCLIAcerca deContacto

Cuándo usar Saka

Usa Saka para descubrir negocios por ubicación e industria, previsualizar empresas coincidentes y obtener registros comerciales estructurados con atribución de fuente para investigación y flujos de trabajo posteriores. La cobertura y los campos disponibles varían. Saka verifica continuamente los correos electrónicos recopilados mediante DNS y SMTP, distinguiendo resultados aceptados, rechazados, de captura total, desconocidos e inválidos. Los correos electrónicos comprados actualmente incluyen observaciones de fuente, sin resultados de aceptación de buzón ni permiso para contactar a alguien. Conserva los avisos de fuente devueltos junto con tus datos.

Incorporación autoservicio y vistas previas gratuitas

Crea una cuenta o inicia sesión para previsualizar negocios coincidentes y solicitar cotizaciones gratuitas. No se requiere pago para una cotización. Las compras gastan crédito prepagado y requieren un costo máximo explícito. Las recargas son de $10, $25, $100, $500, $1,000 o $2,500; los registros básicos cuestan $2 por millar y los registros con correo electrónico cuestan $5 por millar. Revisa la cotización exacta antes de comprar.

Autenticación y claves de API

Saka utiliza el flujo de código de autorización OAuth 2.0 con PKCE a través de WorkOS Connect. Conecta un cliente MCP a https://saka.run/api/mcp y completa el flujo de inicio de sesión. Envía el token de acceso resultante como Authorization: Bearer TOKEN para llamadas REST. No existe un endpoint separado para emitir claves de API. El propietario de la cuenta puede deshabilitar el acceso de agentes conectados en la página de la cuenta.

Metadatos de recursos protegidos OAuth identifican el servidor de autorización. Solicita el recurso exacto https://saka.run/api/mcp. Mantén los tokens privados y nunca los incrustes en URLs o código fuente.

Inicio rápido REST

La especificación OpenAPI 3.1 describe esquemas de solicitud, filtros, respuestas, autenticación y errores. Solicita primero una cotización sin cargo:

curl https://saka.run/api/data/quote \
  -H "Authorization: Bearer $SAKA_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Saka-API-Version: 1' \
  --data '{"kind":"basic","limit":5,"filters":{"country":["US"],"category":["Plumbing"]}}'

Usa POST /api/data/purchase con el quote_id devuelto, un max_cost_micro autorizado y un idempotency_key estable. Conserva la solicitud idéntica al reintentar una compra. Un dólar estadounidense equivale a 1,000,000 de microUSD. Descarga un recibo de compra con GET /api/data/export?receipt_id=.... Lee tu saldo con GET /api/account.

Herramientas MCP

El conector de compra en /api/mcp expone saka_quote, saka_purchase y saka_balance. El conector de biblioteca de compras de solo lectura en /api/library/mcp permite a los agentes recuperar compras existentes sin realizar nuevas compras. Siempre obtén la autorización de gasto del usuario antes de comprar registros.

Sandbox y CLI

Comienza con el sandbox público para desarrolladores: sin inicio de sesión, credenciales ni cargos, con registros ficticios y respuestas no comprables. La plantilla de registro proporciona un ejemplo de esquema con valores nulos. Las cotizaciones gratuitas de producción ejercitan el descubrimiento autenticado sin gastar.

Instala la CLI oficial de datos comerciales de Saka desde su archivo de lanzamiento público para vistas previas en sandbox, cotizaciones reales, saldo y exportaciones existentes. Esta instalación no necesita acceso privado a la fuente. La publicación en el registro npm está pendiente de acceso del publicador. Las pruebas avanzadas de integración autohospedadas se describen en la receta de sandbox para operadores, que requiere acceso a la fuente y credenciales del proveedor de pruebas.

Versionado y desaprobación de API

El contrato REST actual es la versión 1. Envía Saka-API-Version: 1; omitirlo selecciona la versión 1 para clientes existentes. Las versiones no compatibles reciben una respuesta 400 estructurada. Pueden aparecer campos aditivos dentro de una versión. Los cambios disruptivos requieren una nueva versión. Antes de retirar la versión 1, Saka publicará aquí una guía de migración y proporcionará al menos 90 días de aviso, con los encabezados de respuesta estándar Deprecation y Sunset en los endpoints afectados.

Errores y límites de velocidad

Los errores REST conservan un código error estable, con un message legible por humanos y una pista resolution. Autentícate después de un 401, corrige la entrada inválida después de un 400 y preserva la idempotencia de compra en los reintentos. Las solicitudes de datos de clientes usan un cubo de tokens con una ráfaga de 10 y una recarga de una solicitud por segundo por cuenta. Las solicitudes de biblioteca de compras tienen un cubo separado. RateLimit-Policy y RateLimit describen la política y la cuota restante actual. Un 429 incluye Retry-After; espera antes de reintentar.