Semantic Scholar Skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Pesquisa: relevância, volume, snippets, correspondência de título, autor
Resolver por DOI/arXiv/PMID/PMCID/MAG/ACL/SHA/URL/CorpusId
Travessia do gráfico de citação (para frente + para trás, paginado)
Recomendações: similaridade de semente única ou multi-semente positiva/negativa
Lote: até 500 artigos / 1000 autores por solicitação
Exportações: BibTeX, Markdown, JSON

Demo ao vivo

Como fica na prática

semanticscholar-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "semanticscholar-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/semanticscholar-skill.git",
        "~/.claude/skills/semanticscholar-skill"
      ],
      "_inferred": false
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "semanticscholar-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/semanticscholar-skill.git",
        "~/.claude/skills/semanticscholar-skill"
      ],
      "_inferred": false
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "semanticscholar-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/semanticscholar-skill.git",
        "~/.claude/skills/semanticscholar-skill"
      ],
      "_inferred": false
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "semanticscholar-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/semanticscholar-skill.git",
        "~/.claude/skills/semanticscholar-skill"
      ],
      "_inferred": false
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "semanticscholar-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/semanticscholar-skill.git",
        "~/.claude/skills/semanticscholar-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "semanticscholar-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Agents365-ai/semanticscholar-skill.git",
          "~/.claude/skills/semanticscholar-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add semanticscholar-skill -- git clone https://github.com/Agents365-ai/semanticscholar-skill.git ~/.claude/skills/semanticscholar-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Semantic Scholar Skill

Estruture uma revisão da literatura em torno de um papel semente

👤 Estudantes de pós-graduação, pesquisadores iniciando uma revisão ⏱ ~45 min intermediate

Quando usar: Você tem um papel âncora forte e deseja construir a literatura circundante.

Pré-requisitos

Habilidade instalada — git clone em ~/.claude/skills/semanticscholar-skill

Fluxo

Resolva a semente

Resolva 10.1038/s41586-020-2649-2 e obtenha seus metadados completos.✓ Copiado

→ Objeto de trabalho completo com resumo + áreas de estudo
Extrair referências + citações

Obtenha as referências da semente e os 50 principais artigos que citaram, classificados por influência.✓ Copiado

→ Duas listas classificadas com locais + anos
Exportar Markdown com chaves BibTeX

Exporte o conjunto combinado como Markdown com entradas BibTeX que posso colocar no Zotero.✓ Copiado

→ Markdown com citekeys inline + bloco bibtex

Resultado: Um esqueleto inicial de revisão literária baseado em dados de citações reais.

Armadilhas

Supondo que o artigo mais citado seja o artigo mais relevante — Ler resumos; use recomendações com sementes positivas/negativas para refinar

Combine com: paper-fetch-skill · zotero

Crie o perfil de um autor para uma entrevista, palestra ou revisão de mandato

👤 Presidentes de programa, jornalistas, comitês de contratação ⏱ ~15 min beginner

Quando usar: Você precisa de um instantâneo rápido e preciso do registro de publicação de alguém.

Fluxo

Encontre o autor

Pesquise os autores 'Yann LeCun' e escolha o da NYU/Meta.✓ Copiado

→ ID do autor + afiliações + índice h
Obtenha publicações

Liste as 50 principais publicações por contagem de citações; agrupar por áreas de estudo.✓ Copiado

→ Lista agrupada com contagens; local + ano por artigo

Resultado: Um perfil de autor defensável com dados reais.

Armadilhas

Erros de desambiguação – nomes comuns correspondem a várias pessoas — Sempre inspecione a afiliação e o sinal de coautor antes de confirmar

Obtenha recomendações do que você gostou e não gostou

👤 Pesquisadores construindo uma lista de leitura ⏱ ~20 min intermediate

Quando usar: Você tem 5 artigos que gostou e 2 que não gostou; encontre mais nesse espaço.

Fluxo

Forneça sementes

Sementes positivas: [DOIs]. Sementes negativas: [DOIs]. Recomendo 20 artigos.✓ Copiado

→ Recomendações classificadas tendenciosas para os positivos, longe dos negativos
Filtro

Somente locais com ano ≥ 2022 e acesso aberto = verdadeiro.✓ Copiado

