Saltar al contenido
Cómo usar Capium Browser

Instálalo, autentícate y contrólalo.

Capium Browser es nuestro Chrome sigiloso propietario, con licencia por sesión y que se instala con un solo comando. Añade tu clave de licencia y contrólalo localmente con la API de Playwright que ya conoces.

Contrólalo como Playwright

Navega, haz clic, escribe, espera selectores y red. La API estándar de Playwright funciona sin cambios.

Chrome sigiloso real

Un núcleo de Chrome auténtico y siempre actualizado, reforzado contra la detección de bots, no un stub headless ni un wrapper parcheado.

Capturas y PDFs

Captura pantallazos de página completa o convierte cualquier página a PDF, igual que con un navegador local.

Sesiones simultáneas

Ejecuta varios navegadores a la vez. Cada navegador activo cuenta como una sesión frente al tope de tu plan.

1. Primeros pasos

Instala el toolkit para tu lenguaje. No hay nada que autoalojar ni que parchear. El binario sigiloso se descarga en la primera ejecución y se mantiene actualizado automáticamente.

install.sh
# Python
pip install capiumbrowser
python -m playwright install-deps   # Chromium's OS libraries (once)

# JavaScript / TypeScript
npm install capiumbrowser

Añade tu clave de licencia y controla tu primera página. Activa humanize=True para tener entrada y tiempos similares a los humanos.

first_run.py
from capiumbrowser import launch_context

# Your license key is on the dashboard: Dashboard -> Capium Browser.
# Export it once:  export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# launch_context returns (browser, context, page); the always-latest
# stealth binary is downloaded on first run.
browser, ctx, page = launch_context(
    seed=200123,        # one seed = one coherent device
    humanize=True,      # human-like input + timing
    url="https://example.com",
)
print(page.title())
browser.close()

2. Autenticación

Tu clave de licencia está en el panel, en Capium Browser. Ahí puedes mostrarla, copiarla o volver a emitirla. Mantenla en secreto y cárgala desde el entorno en lugar de escribirla en el código.

auth.py
# Keep the key out of source. Export it in your shell or CI:
#   export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# The SDK reads it from the environment (or ~/.capium/license)
# automatically — nothing to pass in code.
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123)
  • Vuelve a emitir la clave desde el panel si alguna vez queda expuesta. La clave anterior deja de funcionar de inmediato.
  • Una licencia activa por cuenta. Los niveles superiores aumentan cuántas sesiones se ejecutan a la vez.
  • La clave autoriza el binario; no se requiere un inicio de sesión ni una cookie aparte.

3. Control con Playwright (Python)

Todo lo que sabes de Playwright funciona: locators, esperas, intercepción de red y más. Capium simplemente lo sustituye por un núcleo de Chrome real y reforzado.

playwright.py
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123, humanize=True)

page.goto("https://example.com/login")
page.fill("#email", "[email protected]")
page.fill("#password", "hunter2")
page.click("button[type=submit]")
page.wait_for_url("**/dashboard")

# The Playwright API you already know: locators, waits, network, etc.
print(page.locator("h1").inner_text())
browser.close()

4. API asíncrona

La API asíncrona replica la síncrona: launch_context_async devuelve el mismo trío (browser, context, page) con métodos de Playwright awaitables.

async_run.py
import asyncio
from capiumbrowser import launch_context_async

async def main():
    browser, ctx, page = await launch_context_async(
        seed=200123, humanize=True, url="https://example.com",
    )
    print(await page.title())
    await browser.close()

asyncio.run(main())

5. Modo humanize

Pasar humanize=True al lanzar añade entrada y tiempos similares a los humanos: movimiento natural del ratón, ritmo de escritura realista y pequeñas pausas variables, además de los helpers page.human_type y page.human_scroll. Déjalo activado en flujos interactivos; desactívalo en fetch-and-parse puro donde importe la velocidad.

humanize.py
browser, ctx, page = launch_context(seed=200123, humanize=True)

page.human_type("#email", "[email protected]")   # natural typing cadence
page.human_scroll(1200)                          # smooth, variable scrolling

6. Sesiones y concurrencia

Cada navegador activo es una sesión. El tope de sesiones de tu plan es cuántas puedes ejecutar al mismo tiempo. Cierra el navegador cuando termines para liberar la sesión.

concurrent.py
import concurrent.futures
from capiumbrowser import launch_context

def fetch(url, seed):
    browser, ctx, page = launch_context(seed=seed, url=url)
    title = page.title()
    browser.close()
    return title

# Each live browser counts as one session against your plan's cap.
urls = ["https://a.example", "https://b.example", "https://c.example"]
seeds = range(200001, 200001 + len(urls))   # one coherent device per worker
with concurrent.futures.ThreadPoolExecutor(max_workers=3) as pool:
    print(list(pool.map(fetch, urls, seeds)))

7. Recetas: capturas y PDFs

capture.py
page.goto("https://example.com")

# Full-page screenshot
page.screenshot(path="shot.png", full_page=True)

# Render the page to a PDF
page.pdf(path="page.pdf", format="A4")

8. Plataformas y CI

Se distribuyen binarios nativos para Linux, Windows y macOS, con el mismo comportamiento en tu portátil, en un runner de CI y en tu flota. En CI, define la clave de licencia como variable de entorno secreta:

ci.yml
# GitHub Actions / GitLab CI
env:
  CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}

9. Solución de problemas

Licencia no válida o caducada

Confirma que la clave coincide con la del panel y que tu licencia (o prueba) sigue activa. Vuelve a emitir la clave si hace falta.

Límite de sesiones alcanzado

Tienes tantos navegadores activos como permite tu plan. Cierra los navegadores que hayan terminado o mejora tu plan para tener un tope de sesiones mayor.

El binario no se descarga

El binario se descarga en la primera ejecución; permite HTTPS saliente. En CI restringidos, guarda el toolkit en caché entre ejecuciones.

10. Preguntas frecuentes

¿Dónde está mi clave de licencia?›

En el panel, en Capium Browser. Ahí puedes mostrarla, copiarla o volver a emitirla. Mantenla en secreto; trátala como una contraseña.

¿Tengo que descargar algo manualmente?›

No. El toolkit descarga el binario reforzado más reciente para tu SO en la primera ejecución y lo mantiene actualizado automáticamente.

¿Qué lenguajes y drivers son compatibles?›

Python es la referencia, controlado con la API estándar de Playwright que ya usas. Hay un paquete de JavaScript/TypeScript que se instala como capiumbrowser en npm.

¿Qué cuenta como una sesión?›

Una instancia de navegador activa. El tope de sesiones de tu plan es el número que puedes ejecutar a la vez, no un total mensual.

¿La prueba gratuita caduca?›

Sí. La prueba te da una sesión de navegador durante 30 días y luego termina. Mejora tu plan cuando quieras para tener más sesiones y soporte.

¿Listo para empezar?

Consigue tu clave de licencia y controla tu primera sesión sigilosa en minutos.

Abrir el panel