Início rápido

Este guia mostra como escrever e executar um script simples de automação. Você vai navegar para uma página, extrair texto e armazená-lo — tudo em cerca de 5 minutos.

Etapa 1: abra uma página

Abra o Guida e navegue para https://news.ycombinator.com usando a barra de endereços.

Etapa 2: abra o editor de scripts

Pressione Ctrl+N para abrir uma nova guia de script ou use File > New Script.

Etapa 3: escreva um script

Cole isto no editor:

async function main() {
  // Obter o título da página
  const title = await g.page.executeJS("document.title");
  g.log("Título da página: " + title);

  // Extrair os 5 principais títulos de histórias
  const stories = await g.page.executeJS(`
    Array.from(document.querySelectorAll('.titleline > a'))
      .slice(0, 5)
      .map(a => a.textContent)
  `);

  // Registrar cada história
  for (const story of stories) {
    g.log("  " + story);
  }

  g.log("Concluído. Encontradas " + stories.length + " histórias.");
}

Etapa 4: execute

Pressione F5 ou clique no botão Run. Observe o painel Console: você verá o título da página e as 5 principais histórias do Hacker News.

Etapa 5: armazene os resultados

Vamos salvar os dados no armazenamento do espaço de trabalho. Primeiro, abra uma pasta de espaço de trabalho em File > Open Workspace (qualquer pasta vazia serve).

Depois modifique o script para armazenar os 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 }))
  `);

  // Armazenar cada história
  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} histórias armazenadas na coleção 'hn-stories'`);
}

Execute novamente com F5. As histórias agora ficam persistidas no armazenamento do seu espaço de trabalho e sobrevivem a reinicializações do aplicativo.

Próximos passos

• Navegue pela API g.* completa no editor de scripts: digite g. e o IntelliSense mostrará os métodos disponíveis
• Gere arquivos de suporte a scripts em Tools > Developer > Generate Scripting Support Files… se quiser arquivos locais para editor ou contexto de LLM
• Experimente as Receitas para exemplos de fluxos reais
• Aprenda como Espaços de trabalho armazenam scripts, filas e dados
• Experimente await g.dom.click(".selector") para interagir com elementos da página
• Conecte um LLM compatível com MCP para automação guiada por IA