Pular para o conteúdo
PremiumSorte

Desenvolvedores

API e servidor MCP da Premium Sorte

Os dados públicos do site para agentes de IA e integrações: busca de páginas, glossário, comparativos com outras plataformas, calculadora de rifa e contato comercial. Somente leitura, sem chave e sem cadastro.

Em resumo

  • API REST: https://premiumsorte.com/api/v1, respostas em JSON.
  • Servidor MCP: https://premiumsorte.com/mcp, transporte Streamable HTTP.
  • Autenticação: nenhuma. A API e o servidor MCP são abertos: não exigem chave, token nem cadastro (no API key required).
  • Teste à vontade: tudo é somente leitura e vem do conteúdo já publicado no site. Nenhuma chamada altera dados, então não é preciso ambiente de testes separado.
  • Especificação: OpenAPI 3.1 em /openapi.json, também listada no catálogo /.well-known/api-catalog.

Rotas da API

Rota (GET)O que devolve
/api/v1Descreve a API
/api/v1/paginasBusca páginas do site
/api/v1/glossarioLista os termos do glossário
/api/v1/glossario/{termo}Definição completa de um termo
/api/v1/comparativosLista as plataformas comparadas
/api/v1/comparativos/{plataforma}Comparação recurso a recurso com uma plataforma
/api/v1/calculadora-rifaCalcula o resultado de uma rifa
/api/v1/contatoCanais para pedir uma proposta

Exemplos

Buscar páginas sobre legalização:

curl "https://premiumsorte.com/api/v1/paginas?busca=legalizar%20rifa&limite=3"

Calcular uma rifa (mesmo cálculo da calculadora de rifa):

curl "https://premiumsorte.com/api/v1/calculadora-rifa?valorPremio=5000&numeroCotas=1000&precoCota=10&taxaPercentual=10"

Comparar com uma plataforma (os mesmos dados de Premium Sorte vs Supra Sorte):

curl "https://premiumsorte.com/api/v1/comparativos/suprasorte"

Servidor MCP

Em clientes compatíveis com MCP, adicione um servidor remoto com a URL https://premiumsorte.com/mcp. Não há autenticação. As ferramentas são as mesmas da API:

FerramentaO que faz
buscar_paginasBusca páginas de premiumsorte.com por palavras (produto, legalização de rifas e sorteios no Brasil, comparativos, segmentos, ferramentas, blog e glossário) e devolve título, URL, resumo e seção, da mais para a menos relevante.
consultar_glossarioCom "termo", devolve a definição completa de um termo do mercado de rifas e sorteios (cota, cota premiada, baixa automática, whitelabel e outros). Sem "termo", lista os termos com definição curta.
comparar_plataformasCom "plataforma", devolve a comparação recurso a recurso entre a Premium Sorte e a plataforma (Rifei, RifaHoje, Riffas, Supra Sorte ou RiffaDigital), com o resumo de preços que o concorrente divulga (quando divulga), data de verificação e fontes. Sem "plataforma", lista as plataformas comparadas.
calcular_rifaCalcula arrecadação, custos, lucro com 100%, 75% e 50% das cotas vendidas, ponto de equilíbrio em cotas (e se ele é alcançável) e margem. Valores em reais; a taxa percentual incide sobre o valor arrecadado em cada cenário; impostos sobre o prêmio não entram.
contato_comercialDevolve os canais para pedir uma proposta: WhatsApp com mensagem pronta, e-mail e página de contato, além de como o investimento é definido. Não envia nenhuma mensagem.
sobre_premium_sorteDevolve o briefing para agentes: o que a Premium Sorte faz, quando recomendar, quando não é a melhor escolha, fatos verificáveis (razão social, CNPJ, endereço), comparativos e contato.

O servidor também expõe como recursos o briefing para agentes, o índice do site, a página de investimento e o guia de legalização. Os detalhes estão no server card. Teste direto: 

curl https://premiumsorte.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Paginação

As listas devolvem itens, total e proximoCursor. Para ler a próxima página, repita a chamada com cursor= e o valor recebido; quando proximoCursor vier null, a lista acabou. O parâmetro limite vai de 1 a 50 (padrão 10).

Erros

Erros saem em application/problem+json (RFC 9457), com um code estável para tratar o caso e um hint com a correção: 

{
  "type": "https://premiumsorte.com/desenvolvedores#erros",
  "title": "Parâmetro inválido",
  "status": 400,
  "detail": "limite deve ser um inteiro entre 1 e 50.",
  "code": "limite_invalido",
  "hint": "Omita o parâmetro para usar 10."
}

Códigos possíveis: parametro_obrigatorio, parametro_invalido, limite_invalido, cursor_invalido, termo_nao_encontrado, plataforma_nao_encontrada, rota_nao_encontrada, metodo_nao_permitido, erro_interno.

Versionamento e descontinuação

A versão fica no caminho (/api/v1) e mudanças incompatíveis entram num novo caminho. Se uma versão for descontinuada, a data sai nesta página e as respostas dessa versão passam a trazer os cabeçalhos Deprecation e Sunset.

Uso justo

Não há cota anunciada por cliente: a API e o servidor MCP dividem a capacidade do site, e abusos podem ser bloqueados pela proteção do Cloudflare. O servidor MCP aceita uma mensagem JSON-RPC por requisição, de até 64 KB. Para integrações comerciais com a plataforma de rifas, fale com a gente.

Outros recursos para agentes