Rowvana

Visão geral

O Rowvana lê o que você vê no seu navegador e o organiza em linhas e colunas. A maioria das tarefas se enquadra em um destes casos:

Instalar e abrir

1. Abra o Rowvana na Chrome Web Store e clique em Add to Chrome.
2. Clique no ícone de quebra-cabeça na barra de ferramentas do Chrome e fixe o Rowvana, para que ele fique a apenas um clique de distância.
3. Abra qualquer página da web e clique no ícone do Rowvana. O Rowvana abre no painel lateral do Chrome à direita e permanece aberto enquanto você navega pela página.

Você não precisa de uma conta para começar. O plano Gratuito funciona sem login. Você só precisa de uma conta para salvar os scrapers, iniciar o teste gratuito ou comprar um plano (consulte Conta e planos).

• A barra superior: um contador de itens enquanto algo é coletado ou está pronto · 🔔 notificações · ☀/🌙 claro ou escuro · ⤢ abrir o Rowvana em sua própria janela · Sign in ou sua foto.
• As abas: Scrape · Results · Scrapers · Settings.
• Não tem certeza do que um botão faz? Posicione o mouse sobre ele: cada controle tem uma breve dica.

Sua primeira extração: Encontrar → Verificar → Coletar → Baixar

Uma boa página para praticar é o books.toscrape.com, um site criado para isso. O Rowvana inicia no modo Simple, que nunca exibe códigos ou seletores.

1. Find

1. Abra a página com a lista e abra o Rowvana. Você verá "Turn this page into a spreadsheet".
2. Pressione o botão violeta ✨ Find data on this page. O Rowvana escolhe a lista principal da página e diz, por exemplo, "Found 20 items on this page". Os itens ficam destacados com uma borda azul na página.

