Titiritero de acero

Un servidor de Protocolo de Contexto de Modelo que proporciona capacidades de automatización del navegador mediante Puppeteer y Steel. Este servidor permite a los LLM interactuar con páginas web, tomar capturas de pantalla y ejecutar JavaScript en un entorno de navegador real.

Componentes

Herramientas

• titiritero_navegar
  • Navegue a cualquier URL en el navegador
  • Entradas:
    • url (cadena, obligatoria): URL a la que navegar
    • timeout (número, opcional, predeterminado: 60000): tiempo de espera de navegación en milisegundos
    • waitUntil (cadena, opcional, valor predeterminado: "domcontentloaded"): Cuándo se considera que la navegación fue exitosa. Opciones: "load", "domcontentloaded", "networkidle0", "networkidle2"
• captura de pantalla del titiritero
  • Capturar capturas de pantalla de toda la página o de elementos específicos
  • Entradas:
    • name (cadena, obligatorio): nombre para la captura de pantalla
    • selector (cadena, opcional): selector CSS para el elemento que se va a capturar en captura de pantalla
• clic del titiritero
  • Haga clic en elementos de la página
  • Entrada: selector (cadena, obligatoria): selector CSS para el elemento en el que hacer clic
• relleno de titiritero
  • Rellene los campos de entrada
  • Entradas:
    • selector (cadena, obligatorio): selector CSS para el campo de entrada
    • value (cadena, obligatorio): Valor a rellenar
• titiritero_seleccionar
  • Seleccione un elemento con la etiqueta SELECT
  • Entradas:
    • selector (cadena, obligatorio): selector CSS para el elemento a seleccionar
    • value (cadena, obligatorio): Valor a seleccionar
• titiritero_flotante
  • Elementos flotantes en la página
  • Entrada: selector (cadena, obligatoria): selector CSS para el elemento sobre el que se pasará el mouse
• titiritero_evaluar
  • Ejecutar JavaScript en la consola del navegador
  • Entrada: script (cadena, obligatorio): código JavaScript a ejecutar
• titiritero_obtener_contenido
  • Extraer contenido de la página actual
  • Entrada: selector (cadena, opcional): Selector CSS para obtener el contenido de elementos específicos. Si no se proporciona, devuelve el contenido completo de la página.
• pergamino del titiritero
  • Desplácese por la página para activar la carga diferida
  • Entradas:
    • scrollDelay (número, opcional, predeterminado: 100): Retraso entre desplazamientos en milisegundos
    • maxScrolls (número, opcional, predeterminado: 50): Número máximo de desplazamientos

Recursos

El servidor proporciona acceso a dos tipos de recursos:

1. Registros de la consola ( console://logs )
   • Salida de la consola del navegador en formato de texto
   • Incluye todos los mensajes de la consola del navegador.
2. Capturas de pantalla ( screenshot://<name> )
   • Imágenes PNG de capturas de pantalla
   • Accesible a través del nombre de captura de pantalla especificado durante la captura

Características principales

• Automatización del navegador con Puppeteer
• Integración de Steel para la gestión de sesiones del navegador
• Monitoreo y captura de registros de la consola
• Capacidades de captura de pantalla
• Ejecución de JavaScript
• Interacción web básica (navegación, clics, llenado de formularios)
• Extracción de contenido con gestión de límite de tokens
• Soporte de carga diferida mediante desplazamiento
• Compatibilidad con instancias de Steel locales y remotas

Configuración

Configuración del escritorio de Claude

Para usar el servidor Steel Puppeteer con Claude Desktop, agregue la siguiente configuración a su archivo de configuración de Claude Desktop (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

Reemplace "path/to/steel-puppeteer/dist/index.js" con la ruta real al archivo JavaScript compilado en su sistema.

Variables de entorno

El servidor Steel Puppeteer se puede configurar utilizando las siguientes variables de entorno:

• STEEL_LOCAL (opcional, predeterminado: "falso"): configúrelo en "verdadero" para utilizar una instancia local de Steel en lugar del servicio en la nube.
• STEEL_API_KEY (obligatorio solo si STEEL_LOCAL es "falso"): Su clave API de Steel para la autenticación al usar el servicio en la nube.
• STEEL_URL (opcional): la URL de su instancia de Steel si utiliza una implementación personalizada.

Configuración del servidor

Si ejecuta el servidor Steel Puppeteer directamente (no a través de Claude Desktop), puede configurar estas variables de entorno en su shell o crear un archivo .env en la raíz del proyecto. Aquí tiene un ejemplo de archivo .env para uso local:

Si está utilizando el servicio en la nube Steel, su archivo .env se vería así:

Ejecución del servidor

Para iniciar el servidor Steel Puppeteer:

1. Instalar dependencias:
   npm install
2. Construir el proyecto:
   npm run build
3. Iniciar el servidor:
   npm start
4. ¡Abre Claude Desktop y navega! El servidor se iniciará y escuchará en el puerto especificado (predeterminado: 3000).

Solución de problemas

• Si tiene problemas con Puppeteer, asegúrese de tener las dependencias necesarias instaladas en su sistema. Consulte la guía de solución de problemas de Puppeteer para obtener más información.
• Si utiliza el servicio en nube Steel, asegúrese de que su clave API de Steel sea válida y tenga los permisos necesarios.
• Si usa una instancia de Steel local, asegúrese de que esté en ejecución y sea accesible en la URL especificada (si es personalizada) o en la dirección local predeterminada.

Para obtener opciones de configuración más detalladas y un uso avanzado, consulte la documentación de Steel y la referencia de la API de Puppeteer.