→ As recomendações filtradas incluem apenas trabalhos OA pós-2022

Resultado: Uma lista personalizada que você realmente gostaria de ler.

Metadados de busca em lote para uma longa lista de leitura

👤 Qualquer pessoa importando uma bibliografia ⏱ ~25 min intermediate

Quando usar: Você tem mais de 100 DOIs e precisa de metadados de uma só vez.

Fluxo

Envie o lote

Metadados de busca em lote para esses 200 DOIs; exportar BibTeX.✓ Copiado

→ Resposta única cobrindo todos; O fluxo do BibTeX segue
Lidar com erros

Para IDs que não foram resolvidos, tente match_title como substituto.✓ Copiado

→ A pesquisa alternativa fecha a maioria das lacunas

Resultado: Bibliografia limpa e consistente pronta para Zotero.

Armadilhas

Excedendo 500 artigos por chamada em lote — Pedaço em 500; habilidade lida com limites de taxa entre pedaços

Combine com: zotero

Combinações

Combine com outros MCPs para 10× de alavancagem

semanticscholar-skill + paper-fetch-skill

Use o Semantic Scholar para descobrir e depois buscar os PDFs

Pesquisa Semântica Acadêmica; busque PDFs de acesso aberto para os 10 principais resultados.✓ Copiado

semanticscholar-skill + zotero

Importe via Zotero para gerenciamento de biblioteca local

Exportar BibTeX; importe para o Zotero e marque a coleção.✓ Copiado

semanticscholar-skill + arxiv

Referência cruzada com metadados arXiv

Para cada ID arXiv em minha lista, enriqueça com contagens de citações do Semantic Scholar.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_relevance	query	Pesquisa de papel padrão	1 request
search_bulk	query + filters	Resultados em massa para filtragem downstream	1 request
search_snippets	query	Encontre artigos por frases no texto	1 request
match_title	title	Resolver um artigo com um título impreciso	1 request
get_paper	ID (DOI/arXiv/...)	Quando você tem um identificador	1 request
get_citations / get_references	paper id, limit	Percorra o gráfico de citações	1 request
find_similar / recommend	seed(s) (pos + neg)	Recomendações semelhantes e refinadas	1 request
batch_papers / batch_authors	array of IDs	Grandes listas de leitura	1 request
search_authors	name	Autores de perfil	1 request
export_bibtex / export_markdown / export_json	papers[]	Etapa final de exportação	0

Custo e limites

O que custa rodar

Cota de API: API pública do Semantic Scholar – taxa limitada; habilidade impõe lacuna de 1,1s e espera exponencial
Tokens por chamada: Os metadados são pequenos; resumos e trechos maiores
Monetário: Gratuito - Semantic Scholar é público
Dica: Lote sempre que possível – uma única chamada em lote supera centenas de chamadas get_paper.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhuma credencial é necessária para endpoints públicos. Chave de API opcional para limites mais altos – mantenha-a no env, não na configuração.

Saída de dados: Consultas e resultados vão para api.semanticscholar.org.

As contagens de citações são instantâneos – não compare contagens feitas com meses de intervalo como evidência de tendências sem anotar as datas.

Solução de problemas

Erros comuns e correções

429 Muitas solicitações

A Skill já cuida disso; se for persistente, diminua o ritmo do lote ou solicite uma chave de API.

Verificar: Inspect response headers for x-rate-limit-*

Artigo não encontrado pelo DOI

Volte para match_title com o título do artigo; Cerca de 10% dos artigos não possuem cobertura DOI.

Verificar: match_title + grep output

Desambiguação do autor errada

Filtre por afiliação ou coautor antes de confirmar; O Semantic Scholar ocasionalmente mescla pessoas distintas.

Verificar: Inspect the author's publication list for coherence

Alternativas

Semantic Scholar Skill vs. outros

Alternativa	Quando usar	Troca
arxiv	Você só se preocupa com o arXiv, não com o gráfico de citações mais amplo	Cobertura mais estreita; sem passagem de citação
paper-fetch-skill	Você tem IDs e deseja mais PDFs do que metadados	Fetcher, não um mecanismo de pesquisa
asta-skill	Você quer um sabor de pesquisa acadêmica diferente	Fonte diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills