Guia do curador
Coordene o seu grupo de pesquisa dentro do ferdy.
O curador convida os pesquisadores, acompanha os projetos que eles compartilham, ajuda na definição das colunas, conversa pelo mural de cada projeto e organiza os créditos do grupo — com a cortesia do ferdy, com o cofre da equipe ou com os dois. Abaixo, tudo o que ele pode (e não pode) fazer, em perguntas e respostas.
O papel do curador
Curador é quem coordena um grupo de pesquisa no ferdy: orientador, professor de programa, líder de laboratório. Ele não faz a extração pelo pesquisador — acompanha, orienta e organiza os créditos.
Quem pode ser curador?+
Qualquer conta do ferdy que a equipe do ferdy promova ao papel de curador. Não existe autoatendimento: crie sua conta normalmente, ative o e-mail e peça a promoção pelo e-mail [email protected] (diga o nome do grupo e a instituição). Ao ser promovido, sua equipe é criada na hora com o nome "Equipe de <seu nome>" — você pode renomear.
O que muda no menu quando viro curador?+
Aparece a área Equipe. Nela ficam os pesquisadores, os convites, os projetos compartilhados, o cofre, as cotas e o orçamento de cortesia. Você continua com Projetos, Buscar artigos e Créditos para o seu próprio uso.
O curador vê a conta dos pesquisadores?+
Vê só o que é da equipe: o saldo do pesquisador (o número), quanto ele já recebeu de cortesia, quanto usou do cofre, quantos projetos compartilhou e quando processou pela última vez. Não vê compras, extrato, senha nem projetos privados de ninguém.
Posso ter mais de uma equipe? E o pesquisador?+
Cada curador tem uma equipe. Cada pesquisador participa de uma equipe por vez — para trocar, ele sai da atual (em Minha conta) e aceita o convite da nova.
Montar a equipe
A entrada é sempre por convite e aceite. Ninguém passa a ser acompanhado sem concordar.
Como convido um pesquisador?+
Equipe → Convidar pesquisador: informe o e-mail e, se quiser, uma frase. A pessoa recebe um link que vale 14 dias. Quem já tem conta entra e aceita; quem não tem cria a conta pelo próprio link (o e-mail já vem preenchido), ativa e é levado de volta ao convite. Você pode reenviar ou cancelar um convite pendente.
O que o pesquisador vê antes de aceitar?+
Quem convidou, o nome da equipe, a sua mensagem e um resumo do que muda: o curador passa a ver os projetos que ele escolher compartilhar, pode ajudar na definição das colunas, deixar mensagens e liberar créditos. Projetos privados continuam só dele. Ele pode recusar.
O pesquisador precisa compartilhar todos os projetos?+
Não. Cada projeto é uma decisão dele: ao criar um projeto, a caixa "Compartilhar com a equipe" vem marcada por padrão, mas pode ser desmarcada; depois, na barra do projeto, ele alterna entre "compartilhado" e "privado" quando quiser. Projetos criados antes de entrar na equipe nascem privados.
Como removo alguém da equipe? E se a pessoa quiser sair?+
Equipe → Remover (com confirmação). A pessoa recebe um e-mail, todos os projetos dela voltam a ser privados e a cota do cofre deixa de valer. Para sair por conta própria, o pesquisador usa "Sair da equipe" em Minha conta. Em ambos os casos, os créditos que ele já recebeu de cortesia continuam valendo até vencer.
Posso renomear a equipe?+
Sim, em Equipe → "Renomear a equipe". O nome aparece nos convites e nos e-mails.
Acompanhar e ajudar nos projetos
Dentro de um projeto compartilhado o curador enxerga tudo o que o pesquisador enxerga. A diferença está no que pode alterar.
O que vejo em um projeto compartilhado?+
A Definição completa (as colunas, as instruções de cada uma e o prompt que o ferdy monta), a aba Artigos (fila, o que já foi processado e as falhas com o motivo), a aba Resultados (a tabela linha a linha, o detalhe de cada campo e a exportação em xlsx, csv, pdf ou json) e a aba Mensagens.
Posso mexer na definição do projeto?+
Pode — e é a principal forma de orientar. Você edita rótulos e instruções das colunas e aprova a definição, exatamente como o dono faria, desde que a fila de artigos esteja parada. Ao aprovar, o ferdy registra uma mensagem automática no mural do projeto ("Alterei a definição: N colunas aprovadas…") e o pesquisador é avisado por e-mail.
O que o curador não pode fazer no projeto de outra pessoa?+
Enviar artigos (upload ou pela busca), excluir linhas da tabela, renomear ou excluir o projeto, avaliar a ferramenta em nome do pesquisador e retirar o projeto da equipe. Essas ações são só do dono. Exportar a tabela, sim, pode.
Como funciona o mural de mensagens?+
Cada projeto compartilhado tem a aba Mensagens: um mural com autor e data, sem edição nem exclusão (é o histórico da orientação). O outro lado recebe um resumo por e-mail — no máximo um por projeto a cada 30 minutos — e vê o contador de mensagens novas na lista de projetos e na aba. Se o pesquisador retirar o projeto da equipe, ele continua lendo o histórico, mas o mural fecha.
E as bases de busca? O que a equipe alcança?+
A busca do ferdy consulta sete bases abertas (OpenAlex, PubMed/Europe PMC, DOAJ, ERIC, BDTD, Oasisbr e arXiv) para qualquer pessoa, sem custo e sem configuração. Quem é de instituição assinante do Web of Science pode somar a própria chave gratuita da Clarivate em Minha conta → Integrações e passa a ver o WoS na mesma pesquisa, com as citações. A licença da Clarivate é pessoal — uma chave por membro da instituição —, então cada pesquisador cadastra a sua: a sua chave de curador vale só para as suas buscas, não para as da equipe. Vale orientar os seus orientandos a gerarem a deles.
Eles já têm a lista de artigos. Precisa buscar de novo?+
Não. Na aba Artigos de cada projeto há o campo para colar a lista pronta — DOI, link doi.org, DOI no meio de uma referência, PMID do PubMed ou id do arXiv, até 50 por vez. O ferdy resolve a ficha de cada artigo e tenta o PDF sozinho; o que for de editora paga aparece como "PDF não obtido" (sem consumir crédito) para a pessoa baixar pelo acesso da instituição e enviar. É o caminho natural para quem chega com a seleção já feita no Rayyan, numa planilha ou exportada de outra base.
Onde vejo a situação da equipe de uma vez?+
Na página Equipe: cada pesquisador com saldo, cota, cortesia recebida, projetos compartilhados e último processamento; cada projeto com estado, linhas, falhas e o que está na fila; os convites pendentes; o cofre; o orçamento de cortesia.
Chave do Web of Science
Quem é de instituição assinante tem direito a uma chave gratuita da API da Clarivate, que faz o Web of Science entrar na busca do ferdy junto com as bases abertas. A licença é pessoal: cada pesquisador gera a sua.
Quem tem direito à chave gratuita?+
Qualquer membro de instituição que assine o Web of Science — no Brasil, normalmente via Portal CAPES. Para confirmar, abra webofscience.com pela rede da universidade ou com a sessão CAFe ativa: se a busca completa abre, a instituição assina. Quem não é de instituição assinante continua com as sete bases abertas, sem configurar nada.
Passo 1 — criar a conta no portal da Clarivate+
Acesse developer.clarivate.com e entre em Sign in (ou registre-se). Use o e-mail institucional e, se possível, faça isso conectado à rede da universidade ou com a sessão do CAFe ativa — é esse vínculo que faz a Clarivate reconhecer você como membro da instituição assinante. Conta criada com e-mail pessoal, de casa, costuma acabar apenas com o plano de teste.
Passo 2 — registrar uma aplicação+
No menu, Applications → Register an application. Preencha: Application ID (sem espaços, ex.: ferdy-busca), Name (ex.: ferdy), Description — descreva o uso real, por exemplo "busca bibliográfica para revisões sistemáticas por meio da ferramenta ferdy; chave pessoal, guardada cifrada no servidor; membro da instituição assinante, via Portal CAPES" — e Client Type: Confidential (server side). Não é preciso configurar OAuth nem URLs de redirecionamento.
Passo 3 — assinar a Web of Science Starter API+
APIs → Web of Science Starter API → Subscribe (ou "Add to application"), escolhendo a aplicação criada. Prefira o plano Free Institutional Member, destinado a membros da instituição assinante, com uma chave por pessoa. O plano Free Trial (50 requisições por dia, para estudantes e acadêmicos com e-mail institucional, sem dados de citação) serve para experimentar enquanto o institucional não sai. Se o institucional não aparecer, veja a última pergunta desta seção.
Passo 4 — aguardar a aprovação+
A assinatura fica como "Subscription approval is pending". A Clarivate revisa e avisa por e-mail quando libera, informando que a mudança pode levar até seis horas para entrar em vigor. Na experiência que registramos, o e-mail chegou às 9h38 e a chave já respondia às 10h24 — mas essa janela entre "aprovado" e "funcionando" existe e explica o erro mais confuso do processo.
Passo 5 — copiar a chave certa+
Em Applications → sua aplicação, a linha da assinatura da Starter API tem a coluna API Key com o botão Reveal. A chave tem 40 caracteres. Atenção: a aplicação também mostra Client ID e Client Secret, que NÃO são a chave da API — colar o Client ID gera um erro de autorização que parece problema de aprovação.
Passo 6 — colar no ferdy+
Minha conta → Integrações → Web of Science: cole a chave e salve. O ferdy faz uma consulta de teste antes de guardar e mostra o plano e a cota diária devolvidos pela Clarivate; se o teste falhar, a chave não é salva. A partir daí o Web of Science aparece na mesma busca das bases abertas, com as citações de cada artigo.
Deu erro. O que cada mensagem significa?+
"A credencial foi recusada": a chave existe, mas o acesso ao Web of Science ainda não está ativo — se a aprovação saiu há menos de seis horas, aguarde; se já passou, a conta provavelmente não está vinculada à assinatura da instituição. "Esta chave não tem acesso à Starter API": a chave assina outro produto da Clarivate, então volte em APIs e assine a Starter. "Chave não reconhecida": espaço sobrando, caractere a mais ou Client ID no lugar da API Key. "Limite de consultas atingido": a cota diária acabou e volta no dia seguinte, sem afetar as bases abertas.
O Web of Science traz o PDF?+
Não. A API devolve a ficha do artigo e as citações, sem resumo e sem arquivo. Os artigos de editora paga aparecem como "PDF não obtido", sem consumir crédito, para o pesquisador baixar pelo acesso da instituição e enviar. O ganho está na cobertura: numa busca real que medimos, 83% dos DOIs recentes trazidos pelo Web of Science não apareciam nas bases abertas para o mesmo recorte.
Posso usar a minha chave para a equipe inteira?+
Não — e o ferdy não permite. A licença da Clarivate é pessoal, uma chave por membro da instituição. A sua chave vale só para as suas buscas: fica cifrada, vinculada à sua conta, não é exibida de novo depois de salva e nem os resultados são compartilhados (o cache do Web of Science é separado por usuário). Oriente cada orientando a gerar a própria chave seguindo estes passos.
O plano institucional não aparece para mim. E agora?+
É o obstáculo mais comum e quase sempre significa que a conta do portal não foi associada à assinatura da universidade. Na ordem: (1) refaça o acesso a partir da rede da instituição ou com a sessão CAFe ativa, usando o e-mail institucional; (2) abra um chamado em Contact/Support no portal pedindo a vinculação da conta à assinatura da sua instituição; (3) procure a biblioteca da universidade e pergunte quem administra o Web of Science lá — é essa pessoa que resolve a integração institucional. Enquanto isso, o Free Trial já permite testar.
Convidados em um projeto
Além da equipe, qualquer pesquisador pode convidar alguém para trabalhar em um projeto específico — inclusive gente de fora do seu grupo. Vale a pena entender como isso conversa com a curadoria.
O que é um convidado de projeto?+
É alguém que recebeu convite para trabalhar em UM projeto, sem entrar em equipe nenhuma. Na aba Pessoas do projeto, o dono informa o e-mail e envia o convite; quem não tem conta no ferdy cria pelo próprio link. O convite vale 14 dias e cada projeto aceita até 10 convidados.
O que o convidado pode fazer?+
Trabalha no projeto como o dono: define e aprova as colunas, envia PDFs, busca artigos, cola listas de DOIs, acompanha a fila, confere a tabela, exclui linhas, exporta e escreve no mural. Continuam só do dono: apagar ou renomear o projeto, convidar e remover pessoas, compartilhar o projeto com a equipe e avaliar a ferramenta.
Isso é a mesma coisa que entrar na minha equipe?+
Não, e os dois convivem. A equipe é o vínculo com você, curador: você acompanha os projetos que o pesquisador compartilhar, ajuda na definição e pode liberar créditos. O convite de projeto é pontual, vale só para aquele projeto e é decidido pelo dono dele — você não precisa aprovar.
Um convidado pode gastar o cofre da minha equipe?+
Não. Quando quem envia o artigo é um convidado, o ferdy usa apenas a carteira pessoal do dono do projeto; o cofre da equipe e a cota que você concedeu ficam intactos. Se o dono depender da cota e tiver pouco saldo próprio, o envio do convidado falha por saldo — e ninguém é cobrado.
Eu fico sabendo quando entra alguém num projeto da minha equipe?+
Sim. Se o projeto está compartilhado com a sua equipe e o dono convida alguém, você recebe um e-mail com o nome de quem entrou. É importante porque essa pessoa passa a ler e escrever no mural do projeto, inclusive as orientações que você já deixou lá — sem fazer parte da sua equipe.
Quem sai, ou é removido, perde o quê?+
O acesso cai na hora. O que a pessoa já processou continua no projeto, porque o trabalho é do projeto. Se ela deixou artigos na fila, eles continuam sendo processados e cobrados do dono — o aviso na tela informa quantos são.
Como sei quem enviou cada artigo?+
Na fila do projeto, os artigos enviados por convidados aparecem com "enviado por" e o nome da pessoa. Os do dono não levam marca.
Créditos: cortesia, cofre e cota
Há duas formas de o curador colocar créditos na mão dos pesquisadores. Elas convivem e têm origens diferentes: a cortesia sai de um orçamento cedido pelo ferdy; o cofre sai do bolso do grupo.
Relembrando: o que é um crédito?+
Uma página de PDF processada com sucesso. Um artigo de 12 páginas que vira linha custa 12 créditos; artigos que falham (ilegíveis, sem PDF, erro do agente) não custam nada.
O que é a cortesia do curador?+
Um orçamento que o ferdy cede a cada curador para apoiar a equipe, renovável por período e não cumulativo. Em Equipe → pesquisador → "Liberar créditos", você informa a quantidade e o motivo (fica no extrato do pesquisador com o seu nome); o ferdy pede sua senha uma vez. Os créditos entram no saldo pessoal do pesquisador, com validade própria. A cortesia é sempre positiva e só para membros ativos. O valor do orçamento e o período aparecem na sua página Equipe.
Como funciona a renovação do orçamento?+
É uma janela móvel: o ferdy soma o que você liberou no período; o que sair dessa janela libera espaço de novo. Não acumula — o teto é sempre o mesmo. A página Equipe mostra "usados", "disponíveis" e a data em que o próximo lançamento antigo sai da janela.
O que é o cofre da equipe?+
Um saldo comprado pelo curador para o grupo: em Créditos, você escolhe "Comprar para: o cofre da equipe" e paga por Pix ou cartão como qualquer pacote. Os créditos ficam na carteira da equipe, com a validade normal das compras, e nunca se misturam com o seu saldo pessoal. Só o curador compra para o cofre.
E a cota?+
A cota é quanto cada pesquisador pode consumir do cofre, no total. Você define em Equipe → "Cota do cofre" (0 = sem acesso) e pode mudar a qualquer momento; se aumentar, o pesquisador recebe um e-mail. A cota é permissão, não transferência: o que ele não usar continua no cofre para os outros.
Na hora de processar, de onde sai o crédito?+
Primeiro do cofre da equipe, até a cota do pesquisador; o que faltar sai do saldo pessoal dele (cortesia e compras próprias). Se cofre + saldo pessoal não cobrirem as páginas do artigo, o artigo falha por saldo insuficiente e nada é cobrado. Cada parte aparece como uma linha no extrato dele — a do cofre marcada "cofre da equipe".
Como acompanho o uso do cofre?+
Em Equipe: o cartão "Cofre da equipe" (saldo e próximo vencimento), a coluna "Cota do cofre" com "usou X · restam Y" por pesquisador e a seção "Movimentos do cofre" (compras, consumo por pesquisador e artigo, expirações). Em Créditos, o cofre aparece abaixo dos seus lotes pessoais.
Cortesia ou cofre: qual usar?+
Use a cortesia para dar o primeiro empurrão (um piloto, uma disciplina, um TCC) sem custo para o grupo. Use o cofre quando o grupo tem verba própria e quer controlar quem gasta quanto. Depois que a cortesia e a cota acabam, o pesquisador compra o próprio pacote, como qualquer usuário.
O que acontece com o cofre se eu deixar de ser curador?+
O que restar no cofre volta para o seu saldo pessoal, com o registro no extrato. Os pesquisadores saem da equipe, os projetos deles voltam a ser privados e a cortesia que já receberam continua valendo até vencer.
Privacidade e limites
O desenho do modo equipe parte do consentimento do pesquisador.
O pesquisador sabe o que estou vendo?+
Sim. Ele decide o que compartilha, vê "compartilhado" na barra do projeto e recebe e-mail a cada mensagem sua e a cada crédito liberado. O mural é o registro do que foi combinado.
Os PDFs ficam guardados?+
Não. O arquivo é usado só durante o processamento e apagado em seguida, com sucesso ou falha. O que fica é a tabela extraída, que o dono pode excluir.
Preciso de alguma aprovação para ser curador da minha instituição?+
Não há vínculo formal com a instituição: o papel é da sua conta. Se o grupo quiser nota fiscal das compras para o cofre, fale com [email protected].
Coordena um grupo e quer ser curador?
Crie sua conta, ative o e-mail e escreva para [email protected] com o nome do grupo e a instituição.