Cómo configurar un navegador de agente completo: Una guía completa para instalar la habilidad de raspado del navegador en 5 agentes de IA principales.

Principales Conclusiones

• Una habilidad, cinco agentes. Claude Code, Cursor, VS Code + Copilot, Codex CLI y Gemini CLI leen el mismo formato SKILL.md + YAML-frontmatter desde un pequeño conjunto de directorios convencionales.
• Una CLI subyacente. Una sola npm install -g scrapeless-scraping-browser y una única clave API de Scrapeless alimentan la habilidad a través de cada agente.
• Un token, cualquier agente. Configura la clave API una vez con scrapeless-scraping-browser config set apiKey … — cualquier agente que acceda a la CLI lee la misma clave almacenada.
• Un navegador de agentes construido para la web. Scraping Browser está diseñado para páginas dinámicas, interacción con el navegador, fricciones de CAPTCHA, enrutamiento de proxies y automatización de grado productivo donde un navegador normal o un raspador estático no son suficientes. Scraping Browser resuelve reCAPTCHA v2, Cloudflare Turnstile, Cloudflare 5s Challenge y AWS Challenge de forma nativa — sin configuración adicional.
• Mejor para casos de uso reales de agentes. Esto es especialmente útil cuando tu agente debe inspeccionar tableros, navegar flujos de múltiples pasos, llenar formularios, recolectar datos estructurados u operar a través de sitios web con diseños cambiantes.

Introducción: Las habilidades de los agentes son el nuevo objetivo de instalación

Los agentes de IA están avanzando más allá de la simple generación de texto y entrando en la ejecución web real. En ese giro, el navegador ya no es solo una superficie de visualización; se convierte en la capa operativa donde un agente observa páginas, razona sobre el estado y toma acción a través de sitios. Por eso el término navegador agente es importante: describe un entorno de navegador que puede llevar a cabo tareas de múltiples pasos con un grado de autonomía en lugar de esperar a que un humano haga clic en cada paso.

Los agentes de codificación de IA modernos — Claude Code, Cursor, VS Code + GitHub Copilot, OpenAI Codex CLI y Gemini CLI — soportan todos habilidades de agentes: paquetes instantáneos que enseñan a un agente una nueva capacidad bajo demanda. El ecosistema se ha convergido en un único formato de empaquetado (SKILL.md con YAML frontmatter) para que la misma carpeta de habilidades funcione en cada uno de los agentes mencionados con ajustes mínimos.

Esto también es donde Scrapeless se ajusta de forma natural. El scrapeless-Agent-browser está posicionado como el puente entre la lógica del agente y la ejecución confiable del navegador, permitiendo que el agente impulse Scrapeless Scraping Browser — un navegador en la nube personalizable y anti-detección diseñado específicamente para la automatización web y agentes de IA — para abrir páginas, extraer datos, llenar formularios, enrutar tráfico a través de proxies residenciales y manejar CAPTCHA, todo sin escribir código de automatización de navegador de bajo nivel.

Esta guía muestra cómo instalar la habilidad de Scrapeless Scraping Browser en 5 entornos principales de agentes, mientras se mantiene la misma base de navegador subyacente en todos ellos.

Por qué importan los navegadores de agentes

La automatización tradicional de navegadores a menudo falla en las mismas cosas con las que los usuarios reales se encuentran todos los días: JavaScript dinámico, verificaciones anti-bot, estado de sesión, contenido geo-sensible y diseños que cambian rápidamente. Los navegadores de agentes resuelven eso al dar al agente un navegador diseñado para la interacción, persistencia y variabilidad web en lugar de solo para la representación de páginas. Para los equipos que construyen flujos de trabajo de producción, esto reduce la cantidad de código de aglutinante necesario en torno a la navegación, reintentos y manejo del estado de la página.

Para muchas empresas, el navegador en sí es ahora la interfaz hacia los datos. Un navegador de agentes puede leer tableros, moverse a través de portales autenticados, recolectar señales de precios o disponibilidad, verificar estados de cuentas y completar tareas web que serían costosas de codificar de punta a punta. La capa de navegador de Scrapeless es especialmente relevante cuando esos flujos de trabajo necesitan infraestructura resiliente, control de proxies y ejecución confiable a gran escala.

Lo que puedes hacer con ello

Una vez instalado, los agentes obtienen toda la superficie de Scrapeless Scraping Browser:

• Abre cualquier URL en Scrapeless Scraping Browser y descubre el DOM con snapshot -i.
• Interactúa con elementos a través de cortas referencias de árbol de accesibilidad @e1, @e2 o selectores CSS estándar.
• Llena formularios, haz clic en botones, sube archivos, toma capturas de pantalla, descarga PDFs.
• Enruta tráfico a través de proxies residenciales por país, estado o ciudad.
• Configura la huella digital de escritorio por sesión: plataforma (Windows, macOS, Linux), zona horaria, idiomas y dimensiones de pantalla.
• Graba sesiones para revisión posterior en el panel de Scrapeless y abre una vista en vivo para inspección en tiempo real.

Los agentes activan la habilidad automáticamente cuando los usuarios dicen cosas como "raspa las 5 publicaciones principales de Hacker News", "inicia sesión en este sitio y toma una captura de pantalla del tablero" o "llena esta solicitud de empleo con mi currículum y detente antes de la presentación final".

Por qué Scrapeless

Scrapeless Scraping Browser maneja las partes de la automatización web que normalmente consumen semanas de tiempo de ingeniería:

• Antidetección incorporada — La página del producto de Scrapeless lo describe como un "navegador en la nube anti-detección personalizable impulsado por Chromium desarrollado internamente."
• Proxies residenciales en más de 195 países, seleccionables por sesión.
• Resolución automática de CAPTCHA para reCAPTCHA v2, Cloudflare Turnstile, Cloudflare 5s Challenge y AWS Challenge (lista de soportados); cualquier cosa fuera de esos cuatro está cubierta por el producto separado Scrapeless CAPTCHA Solver.
• Grabación de sesiones y vista en vivo para inspección y depuración en tiempo real de ejecuciones en producción.
• Compatibilidad de protocolos con Puppeteer y Playwright a través del SDK de Scrapeless.

Productos relacionados: API de scraping universal, Soluciones de proxy y el Servidor MCP de Scrapeless para integraciones de Protocolos de Contexto de Modelos.

El Formato de Habilidad

Cada agente en esta guía lee habilidades en la misma estructura:

<skills-dir>/scrapeless-scraping-browser/
├── SKILL.md          # YAML frontmatter + instrucciones (requerido)
├── skill.json        # metadatos ricos (opcional pero recomendado)
├── SECURITY.md       # notas de seguridad (opcional)
└── references/
    └── authentication.md

El frontmatter SKILL.md le dice al agente qué hace la habilidad y cuándo activarla:

---
name: scrapeless-scraping-browser
description: Línea de comandos de automatización de navegadores en la nube para agentes de IA impulsada por Scrapeless. Utilice cuando el usuario necesite interactuar con sitios web utilizando navegadores en la nube, incluida la navegación por páginas, el llenado de formularios, la presión de botones, la captura de pantallas, la extracción de datos, la prueba de aplicaciones web o la automatización de cualquier tarea de navegador con proxies residenciales y características de antidetección. Los disparadores incluyen solicitudes para "abrir un sitio web", "llenar un formulario", "hacer clic en un botón", "tomar una captura de pantalla", "extraer datos de una página", "probar esta aplicación web", "usar un proxy", "eludir la detección" o cualquier tarea que requiera automatización de navegadores en la nube.
allowed-tools: Bash(npx scrapeless-scraping-browser-skills scrapeless-scraping-browser:*), Bash(scrapeless-scraping-browser:*)
---

Las principales cosas que difieren entre los agentes son dónde colocar la carpeta de habilidades, cómo el agente la descubre al iniciar y qué campos opcionales de frontmatter lee cada agente (los campos name + description son universales).

Requisitos Previos

Antes de instalar la habilidad en cualquier agente, configure el CLI subyacente y las credenciales — una sola vez.