• Não é a lista que você queria? Abaixo da pré-visualização, Not the right list? → Other list seleciona a próxima lista ou tabela na página, e Pick on page permite que você clique em um item por conta própria.
• "No list found on this page": faça uma busca ou abra uma categoria primeiro, role um pouco a página se ela carregar conforme a rolagem, ou escolha os itens você mesmo.
• "Rowvana can't read this page": o Chrome não permite que extensões leiam suas próprias páginas (chrome://, a Web Store, uma nova aba). Abra um site normal.
• Templates na tela inicial são começos rápidos: produtos da página de busca de uma loja, locais do Google Maps, qualquer tabela em uma página.

2. Check

• Preview · first 3 of 20 mostra as linhas do jeito que elas vão aparecer no Excel. Show on page destaca os itens novamente.
• As colunas recebem nomes automaticamente com base nos rótulos e conteúdos da própria página: Title, Price, Original price, Rating, Reviews, Link, Image… Preços, avaliações e contagens de resenhas vêm como números reais (“S$1,299.00” → 1299), para que o Excel possa ordená-los e somá-los.
• Se uma coluna estiver quase vazia, você verá, por exemplo, "Rating is empty in 12 of 20 items" com Fix it on the page e Leave it out.

3. Collect

A barra na parte inferior indica o que você vai obter ("5 columns · this page"). Pressione o botão verde ▶ Collect 20 items. Com mais páginas ou páginas de itens ativadas, o texto exibido será ▶ Collect data.

• Enquanto a extração é executada, você vê as linhas coletadas até o momento, as páginas concluídas e o tempo restante. Você pode fechar o Rowvana: mantenha a aba aberta e o Chrome rodando.
• Stop mantém todas as linhas coletadas até o momento.

4. Download

• Quando terminar, você verá "20 rows ready" junto com as colunas, páginas e o tempo. Pressione o botão verde Download Excel, ou escolha CSV · JSON · Copy.
• Se uma página não carregou a tempo, a mensagem exibida será "with gaps" informando o que está faltando; Download available rows fornece o restante.
• Save this setup salva o extrator para a próxima vez. ← Back to the setup retorna às configurações.

Ajuste as colunas

Abra Edit columns abaixo da pré-visualização. Cada coluna tem uma linha:

• Caixa de seleção: desmarque uma coluna para excluí-la. Ela vai para Left out; marque-a novamente para trazê-la de volta.
• Nome: clique nele para renomear. ⋮⋮: arraste para alterar a ordem.
• Aponte para uma linha e o Rowvana contorna esse valor dentro de cada item na página, em verde.
• Menu ⋯: Renomear · Obter o texto completo (abre o "Show more" primeiro) · Apenas números · Salvar o arquivo de imagem · Alterar na página · Remover.
• + Add a column, click it on the page: clique no elemento que você quer dentro de um item, e o Rowvana o encontrará em todos eles.

More pages

Abra Need more data? (Optional) e ative More pages. O Find data já descobriu como este site mostra a página 2 e avisa isso, por exemplo "✓ Found page numbers in the address".

• Defina Up to [10] pages. A barra mostra uma estimativa de quantas linhas você pode esperar.
• Adivinhou errado? Pressione Change e escolha Next · Numbers · Scroll · Load more. Para Next e Load more, você pode apontar para o botão na página; para Numbers, cole o endereço da página 2.
• Páginas que carregam mais conteúdo conforme você rola (Google Maps, feeds de redes sociais) usam Scroll.
• Uma página que não carregar a tempo é ignorada, a extração continua e a tela de conclusão informa qual foi.

Detalhes da página de cada item

Em uma loja, a lista geralmente mostra apenas o nome e o preço. A marca, o vendedor, a descrição ou as especificações estão na página de cada produto. O Rowvana pode abrir essas páginas uma a uma e adicionar o que você escolher.

1. Configure a lista conforme o Passo 2.
2. Abra Need more data? e ative Open each item's page. O Rowvana mostra qual coluna contém o link do item, por exemplo "✓ Each item has its own page (column “Link”)". Pressione Change se estiver incorreto.
3. Pressione Open the first item for me e clique nos detalhes que você deseja nessa página (preço, marca, vendedor...). Cada um se torna um chip; o × o remove.
4. Escolha Open up to [20] itens. O Rowvana mostrará uma estimativa de quanto tempo levará.
5. Pressione ▶ Collect data.

• As páginas são abertas uma de cada vez em uma aba em segundo plano; a sua aba atual permanece onde está.
• Uma página que não puder ser lida mantém os dados da lista para essa linha, e a tela de conclusão informa quantos.
• Marque Also collect emails & phones from each item's page para diretórios e listas.
• Comece com 20 itens para verificar o resultado e, em seguida, aumente o número.

Google Maps e diretórios

No Google Maps, clicar em um resultado não abre uma nova página: um painel com o endereço, telefone, site e horários é aberto ao lado da lista. O Rowvana pode clicar em cada resultado, ler o painel e passar para o próximo.

1. Faça uma busca no Google Maps (por exemplo, dentista em São Paulo) para que a lista de resultados apareça à esquerda. Fique na página de resultados, e não na página de um local específico.
2. Abra o Rowvana e escolha o modelo Places from Google Maps ou pressione ✨ Find data on this page.
3. Ative a opção Open each item's page. No Maps, ela exibe "In a panel here": o Rowvana clica em cada resultado e lê o painel correspondente.
4. Ative a opção More pages. No Maps, o Rowvana rola a lista de resultados para carregar mais itens.
5. Pressione ▶ Collect data e depois Download Excel.

Emails & phones

Na tela inicial, em More ways to collect, escolha Emails & phones. Funciona em todos os planos.

1. Abra a página do site e clique em Find emails & phones.
2. A opção Also check the site's Contact page vem ativada por padrão: se esta página não tiver nenhum e-mail ou telefone, o Rowvana verifica a página de contato em uma aba em segundo plano.
3. Cada e-mail e número possui um botão Copy. Também há a opção Copy all, e Save to Results cria uma única linha com: URL, título da página, e-mails e telefones.

O Rowvana encontra endereços em links, no texto e escritos de forma disfarçada ("name [at] site [dot] com"). Ele ignora nomes de imagens e endereços de exemplo. Os números de telefone são reconhecidos em vários formatos e escritas, incluindo dígitos em bengali.

Para vários sites de uma vez, use a list of URLs. Para cada item em um diretório, use Open each item's page com a caixa emails & phones marcada.

Uma lista de URLs

Já tem os links? Na tela inicial, em More ways to collect, escolha List of URLs.

1. Cole os links, um por linha, ou clique em Upload .txt or .csv. O Rowvana conta todos eles e remove repetições e qualquer coisa que não seja um link.
2. Escolha o que coletar de cada página:
   • Emails & phones: uma linha por URL.
   • Details you pick: o Rowvana abre o primeiro link; clique nos detalhes que você deseja, e os mesmos dados serão lidos de cada URL.
   • The list on each page: o Rowvana encontra a lista no primeiro link, você seleciona as colunas, e cada URL é lida como uma página de resultados.
3. Pressione Collect from N URLs.

Cada URL conta como uma página em relação ao limite de páginas por execução do seu plano (Gratuito: 5). Se uma URL não carregar, ela será ignorada, sem interromper o processo.

Results and download

A aba Results mantém a sua última coleta: uma linha de resumo (site · linhas · colunas · tempo), Filter rows para pesquisar nela e as primeiras 200 linhas. O download sempre inclui todas elas.

No plano Gratuito (Free), cada download suporta até 500 linhas. O Rowvana avisa antes de você baixar caso haja mais dados.

Scrapers salvos

Um scraper salvo mantém toda a configuração: itens, colunas, mais páginas e detalhes da página do item. Salve-o na tela de conclusão (Save this setup) ou no menu ⋯. Para salvar, é necessário ter uma conta gratuita.

• A aba Scrapers os lista com Run, Load e ⋯ (Renomear, Excluir).
• Run for this site: quando você estiver em um site para o qual tem um scraper, um cartão na parte superior o executa com um clique.
• Templates são pontos de partida prontos. Practice on a demo site tem dois sites seguros para você praticar.
• Export all / Import scraper: transfira scrapers para outro computador ou compartilhe-os como um arquivo .rowvana.json.
  • O arquivo contém apenas a configuração. Ele nunca contém sua conta, plano, proxies ou chaves de API, e os tokens de login usados por um site são removidos.
  • Antes de uma importação, o Rowvana mostra quais sites o scraper abrirá e pede sua confirmação.
  • Um scraper importado é executado dentro do seu próprio plano.

Advanced mode

Alterne entre Simple | Advanced na parte superior da aba Scrape. Ambos os modos editam o mesmo extrator, então você pode alternar entre eles sem perder nada.

• Every control: o seletor de itens com uma contagem de correspondências e Test, o seletor de cada coluna (CSS, XPath ou JSON), o que extrair (texto, link, imagem, outro atributo) e números exatos para páginas e itens.
• ⚡ Auto-setup: list + item panel configura sites no estilo do Maps com um toque: ele encontra a lista, clica no primeiro item, aprende o painel e verifica um segundo.
• Fast mode: read the site's own data. Muitos sites carregam suas listas como dados em segundo plano. O Fast mode monitora esses dados, escolhe o que corresponde à página e os lê diretamente. Ele costuma ser mais rápido e ter mais colunas. Pressione Find the API, use o site normalmente e, em seguida, Check again. Nem todo site possui esses dados; nesse caso, use o método normal.
• Get the full text: abre o "Show more" de um campo antes de lê-lo.

Settings

• Appearance: Auto · Light · Dark. O botão ☀/🌙 na barra superior também alterna.
• Account & plan e Help & feedback: relatar um problema, enviar uma ideia, o guia, enviar um e-mail.
• Scraping:
  • Respect robots.txt (ativado por padrão): as páginas que um site pede para os bots evitarem não são lidas, e o Rowvana avisa o motivo.
  • Page load timeout (30 s): uma página que trava é ignorada.
  • Wait between item pages (1 s é seguro para a maioria dos sites).
• Images: para onde vão os arquivos de imagem baixados (uma pasta em Downloads ou uma de sua escolha).
• Advanced: for experienced users:
  • Proxies (uma lista de proxies ou um serviço de proxy) para sites que bloqueiam após muitas páginas.
  • API keys: cada chave tem um Site e só é enviada para esse site.
  • Developer mode grava um registro detalhado que você pode nos enviar.
• Danger zone: Reset Rowvana… (marque o que deseja limpar) e exclua sua conta.

Conta e planos

Gratuito, sem conta: colete, visualize, baixe e copie até 5 páginas por execução e 500 linhas por download.

Uma conta gratuita adiciona scrapers salvos e o teste gratuito de um plano pago. Entre com Sign in with Google ou com um e-mail e senha (Create an account, pelo menos 8 caracteres). Com uma conta de e-mail, confirme seu endereço no link que enviamos antes de iniciar o teste ou comprar. Forgot password? envia um link de redefinição.

• Planos pagos aumentam ou removem os limites e adicionam recursos como detalhes da página do item, painéis do Maps, Fast mode, arquivos de imagem e proxies. Os detalhes e preços estão na página de preços.
• Um controle que o seu plano não inclui exibe um pequeno selo com o plano de que ele precisa.
• Sua foto → menu: plano e suas datas, Manage plan, Report a problem, Sign out. O anel ao redor da foto mostra quanto tempo do período do plano ainda resta.
• Uma conta, um computador por vez. Entrar em outro lugar desconecta este; Sign in here traz a sessão de volta.
• Os dados de cada conta são mantidos separados no navegador. Sair da conta mostra um espaço de trabalho vazio e não exclui nada.

Ajuda e problemas comuns

• 🔔 Notificações: novas versões, ofertas, lembretes de planos e nossas respostas aos seus relatos. As novas mostram um número no sino e no ícone da barra de ferramentas.
• Report a problem (Settings → Help & feedback, no menu da sua foto ou na tela de erro):
  • Escreva o que aconteceu.
  • Mantenha Include technical details marcado; What's included? lista exatamente o que é enviado.
  • Dados extraídos, proxies e chaves nunca são incluídos.
  • Respondemos por e-mail e no sino.

Boas práticas

• Verifique a prévia primeiro, depois colete várias páginas.
• Comece aos poucos: 20 páginas de itens e, depois, mais.
• Não tenha pressa com os sites: mantenha a espera entre as páginas de itens em 1 segundo ou mais.
• Salve os scrapers que você vai reutilizar e execute-os com um clique na próxima vez.
• Faça login no site você mesmo primeiro se ele precisar de login. O Rowvana usa a sessão do seu navegador.
• Siga as regras do site: leia os Termos de Serviço, respeite o robots.txt e tome cuidado com dados pessoais.