Google Sheets

A busca dentro de uma planilha: uma fórmula que lista os sites cujo código-fonte contém um trecho de código e um menu que exporta uma consulta inteira para uma nova aba. Livre para copiar, funciona com o seu token da API.

=PUBLICWWW(A1)                    websites whose page source contains the query in A1
=PUBLICWWW(A1, 50, "url,rank")    50 rows, only the url and rank columns
=PUBLICWWW_COUNT(A1)              how many websites match

Configuração

1. Abra uma planilha e vá em Extensões > Apps Script.
2. Substitua o conteúdo de Code.gs pelo Code.gs do repositório e salve.
3. Recarregue a planilha. Aparece um menu PublicWWW; escolha Set API token e cole um token da sua página de perfil. A API exige um plano pago.
4. O Google pede uma única vez a autorização do script: ele lê e grava apenas esta planilha e se conecta a api.publicwww.com.

O token fica guardado nas propriedades do script, então qualquer pessoa que possa editar o script desta planilha consegue lê-lo. Compartilhe o acesso de edição com isso em mente, ou dê à planilha um token exclusivo, que você pode excluir na página de perfil.

Como escrever a consulta

A consulta é a mesma da caixa de busca; veja a sintaxe de consulta. As aspas fazem diferença: "angular.min.js" com aspas é exatamente essa string; sem elas, são várias palavras. Dentro de uma fórmula, as aspas são escritas duas vezes, =PUBLICWWW("""angular.min.js"""), então é mais fácil digitar a consulta, com as aspas, em uma célula e fazer referência a ela: =PUBLICWWW(A1).

As funções

• PUBLICWWW(query, [rows], [columns], [header]): um site por linha, do mais popular para o menos popular. rows: 10 por padrão, até 1000 em uma fórmula. columns: qualquer combinação de domain, url, rank, separadas por vírgula; as três por padrão. header: TRUE coloca os nomes das colunas na primeira linha. rank fica vazio para um site sem posição no ranking de popularidade; se nada for encontrado, a célula fica vazia.
• PUBLICWWW_COUNT(query): o número de sites correspondentes.

Uma fórmula faz uma busca quando é inserida ou quando os argumentos dela mudam, e a resposta fica guardada por seis horas, então reabrir a planilha não gasta buscas de novo. Cada fórmula nova consome uma busca da cota diária do plano.

Como exportar uma consulta inteira

PublicWWW > Export a query to a new sheet grava em uma nova aba todas as linhas que o seu plano cobre para a consulta, com os totais em uma nota na primeira célula. Uma exportação muito grande pode esbarrar no limite do Google de seis minutos por execução de script; para listas de centenas de milhares de linhas, use a API diretamente: format=csv abre em qualquer planilha.

Quando uma célula mostra #ERROR!

Passe o mouse sobre a célula para ver o motivo.

Todos os códigos: Erros.