ProLevelMax

npx add-mcp 'https://prolevelmax.com/mcp'

Início rápido

Cadastre-se (novos usuários ganham $1 em crédito gratuito, um por pessoa) e conecte a IA que você usa:

• Claude.ai, ChatGPT e outros aplicativos de chat: adicione o conector MCP, faça login e permita. Nenhuma chave de API necessária.
• Claude Code, Codex, Cursor e outras IAs que podem executar comandos: crie seu texto de configuração em Comece aqui → Configuração em um clique no painel (ele contém esta linha e sua chave de API) e envie para a IA. Ela lê SKILL.md e conclui a configuração.
• Seu próprio código: use a API REST.

set up https://prolevelmax.com/SKILL.md

Skill

Para IAs que podem executar comandos ou enviar solicitações HTTP, como Claude Code, Codex e Cursor. Em conversas do Claude.ai e ChatGPT, use o conector MCP.

set up https://prolevelmax.com/SKILL.md

Envie sua chave de API junto: API Key: sk_procli_…. As chaves são criadas no painel e exibidas apenas uma vez.

MCP (OAuth 2.1)

Servidor MCP remoto com OAuth 2.1 e PKCE. Uma chave de API também funciona como token Bearer.

https://prolevelmax.com/mcp

Confirme no Cursor ou VS Code, depois entre no ProLevelMax e clique em Permitir. Nenhuma chave de API necessária.

Claude.ai / Claude Desktop: Configurações → Conectores → Adicionar conector personalizado e cole a URL acima.

ChatGPT (planos web, Plus, Pro, Business, Enterprise e Edu): Configurações → Apps → Configurações avançadas, ative o modo Desenvolvedor, crie um app com a URL acima e escolha OAuth.

Claude Code: adicione o servidor e execute /mcp dentro do Claude Code para entrar.

claude mcp add --scope user --transport http prolevelmax https://prolevelmax.com/mcp

Codex: passe sua chave de API por uma variável de ambiente.

export PLM_API_KEY=sk_procli_... codex mcp add prolevelmax --url https://prolevelmax.com/mcp --bearer-token-env-var PLM_API_KEY

Cursor, configuração manual com chave de API em vez de login: Configurações → MCP → Adicionar novo servidor MCP, com esta configuração:

{ "mcpServers": { "prolevelmax": { "url": "https://prolevelmax.com/mcp", "headers": { "Authorization": "Bearer sk_procli_..." } } } }

API REST

Autentique com sua chave de API como token Bearer. Solicitações e respostas são JSON. Referência legível por máquina: openapi.json (OpenAPI 3.1).

curl https://prolevelmax.com/v1/discover \ -H "Authorization: Bearer sk_procli_..." \ -H "Content-Type: application/json" \ -d '{"query":"reddit comments"}' curl https://prolevelmax.com/v1/inspect \ -H "Authorization: Bearer sk_procli_..." \ -H "Content-Type: application/json" \ -d '{"scraper":"procli_reddit_b"}' curl https://prolevelmax.com/v1/run \ -H "Authorization: Bearer sk_procli_..." \ -H "Content-Type: application/json" \ -d '{"scraper":"procli_reddit_b","input":{"post_id":"t3_1abcde"}}' curl -o results.csv "https://prolevelmax.com/v1/runs/RUN\_ID/download?format=csv" \ -H "Authorization: Bearer sk_procli_..."

Endpoint	O que faz
POST /v1/discover	Encontra fontes para uma solicitação em inglês ou chinês. Corpo: query, limit (1–50)
POST /v1/inspect	Campos de entrada, preço e cotação para uma fonte (quote.maxCharge é o máximo que a execução pode custar). Corpo: scraper, input opcional e maxItems
POST /v1/run	Executa uma fonte, cobrada do seu saldo. Corpo: scraper, input, maxItems (fontes por resultado retornam até 100, salvo definido), timeout (segundos, máx. 300), async (true retorna 202 e um runId imediatamente)
GET /v1/runs	Suas execuções recentes, mais novas primeiro. Consulta: limit (1–100, padrão 20), offset
GET /v1/runs/:id	Status, custo e resultados de uma execução. Consulta: offset, limit (1–1000) para ler os resultados em páginas
GET /v1/runs/:id/download	Baixa os resultados. Consulta: format=csv, xlsx ou json (campos aninhados viram colunas a.b)
GET /v1/whoami	Verifica a chave e consulta o saldo

Paginação: fontes por chamada retornam uma página por chamada. O objeto page do resultado carrega o cursor para a próxima página (cursor, after, max_cursor e similares); passe-o como o campo paging listado por inspect.

Agendamentos

Execute uma fonte automaticamente todos os dias ou toda semana em um horário definido de Pequim, por exemplo, para verificar o Xiaohongshu da sua marca toda manhã. Cada execução é cobrada como uma execução normal e nunca custa mais que seu runCap; monthlyCap limita opcionalmente um mês calendário. Os resultados aparecem no seu histórico de execuções. Um agendamento pausa a si mesmo e envia um e-mail após 3 execuções falhas consecutivas ou quando o saldo está muito baixo.

