ProLevelMax

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

Inicio rápido

Regístrate (los nuevos usuarios reciben $1 en crédito gratuito, uno por persona) y luego conecta la IA que uses:

• Claude.ai, ChatGPT y otras aplicaciones de chat: agrega el conector MCP, inicia sesión y permite el acceso. No se necesita clave API.
• Claude Code, Codex, Cursor y otras IA que puedan ejecutar comandos: crea tu texto de configuración en Comenzar → Configuración de un clic en el panel (contiene esta línea y tu clave API) y envíalo a la IA. Esta lee SKILL.md y completa la configuración.
• Tu propio código: usa la API REST.

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

Habilidad

Para IA que puedan ejecutar comandos o enviar solicitudes HTTP, como Claude Code, Codex y Cursor. En los chats de Claude.ai y ChatGPT, usa el conector MCP en su lugar.

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

Pasa tu clave API junto con ella: API Key: sk_procli_…. Las claves se crean en el panel y se muestran una sola vez.

MCP (OAuth 2.1)

Servidor MCP remoto con OAuth 2.1 y PKCE. Una clave API también funciona como token Bearer.

https://prolevelmax.com/mcp

Confirma en Cursor o VS Code, luego inicia sesión en ProLevelMax y haz clic en Permitir. No se necesita clave API.

Claude.ai / Claude Desktop: Configuración → Conectores → Agregar conector personalizado, luego pega la URL anterior.

ChatGPT (planes web, Plus, Pro, Business, Enterprise y Edu): Configuración → Aplicaciones → Configuración avanzada, activa el modo Desarrollador, crea una aplicación con la URL anterior y elige OAuth.

Claude Code: agrega el servidor y luego ejecuta /mcp dentro de Claude Code para iniciar sesión.

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

Codex: pasa tu clave API a través de una variable de entorno.

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

Cursor, configuración manual con una clave API en lugar de iniciar sesión: Configuración → MCP → Agregar nuevo servidor MCP, con esta configuración:

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

API REST

Autentícate con tu clave API como token Bearer. Las solicitudes y respuestas son JSON. Referencia legible 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	Qué hace
POST /v1/discover	Encuentra fuentes para una solicitud en inglés o chino. Cuerpo: query, limit (1–50)
POST /v1/inspect	Campos de entrada, precio y cotización para una fuente (quote.maxCharge es el máximo que puede costar la ejecución). Cuerpo: scraper, input opcional y maxItems
POST /v1/run	Ejecuta una fuente, cobrada a tu saldo. Cuerpo: scraper, input, maxItems (las fuentes por resultado devuelven hasta 100 a menos que se configure), timeout (segundos, máx. 300), async (true devuelve 202 y un runId de inmediato)
GET /v1/runs	Tus ejecuciones recientes, de más reciente a más antigua. Consulta: limit (1–100, predeterminado 20), offset
GET /v1/runs/:id	Estado, costo y resultados de una ejecución. Consulta: offset, limit (1–1000) para leer los resultados en páginas
GET /v1/runs/:id/download	Descarga los resultados. Consulta: format=csv, xlsx o json (los campos anidados se convierten en columnas a.b)
GET /v1/whoami	Verifica la clave y consulta el saldo

Paginación: las fuentes por llamada devuelven una página por llamada. El objeto de página del resultado lleva el cursor para la siguiente página (cursor, after, max_cursor y similares); pásalo como el campo de paginación que lista inspect.

Programaciones

Ejecuta una fuente automáticamente cada día o cada semana a una hora fija de Pekín, por ejemplo para revisar Xiaohongshu por tu marca cada mañana. Cada ejecución se cobra como una ejecución normal y nunca cuesta más que su runCap; monthlyCap limita opcionalmente un mes calendario. Los resultados aparecen en tu historial de ejecuciones. Una programación se pausa sola y te envía un correo después de 3 ejecuciones fallidas consecutivas o cuando el saldo es demasiado bajo.

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	Qué hace
POST /v1/schedules	Crea una programación. Cuerpo: scraper, input, maxItems, frequency (daily o weekly), weekday (1–7 o lun–dom, solo semanal), time (HH:MM, hora de Pekín), runCap (USD; predeterminado: la cotización de la fuente para esta entrada), monthlyCap (opcional), notifyEmail. Con dryRun: true devuelve una vista previa y no guarda nada
GET /v1/schedules	Tus programaciones: próxima ejecución, última ejecución (runId y estado), gastado este mes, activada o desactivada
GET /v1/schedules/:id	Una programación
PATCH /v1/schedules/:id	Cambia la hora, los límites o el correo, o actívala y desactívala con enabled; volver a activarla elimina una pausa
DELETE /v1/schedules/:id	Elimina una programación; las ejecuciones pasadas se conservan