1. Instalar Node.js 18 o superior

Desde nodejs.org, o a través de un gestor de versiones (nvm, fnm, volta).

2. Instalar el CLI de Scrapeless Scraping Browser globalmente

npm install -g scrapeless-scraping-browser

Verificar:

scrapeless-scraping-browser version

3. Obtener una clave API de Scrapeless

1. Regístrate en app.scrapeless.com — para que puedas comenzar a usar el navegador de scraping de inmediato.
2. Genera un token API desde el panel.

4. Configurar la clave API

Elige uno de estos métodos.

Opción A — archivo de configuración (recomendado, persistente, inter-agente):

scrapeless-scraping-browser config set apiKey your_api_token_here
scrapeless-scraping-browser config get apiKey   # verificar

Esto almacena la clave en ~/.scrapeless/config.json en tu directorio personal.

Opción B — variable de entorno:

# macOS / Linux
export SCRAPELESS_API_KEY=your_api_token_here

# PowerShell de Windows
$env:SCRAPELESS_API_KEY="your_api_token_here"

Agrega la línea a ~/.zshrc, ~/.bashrc, o tus variables de entorno de Windows para que persista a través de las sesiones.

Nota: el archivo de configuración tiene prioridad sobre la variable de entorno cuando ambas están configuradas. Solo se lee SCRAPELESS_API_KEY del entorno — el Servidor MCP de Scrapeless utiliza una variable diferente (SCRAPELESS_KEY) y no está relacionada con esta habilidad.

5. Descargar el paquete de habilidad

Clona el paquete de habilidades:

git clone https://github.com/scrapeless-ai/scrapeless-agent-browser.git
cd scrapeless-agent-browser/skills/scraping-browser-skill

Los pasos a continuación copian el contenido de esta carpeta en el directorio de habilidades de cada agente.

Paso 1 — Instalar en Claude Code (Anthropic)

Directorio de habilidades

• Global: ~/.claude/skills/scrapeless-scraping-browser/
• Proyecto: <repo>/.claude/skills/scrapeless-scraping-browser/

Instalar (global, macOS / Linux)

