Instale, autentique e controle.
O Capium Browser é nosso Chrome stealth proprietário, licenciado por sessão e instalado com um único comando. Insira sua chave de licença e controle-o localmente com a API do Playwright que você já conhece.
Controle como no Playwright
Navegue, clique, digite, aguarde seletores e a rede. A API padrão do Playwright funciona sem alterações.
Chrome stealth de verdade
Um núcleo genuíno do Chrome, sempre na versão mais recente, reforçado contra detecção de bots, não um stub headless ou um wrapper corrigido.
Capturas de tela e PDFs
Capture a página inteira ou renderize qualquer página em PDF, exatamente como faria com um navegador local.
Sessões simultâneas
Execute vários navegadores ao mesmo tempo. Cada navegador ativo conta como uma sessão no limite do seu plano.
1. Primeiros passos
Instale o toolkit para a sua linguagem. Não há nada para hospedar nem para corrigir. O binário stealth é baixado na primeira execução e mantido atualizado automaticamente.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserInsira sua chave de licença e controle sua primeira página. Ative humanize=True para entrada e tempos semelhantes aos humanos.
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. Autenticação
Sua chave de licença fica no painel, em Capium Browser. Revele, copie ou emita uma nova por lá. Mantenha-a em segredo e carregue-a do ambiente em vez de deixá-la fixa no código.
# 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)- Emita uma nova chave pelo painel se ela for exposta. A chave antiga deixa de funcionar imediatamente.
- Uma licença ativa por conta. Os níveis superiores aumentam quantas sessões podem ser executadas ao mesmo tempo.
- A chave autoriza o binário; não é necessário login ou cookie separado.
3. Controle com Playwright (Python)
Tudo o que você conhece do Playwright funciona: locators, esperas, interceptação de rede e muito mais. O Capium apenas troca o núcleo por um Chrome real e reforçado.
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 assíncrona
A API assíncrona espelha a síncrona: launch_context_async retorna o mesmo trio (browser, context, page) com métodos do Playwright que podem ser aguardados com await.
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
Passar humanize=True na inicialização adiciona entrada e tempos semelhantes aos humanos: movimento natural do mouse, cadência de digitação realista e pequenas pausas variáveis, além dos helpers page.human_type e page.human_scroll. Deixe ativado em fluxos interativos; desative para buscas e parsing puros, em que a velocidade importa.
browser, ctx, page = launch_context(seed=200123, humanize=True)
page.human_type("#email", "[email protected]") # natural typing cadence
page.human_scroll(1200) # smooth, variable scrolling6. Sessões e concorrência
Cada navegador ativo é uma sessão. O limite de sessões do seu plano é quantas você pode executar ao mesmo tempo. Feche um navegador quando terminar para liberar a sessão.
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. Receitas: capturas de tela e PDFs
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 e CI
Binários nativos estão disponíveis para Linux, Windows e macOS, com comportamento idêntico no seu notebook, em um runner de CI e na sua frota. No CI, defina a chave de licença como uma variável de ambiente secreta:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Solução de problemas
Confirme se a chave corresponde à do painel e se sua licença (ou teste) ainda está ativa. Emita uma nova chave, se necessário.
Você tem tantos navegadores ativos quanto seu plano permite. Feche os navegadores que já terminaram ou faça upgrade para ter um limite de sessões maior.
O binário é baixado na primeira execução; libere o HTTPS de saída. Em ambientes de CI restritos, faça cache do toolkit entre as execuções.
10. Perguntas frequentes
Onde está minha chave de licença?›
No painel, em Capium Browser. Revele, copie ou emita uma nova por lá. Mantenha-a em segredo; trate-a como uma senha.
Preciso baixar algo manualmente?›
Não. O toolkit busca o binário reforçado mais recente para o seu sistema operacional na primeira execução e o mantém atualizado automaticamente.
Quais linguagens e drivers são compatíveis?›
Python é a referência, controlado com a API padrão do Playwright que você já usa. Um pacote JavaScript/TypeScript é instalado como capiumbrowser no npm.
O que conta como uma sessão?›
Uma instância de navegador ativa. O limite de sessões do seu plano é o número que você pode executar simultaneamente, não um total mensal.
O teste grátis expira?›
Sim. O teste oferece uma sessão de navegador por 30 dias e depois termina. Faça upgrade quando quiser para ter mais sessões e suporte.
Pronto para começar?
Pegue sua chave de licença e execute sua primeira sessão stealth em minutos.