Inicio rápido

Esta guía le lleva por la escritura y ejecución de un script de automatización sencillo. Navegará a una página, extraerá texto y lo almacenará: todo en unos 5 minutos.

Paso 1: Abrir una página

Inicie Guida y vaya a https://news.ycombinator.com usando la barra de direcciones.

Paso 2: Abrir el editor de scripts

Pulse Ctrl+N para abrir una nueva pestaña de script, o vaya a File > New Script.

Paso 3: Escribir un script

Pegue esto en el editor:

async function main() {
  // Get the page title
  const title = await g.page.executeJS("document.title");
  g.log("Page title: " + title);

  // Extract the top 5 story titles
  const stories = await g.page.executeJS(`
    Array.from(document.querySelectorAll('.titleline > a'))
      .slice(0, 5)
      .map(a => a.textContent)
  `);

  // Log each story
  for (const story of stories) {
    g.log("  " + story);
  }

  g.log("Done! Found " + stories.length + " stories.");
}

Paso 4: Ejecutarlo

Pulse F5 o haga clic en el botón Run. Observe el panel Console: verá el título de la página y las 5 historias principales de Hacker News.

Paso 5: Almacenar los resultados

Guardemos los datos en el almacén del espacio de trabajo. Primero, abra una carpeta de espacio de trabajo con File > Open Workspace; cualquier carpeta vacía sirve.

Luego modifique el script para almacenar resultados:

async function main() {
  const stories = await g.page.executeJS(`
    Array.from(document.querySelectorAll('.titleline > a'))
      .slice(0, 5)
      .map(a => ({ title: a.textContent, url: a.href }))
  `);

  // Store each story
  for (const story of stories) {
    const key = story.title.toLowerCase().replace(/\s+/g, '-').slice(0, 50);
    g.store.put("hn-stories", key, story);
  }

  const count = g.store.count("hn-stories");
  g.log(`Stored ${count} stories in 'hn-stories' collection`);
}

Ejecute de nuevo con F5. Las historias quedan persistidas en el almacén de su espacio de trabajo y sobrevivirán a reinicios de la aplicación.

¿Qué sigue?

• Explore la API completa g.* en el editor de scripts: escriba g. e IntelliSense mostrará todos los métodos disponibles
• Genere archivos de soporte para scripting desde Tools > Developer > Generate Scripting Support Files… si quiere archivos locales para el editor o contexto LLM
• Pruebe las recetas con ejemplos de flujos reales
• Aprenda cómo los espacios de trabajo almacenan scripts, colas y datos
• Pruebe await g.dom.click(".selector") para interactuar con elementos de la página
• Conecte un LLM compatible con MCP para automatización dirigida por IA