Saka

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

Descoberta de negócios, com evidências

Portal do desenvolvedor Saka

DesenvolvedoresDocumentação da APIAutenticaçãoSandboxCLISobreContato

Quando usar o Saka

Use o Saka para descobrir negócios por localização e setor, visualizar empresas correspondentes e obter registros comerciais estruturados com atribuição de fonte para pesquisa e fluxos de trabalho downstream. A cobertura e os campos disponíveis variam. O Saka verifica continuamente e-mails coletados usando DNS e SMTP, distinguindo resultados aceitos, rejeitados, catch-all, desconhecidos e inválidos. E-mails comprados atualmente incluem observações de fonte, sem resultados de aceitação de caixa de correio ou permissão para contatar alguém. Mantenha os avisos de fonte retornados com seus dados.

Onboarding self-service e prévias gratuitas

Crie uma conta ou entre para visualizar negócios correspondentes e solicitar cotações gratuitas. Nenhum pagamento é necessário para uma cotação. Compras gastam crédito pré-pago e exigem um custo máximo explícito. Recargas são de $10, $25, $100, $500, $1.000 ou $2.500; registros básicos custam $2 por mil e registros com e-mail custam $5 por mil. Revise a cotação exata antes de comprar.

Autenticação e chaves de API

O Saka usa fluxo de código de autorização OAuth 2.0 com PKCE por meio do WorkOS Connect. Conecte um cliente MCP a https://saka.run/api/mcp e conclua o fluxo de login. Envie o token de acesso resultante como Authorization: Bearer TOKEN para chamadas REST. Não há endpoint separado para emissão de chaves de API. O proprietário da conta pode desativar o acesso de agentes conectados na página da conta.

Metadados de recurso protegido OAuth identificam o servidor de autorização. Solicite o recurso exato https://saka.run/api/mcp. Mantenha os tokens privados e nunca os incorpore em URLs ou código-fonte.

Início rápido REST

A especificação OpenAPI 3.1 descreve esquemas de solicitação, filtros, respostas, autenticação e erros. Solicite primeiro uma cotação sem cobrança:

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"]}}'

Use POST /api/data/purchase com o quote_id retornado, um max_cost_micro autorizado e um idempotency_key estável. Preserve a solicitação idêntica ao repetir uma compra. Um dólar americano equivale a 1.000.000 de microUSD. Baixe um recibo de compra com GET /api/data/export?receipt_id=.... Leia seu saldo com GET /api/account.

Ferramentas MCP

O conector de compra em /api/mcp expõe saka_quote, saka_purchase e saka_balance. O conector somente leitura da biblioteca de compras em /api/library/mcp permite que agentes recuperem compras existentes sem fazer novas compras. Sempre obtenha a autorização de gastos do usuário antes de comprar registros.

Sandbox e CLI

Comece com o sandbox público para desenvolvedores: sem login, credenciais ou cobranças, com registros fictícios e respostas não compráveis. O modelo de registro fornece um exemplo de esquema com valores nulos. Cotações de produção gratuitas exercitam a descoberta autenticada sem gastar.

Instale a CLI oficial de dados comerciais Saka a partir do arquivo de lançamento público para prévias em sandbox, cotações reais, saldo e exportações existentes. Esta instalação não precisa de acesso privado à fonte. A publicação no registro npm está pendente de acesso do editor. Testes avançados de integração auto-hospedados são descritos na receita de sandbox do operador, que requer acesso à fonte e credenciais do provedor de teste.

Versionamento e descontinuação da API

O contrato REST atual é a versão 1. Envie Saka-API-Version: 1; omiti-lo seleciona a versão 1 para clientes existentes. Versões não suportadas recebem uma resposta 400 estruturada. Campos aditivos podem aparecer dentro de uma versão. Mudanças que quebram compatibilidade exigem uma nova versão. Antes de descontinuar a versão 1, o Saka publicará orientações de migração aqui e fornecerá pelo menos 90 dias de aviso, com cabeçalhos de resposta padrão Deprecation e Sunset nos endpoints afetados.

Erros e limites de taxa

Erros REST mantêm um código error estável, com um message legível por humanos e uma dica resolution. Autentique após um 401, corrija entrada inválida após um 400 e preserve a idempotência de compra em repetições. Solicitações de dados de clientes usam um token bucket com rajada de 10 e recarga de uma solicitação por segundo por conta. Solicitações da biblioteca de compras têm um bucket separado. RateLimit-Policy e RateLimit descrevem a política e a cota restante atual. Um 429 inclui Retry-After; aguarde antes de repetir.