curl https://prolevelmax.com/v1/schedules \ -H "Authorization: Bearer sk_procli_..." \ -H "Content-Type: application/json" \ -d '{"scraper":"procli_xiaohongshu_b","input":{"keyword":"your brand"}, "frequency":"daily","time":"09:00","runCap":0.05,"notifyEmail":true}'

Endpoint	O que faz
POST /v1/schedules	Cria um agendamento. Corpo: scraper, input, maxItems, frequency (daily ou weekly), weekday (1–7 ou mon–sun, apenas semanal), time (HH:MM, horário de Pequim), runCap (USD; padrão: a cotação da fonte para esta entrada), monthlyCap (opcional), notifyEmail. Com dryRun: true retorna uma prévia e não salva nada
GET /v1/schedules	Seus agendamentos: próxima execução, última execução (runId e status), gasto neste mês, ativo ou inativo
GET /v1/schedules/:id	Um agendamento
PATCH /v1/schedules/:id	Altera o horário, limites ou e-mail, ou ativa/desativa com enabled; reativar limpa uma pausa
DELETE /v1/schedules/:id	Exclui um agendamento; execuções passadas são mantidas

Ferramentas MCP: procli_schedule_create (chame sem confirmed para uma prévia, depois com confirmed: true quando o usuário concordar com o custo), procli_schedule_list, procli_schedule_delete. Você também pode ver, pausar e excluir agendamentos no console em Agendamentos.

Ferramentas

Ferramentas disponíveis via MCP.

procli_discover Encontra fontes para uma solicitação, em inglês ou chinês

procli_inspect Campos de entrada, preço e cotação

procli_run Executa uma fonte (cobra do seu saldo); retorna uma prévia, o total, o custo, o saldo e links de download

procli_runs_get Status e resultados da execução, em páginas

procli_balance Verifica o saldo atual

procli_schedule_create Agenda uma execução diária ou semanal (prévia do custo; salva apenas após o usuário confirmar)

procli_schedule_list Lista agendamentos com suas próximas e últimas execuções

procli_schedule_delete Exclui um agendamento

Cobrança

• Dois modos: por chamada (preço fixo por chamada, uma página por chamada) e por resultado (cobrado por linhas retornadas, mais uma taxa de execução e um mínimo por execução). O modo de cada plataforma está listado na página de preços.
• inspect retorna uma cotação (o máximo que a execução pode custar) antes da execução. A cobrança nunca excede a cotação. Sua IA informa o preço primeiro e pergunta antes de qualquer execução que possa custar mais de $0,10.
• Fontes por resultado retornam até 100 resultados, salvo se você definir maxItems. O tamanho da execução é limitado pelo seu saldo; uma execução reduzida informa isso no resultado. Sua conta nunca fica negativa.
• Execuções com falha geralmente são gratuitas. Se parte do trabalho já foi feita antes da falha, uma cobrança parcial é aplicada, nunca mais que a cotação da execução.
• Cada conta executa até 5 trabalhos por vez, em todas as suas chaves de API e conexões. Os resultados são mantidos por 30 dias.
• Reembolsos: dentro de 30 dias de uma recarga, a parte não utilizada pode ser reembolsada ao método de pagamento original em Painel → Cobrança → Solicitar reembolso (taxas de processamento não são devolvidas). Se uma execução parecer cobrada incorretamente, abra-a e escolha "Reportar problema de cobrança". Veja a política de reembolso.

Erros

Erros são JSON: {"code": 402, "type": "insufficient_balance", "message": "…", "requestId": "…"}. type é um identificador estável no qual você pode ramificar.

HTTP	type	Significado	O que fazer
202		Execução assíncrona iniciada	Consulte GET /v1/runs/:id com o runId
400	invalid_request	Um campo obrigatório está ausente ou malformado	Verifique o corpo da solicitação na documentação
401	unauthorized	Chave de API ausente ou inválida	Verifique o cabeçalho Authorization
402	insufficient_balance	Saldo insuficiente	Recarregue no painel
402	spend_limit	A chave de API ou o app conectado atingiu o limite de gastos diário ou mensal (UTC)	Aumente o limite no console em Chaves de API ou Configurações → Apps conectados; nenhuma recarga necessária
404	unknown_source · run_not_found · not_found	Fonte ou ID de execução desconhecido, ou o post ou usuário solicitado não existe	Use discover para encontrar fontes válidas ou verifique o ID
405	method_not_allowed	Método HTTP errado	Veja o cabeçalho Allow
409	balance_reserved · run_in_progress	Saldo retido por execuções ainda em andamento, ou a execução não terminou	Tente novamente quando terminarem, ou peça menos resultados com maxItems; nenhuma recarga necessária
422	invalid_input	A fonte rejeitou a entrada	Corrija a entrada usando os campos de inspect; não tente novamente sem alterações
429	too_many_runs · rate_limited	Muitas execuções ao mesmo tempo (5 por conta), ou a fonte está ocupada	Aguarde e tente novamente
502	source_error	Erro na fonte de dados	Tente novamente. Geralmente não é cobrado; qualquer cobrança permanece dentro da cotação
503	unavailable	Fonte temporariamente indisponível	Tente novamente mais tarde ou use outra fonte

Precisa de ajuda?

toph@prolevelmax.com Toph · Fundador

Discord discord.gg/RvSSbYETgd