Démarrage rapide

Ce guide vous accompagne dans l’écriture et l’exécution d’un script d’automatisation simple. Vous allez ouvrir une page, extraire du texte et le stocker, le tout en environ 5 minutes.

Étape 1 : ouvrir une page

Lancez Guida et accédez à https://news.ycombinator.com avec la barre d’adresse.

Étape 2 : ouvrir l’éditeur de scripts

Appuyez sur Ctrl+N pour ouvrir un nouvel onglet de script, ou allez dans File > New Script.

Étape 3 : écrire un script

Collez ceci dans l’éditeur :

async function main() {
  // Obtenir le titre de la page
  const title = await g.page.executeJS("document.title");
  g.log("Titre de la page : " + title);

  // Extraire les titres des 5 premières histoires
  const stories = await g.page.executeJS(`
    Array.from(document.querySelectorAll('.titleline > a'))
      .slice(0, 5)
      .map(a => a.textContent)
  `);

  // Journaliser chaque histoire
  for (const story of stories) {
    g.log("  " + story);
  }

  g.log("Terminé ! " + stories.length + " histoires trouvées.");
}

Étape 4 : l’exécuter

Appuyez sur F5 ou cliquez sur le bouton Run. Observez la sortie dans le panneau Console : vous verrez le titre de la page et les 5 premières histoires Hacker News.

Étape 5 : stocker les résultats

Enregistrons les données dans le stockage de l’espace de travail. Ouvrez d’abord un dossier d’espace de travail avec File > Open Workspace ; n’importe quel dossier vide convient.

Modifiez ensuite le script pour stocker les résultats :

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 }))
  `);

  // Stocker chaque histoire
  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(`${count} histoires stockées dans la collection 'hn-stories'`);
}

Relancez avec F5. Les histoires sont maintenant persistées dans le stockage de votre espace de travail ; elles survivront aux redémarrages de l’application.

Et maintenant ?

• Parcourez toute l’API g.* dans l’éditeur de scripts : tapez g. et IntelliSense affichera toutes les méthodes disponibles
• Générez les fichiers de support au scripting depuis Tools > Developer > Generate Scripting Support Files… si vous voulez des fichiers de contexte pour un éditeur local ou un LLM
• Essayez les recettes pour des exemples de flux réels
• Découvrez comment les espaces de travail stockent scripts, files d’attente et données
• Essayez await g.dom.click(".selector") pour interagir avec des éléments de page
• Connectez un LLM compatible MCP pour l’automatisation pilotée par IA