Herramientas MCP: procli_schedule_create (llámala sin confirmed para una vista previa, luego con confirmed: true una vez que el usuario acepte el costo), procli_schedule_list, procli_schedule_delete. También puedes ver, pausar y eliminar programaciones en la consola bajo Programaciones.

Herramientas

Herramientas disponibles a través de MCP.

procli_discover Encuentra fuentes para una solicitud, en inglés o chino

procli_inspect Campos de entrada, precio y cotización

procli_run Ejecuta una fuente (cobra tu saldo); devuelve una vista previa, el total, el costo, el saldo y enlaces de descarga

procli_runs_get Estado y resultados de la ejecución, en páginas

procli_balance Consulta el saldo actual

procli_schedule_create Programa una ejecución diaria o semanal (muestra el costo; se guarda solo después de que el usuario confirme)

procli_schedule_list Lista programaciones con sus próximas y últimas ejecuciones

procli_schedule_delete Elimina una programación

Facturación

• Dos modos: por llamada (un precio fijo por llamada, una página por llamada) y por resultado (se cobra por filas devueltas, más una tarifa de ejecución y un mínimo por ejecución). El modo de cada plataforma se lista en la página de precios.
• inspect devuelve una cotización (el máximo que puede costar la ejecución) antes de ejecutar. El cargo nunca supera la cotización. Tu IA te dice el precio primero y pregunta antes de cualquier ejecución que pueda costar más de $0.10.
• Las fuentes por resultado devuelven hasta 100 resultados a menos que configures maxItems. El tamaño de la ejecución está limitado por tu saldo; una ejecución reducida lo indica en su resultado. Tu cuenta nunca queda en negativo.
• Las ejecuciones fallidas suelen ser gratuitas. Si parte del trabajo ya se hizo antes del fallo, se aplica un cargo parcial, que nunca supera la cotización de la ejecución.
• Cada cuenta ejecuta hasta 5 trabajos a la vez, en todas sus claves API y conexiones. Los resultados se conservan durante 30 días.
• Reembolsos: dentro de los 30 días posteriores a una recarga, su parte no utilizada puede reembolsarse al método de pago original desde Panel → Facturación → Solicitar un reembolso (las tarifas de procesamiento no se devuelven). Si una ejecución parece cobrada incorrectamente, ábrela y elige "Reportar un problema de facturación". Consulta la política de reembolsos.

Errores

Los errores son JSON: {"code": 402, "type": "insufficient_balance", "message": "…", "requestId": "…"}. type es un identificador estable en el que puedes basarte.

HTTP	type	Significado	Qué hacer
202		Ejecución asíncrona iniciada	Consulta GET /v1/runs/:id con el runId
400	invalid_request	Falta un campo obligatorio o está mal formado	Revisa el cuerpo de la solicitud contra la documentación
401	unauthorized	Falta la clave API o es inválida	Revisa el encabezado Authorization
402	insufficient_balance	Saldo insuficiente	Recarga en el panel
402	spend_limit	La clave API o la aplicación conectada alcanzó su límite de gasto diario o mensual (UTC)	Aumenta el límite en la consola bajo Claves API o Configuración → Aplicaciones conectadas; no se necesita recarga
404	unknown_source · run_not_found · not_found	Fuente o ID de ejecución desconocido, o la publicación o el usuario solicitado no existe	Usa discover para encontrar fuentes válidas, o revisa el ID
405	method_not_allowed	Método HTTP incorrecto	Consulta el encabezado Allow
409	balance_reserved · run_in_progress	Saldo retenido por ejecuciones aún en curso, o la ejecución no ha terminado	Reintenta cuando terminen, o pide menos resultados con maxItems; no se necesita recarga
422	invalid_input	La fuente rechazó la entrada	Corrige la entrada usando los campos de inspect; no reintentes sin cambios
429	too_many_runs · rate_limited	Demasiadas ejecuciones a la vez (5 por cuenta), o la fuente está ocupada	Espera y luego reintenta
502	source_error	Error de la fuente de datos	Reintenta. Generalmente no se cobra; cualquier cargo se mantiene dentro de la cotización
503	unavailable	Fuente temporalmente no disponible	Reintenta más tarde o usa otra fuente

¿Necesitas ayuda?

toph@prolevelmax.com Toph · Fundador

Discord discord.gg/RvSSbYETgd