mkdir -p ~/.claude/skills/scrapeless-scraping-browser
cp -r ./* ~/.claude/skills/scrapeless-scraping-browser/

Instalar (global, PowerShell de Windows)

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\scraping-sin-rasguños"
Copy-Item -Recurse -Force .\* "$HOME\.claude\skills\scraping-sin-rasguños\"

Activar: Claude Code recoge los cambios de habilidades en vivo dentro de un ~/.claude/skills/ existente (no es necesario reiniciar). Solo se requiere en la primera instalación si el directorio de nivel superior ~/.claude/skills/ no existía cuando comenzó la sesión; en ese caso, reinicie cualquier sesión de claude que esté en ejecución una vez.

Verificar: dentro de Claude Code, pregunte "¿qué habilidades están disponibles?" — los documentos de solución de problemas de habilidades de Anthropic mencionan exactamente este aviso como la verificación de la lista (fuente). O ejecute un aviso desencadenador como "abre example.com y toma una captura de pantalla de la página de inicio" y Claude invocará los comandos documentados de la habilidad de SKILL.md.

Paso 2 — Instalar en Cursor

Versión mínima: Cursor 2.4 o más reciente (Habilidades de Agente incluidas en la versión 2.4, enero de 2026).

Directorio de habilidades

• Global (canónico): ~/.agents/skills/scraping-sin-rasguños/
• Global (también aceptado): ~/.cursor/skills/, ~/.claude/skills/, ~/.codex/skills/
• Proyecto (canónico): <repo>/.agents/skills/scraping-sin-rasguños/
• Proyecto (también aceptado): <repo>/.cursor/skills/, <repo>/.claude/skills/, <repo>/.codex/skills/

Instalar (ruta global, canónica)

mkdir -p ~/.agents/skills/scraping-sin-rasguños
cp -r ./* ~/.agents/skills/scraping-sin-rasguños/

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills\scraping-sin-rasguños"
Copy-Item -Recurse -Force .\* "$HOME\.agents\skills\scraping-sin-rasguños\"

Activar: "Cuando Cursor inicia, descubre automáticamente las habilidades de los directorios de habilidades y las pone a disposición del Agente." (Documentos de Cursor)

Verificar: abre Configuración de Cursor (Cmd/Ctrl+Shift+J) → Reglas — scraping-sin-rasguños aparece bajo El Agente Decide. O escribe / en el chat del Agente para ver la habilidad en el selector de comandos de barra. O solicita "extraer las 5 mejores historias de news.ycombinator.com como JSON" — el agente debería encadenar automáticamente los comandos de la habilidad (new-session → open → get html → eval).

Paso 3 — Instalar en VS Code + GitHub Copilot

GitHub Copilot agregó soporte para Habilidades de Agente en diciembre de 2025 (registro de cambios). Copilot en VS Code descubre automáticamente habilidades de tres familias de ubicaciones:

• Global (personal): ~/.copilot/skills/, ~/.claude/skills/, o ~/.agents/skills/
• Proyecto (nativo de Copilot): <repo>/.github/skills/scraping-sin-rasguños/
• Proyecto (cross-agent): <repo>/.claude/skills/... o <repo>/.agents/skills/...

Nota de metadatos: Copilot requiere solo nombre y descripción; herramientas permitidas y licencia son opcionales. Documentos de habilidades de Copilot de GitHub indican textualmente: "En su metadatos SKILL.md, puede usar el campo herramientas permitidas para enumerar las herramientas que Copilot puede usar sin pedir confirmación cada vez." Revise la fuente de la habilidad antes de otorgar preaprobación.

Instalar (global, macOS / Linux)

mkdir -p ~/.copilot/skills/scraping-sin-rasguños
cp -r ./* ~/.copilot/skills/scraping-sin-rasguños/

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\.copilot\skills\scraping-sin-rasguños"
Copy-Item -Recurse -Force .\* "$HOME\.copilot\skills\scraping-sin-rasguños\"

Instalar (a nivel de proyecto, recomendado para uso en equipo)

cd <tu-repo>
mkdir -p .github/skills/scraping-sin-rasguños
cp -r /path/to/skill/* .github/skills/scraping-sin-rasguños/
git add .github/skills/scraping-sin-rasguños
git commit -m "Agregar habilidad de scraping-sin-rasguños"

Activar: según el registro de cambios de GitHub del 18 de diciembre de 2025, Copilot recoge habilidades colocadas en los directorios soportados sin configuración adicional. Las habilidades cargan contenido progresivamente solo cuando es relevante para una tarea.

Verificar: abre Copilot Chat y escribe /skills — según los documentos de habilidades de Copilot de VS Code, esto "abre rápidamente el menú Configurar Habilidades" donde debería aparecer scraping-sin-rasguños. O solicita "raspar los precios de productos de esta URL" / "captura de pantalla example.com" y observa cómo Copilot invoca la habilidad.

Paso 4 — Instalar en OpenAI Codex CLI

Versión mínima: Cualquier compilación de Codex CLI que documente Habilidades de Agente — actualízate a la última CLI codex para estar seguro (Documentos de Habilidades de Codex).

Directorio de habilidades

• Global: $HOME/.agents/skills/scrapeless-scraping-browser/ — el alcance de usuario documentado.
• Proyecto: $CWD/.agents/skills/, cualquier directorio padre que contenga .agents/skills/, o $REPO_ROOT/.agents/skills/. Codex camina desde CWD hasta la raíz del repositorio.
• ~/.codex/skills/ NO se descubre automáticamente — si quieres que Codex lea desde allí, regístralo explícitamente en ~/.codex/config.toml bajo [[skills.config]] con una ruta absoluta, por ejemplo, path = "/home/<tu>/.codex/skills/scrapeless-scraping-browser/SKILL.md" (la documentación de Codex muestra rutas absolutas en el ejemplo de [[skills.config]] — la expansión de la tilde dentro de TOML no está documentada).

Instalar (global)

mkdir -p ~/.agents/skills/scrapeless-scraping-browser
cp -r ./* ~/.agents/skills/scrapeless-scraping-browser/

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills\scrapeless-scraping-browser"
Copy-Item -Recurse -Force .\* "$HOME\.agents\skills\scrapeless-scraping-browser\"

Activar: "Codex detects skill changes automatically. If an update doesn't appear, restart Codex." (Documentación de habilidades de Codex)

Verificar: en el prompt de Codex, ejecuta /skills para listar las habilidades disponibles. Invoca la habilidad directamente escribiendo $scrapeless-scraping-browser en tu mensaje, o prueba el activador automático con "llena el formulario de registro en example.com/signup y detente antes del envío final".

Paso 5 — Instalar en Gemini CLI (Google)

Directorio de habilidades

• Global: ~/.gemini/skills/scrapeless-scraping-browser/ — ~/.agents/skills/ es un alias oficialmente documentado que tiene prioridad sobre ~/.gemini/skills/ cuando ambos existen.
• Proyecto: <repo>/.gemini/skills/scrapeless-scraping-browser/ — o usa el alias <repo>/.agents/skills/.

Instalar

mkdir -p ~/.gemini/skills/scrapeless-scraping-browser
cp -r ./* ~/.gemini/skills/scrapeless-scraping-browser/

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\.gemini\skills\scrapeless-scraping-browser"
Copy-Item -Recurse -Force .\* "$HOME\.gemini\skills\scrapeless-scraping-browser\"

Activar: ejecuta /skills reload en la sesión para actualizar la lista de habilidades descubiertas de todos los niveles (Documentación de habilidades de Gemini CLI).

Verificar: ejecuta /skills list dentro de una sesión de Gemini CLI — scrapeless-scraping-browser debería aparecer en la lista descubierta. Luego prueba con "abre booking.com desde un proxy residencial en Tokio y recupera los 5 mejores hoteles para el 15-18 de junio"; el modelo solicitará activación antes de ejecutar los comandos de la habilidad.

Paso 6 — Una habilidad, cada agente (el truco del enlace simbólico)

Si usas múltiples agentes y no quieres copiar la habilidad en N directorios, instálala una vez y crea enlaces simbólicos para el resto.

macOS / Linux

# Instalar una vez como la fuente de verdad:
mkdir -p ~/.agents/skills/scrapeless-scraping-browser
cp -r ./* ~/.agents/skills/scrapeless-scraping-browser/

# Crear enlaces simbólicos para cada otro agente:
ln -s ~/.agents/skills/scrapeless-scraping-browser ~/.claude/skills/scrapeless-scraping-browser
ln -s ~/.agents/skills/scrapeless-scraping-browser ~/.cursor/skills/scrapeless-scraping-browser
ln -s ~/.agents/skills/scrapeless-scraping-browser ~/.copilot/skills/scrapeless-scraping-browser
ln -s ~/.agents/skills/scrapeless-scraping-browser ~/.gemini/skills/scrapeless-scraping-browser

Ahora, actualizar la fuente actualiza cada agente simultáneamente.

Windows PowerShell — en Windows 10/11 con el Modo Desarrollador habilitado (Configuración → Sistema → Avanzado → Para desarrolladores en Windows 11 25H2+; la página Para desarrolladores directamente en versiones anteriores), los enlaces simbólicos funcionan sin elevación. De lo contrario, ejecuta PowerShell como Administrador. Consulta la documentación de Modo Desarrollador de Microsoft.

$src = "$HOME\.agents\skills\scrapeless-scraping-browser"
"claude","cursor","copilot","gemini" | ForEach-Object {
  $dest = "$HOME\.$_\skills\scrapeless-scraping-browser"
  New-Item -ItemType Directory -Force -Path (Split-Path $dest)
  New-Item -ItemType SymbolicLink -Path $dest -Target $src
}

Paso 7 — Nivel de Proyecto vs Global: ¿Cuál elegir?

Paso 8 — Solución de Problemas Comunes

La habilidad no aparece después de copiar. La ruta de actualización de cada agente es diferente: Claude Code — docs dice que un directorio superior ~/.claude/skills/ creado después del inicio de la sesión requiere reiniciar claude; los cambios dentro de un directorio existente se recogen en vivo. Codex — docs dice "Codex detecta cambios en las habilidades automáticamente. Si una actualización no aparece, reinicia Codex." CLI de Gemini — ejecuta /skills reload en la sesión. Cursor y VS Code / Copilot — sus documentos describen el descubrimiento automático en el inicio; si falta una habilidad, reinicia el editor.

El agente dice SCRAPELESS_API_KEY es requerido. La clave no está en el entorno del proceso del agente. Prefiere el método del archivo de configuración (scrapeless-scraping-browser config set apiKey ...) — es independiente del proceso y funciona en todos los agentes.

El activador no se dispara automáticamente. Abre SKILL.md en la ubicación instalada y verifica el frontmatter description — los agentes lo usan como señal de enrutamiento. Agrega frases de usuario a la lista de triggers de skill.json para ampliar el emparejamiento.

Conclusión

Los navegadores agenticos se están convirtiendo en un estándar práctico para la automatización con alto contenido web, y Scrapeless se ajusta a esa tendencia al proporcionar una capa de navegador en la nube en la que los agentes pueden confiar. Si tus flujos de trabajo dependen de la navegación, interacción, contenido dinámico o acceso a datos basado en navegadores, la habilidad de Scrapeless Scraping Browser es una base sólida. La gran ventaja es simple: instalas una habilidad de navegador una vez, y luego la reutilizas en múltiples agentes importantes sin reconstruir la capa de ejecución cada vez. El repositorio de scrapeless-agent-browser empaqueta la ejecución del navegador en una capa de agente reutilizable en lugar de tratar al navegador como una dependencia de script única.

Mantente atento a más casos prácticos en nuestras próximas guías de blog. Por ahora, únete a la comunidad oficial de Scrapeless para obtener las últimas actualizaciones y reclamar acceso a tu plan gratuito!
Discord
Telegram

FAQ

Q1: ¿Necesito una clave API separada para cada agente?
No. Configura la clave API de Scrapeless una vez con scrapeless-scraping-browser config set apiKey ... y cada agente que ejecute la CLI la recogerá automáticamente.

Q2: ¿Puedo usar la habilidad a nivel de proyecto y comprometerla a mi repositorio?
Sí. Cada agente en esta guía admite un directorio de habilidades a nivel de proyecto (p. ej. <repo>/.claude/skills/, <repo>/.github/skills/, <repo>/.agents/skills/). Comprometer la habilidad la hace disponible para cada compañero de equipo que clone el repositorio.

Q3: ¿Necesito instalar el paquete npm scrapeless-scraping-browser si ya tengo la habilidad instalada?
Sí — la habilidad es la capa de instrucciones para el agente; el paquete npm es la CLI que controla. La CLI debe ser accesible para el agente, ya sea instalada globalmente (npm install -g scrapeless-scraping-browser) o invocada a través de npx scrapeless-scraping-browser ….

Q4: ¿Cómo maneja la habilidad los CAPTCHA?
Scraping Browser resuelve automáticamente cuatro tipos de CAPTCHA fuera de la caja — reCaptcha v2, Cloudflare Turnstile, Cloudflare 5s Challenge y AWS Challenge (lista oficial de soportados). La documentación nota que "las operaciones posteriores deben ser implementadas por ti" — el navegador resuelve, tu código (o el agente) dirige lo que sucede a continuación. Para cualquier cosa fuera de esos cuatro tipos, el Resolutor de CAPTCHA de Scrapeless es un producto separado.

Q5: ¿Se puede usar la habilidad junto con el código de Puppeteer o Playwright?
Sí. Scrapeless Scraping Browser es compatible con el protocolo de Puppeteer y Playwright a través de la documentación de Scrapeless Scraping Browser, por lo que los agentes pueden combinar sesiones impulsadas por habilidades con scripts de automatización existentes.