literature-search-openalex

Resolve names and DOIs into OpenAlex IDs for scholarly literature search.

2.7k|283|Updated May 13, 2026
One-click install
npx skills add https://github.com/google-deepmind/science-skills --skill literature-search-openalex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: literature-search-openalex
Source: https://github.com/google-deepmind/science-skills/tree/main/skills/literature_search_openalex
Command: npx skills add https://github.com/google-deepmind/science-skills --skill literature-search-openalex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It removes the friction of finding, disambiguating, and citing scholarly sources by turning messy names, DOIs, and research queries into reliable OpenAlex entity IDs and structured results.

Core Features & Use Cases

  • Scholarly discovery across entity types: Query papers (works) and related entities like authors, institutions, topics, sources, publishers, funders, and keywords.
  • Safe, repeatable lookups: Uses a resolve-then-filter workflow to avoid incorrect matches, supports DOI lookups, and can download open-access PDFs for selected works.
  • Bibliometrics & taxonomy exploration: Supports sorting and filtering by citation-based metrics (e.g., cited-by counts) and exploring research taxonomies (domains/fields/subfields/topics, SDGs, etc.).
  • Operational guardrails: Encourages small outputs with field selection and pagination to reduce cost and context bloat, plus clear handling of rate limits and missing results.

Quick Start

Use the OpenAlex skill to find the top 10 open-access papers related to "graphene photodetectors" and return only their IDs, titles, years, and citation counts.

Frequently Asked Questions about literature-search-openalex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for scholarly papers and resolve them to OpenAlex IDs?

To search scholarly papers and resolve them to OpenAlex IDs, use the provided OpenAlex CLI via uv to run resolve and filter commands. This workflow disambiguates messy names and DOIs into reliable entity IDs before returning structured bibliometric results.

What is the best way to look up a DOI and find its open-access PDF?

The best way to look up a DOI and find its open-access PDF is using the download-pdf command in the OpenAlex CLI. It resolves the DOI into an OpenAlex ID first, then retrieves the open-access PDF for the selected work.

Can I retrieve bibliometric data like citation counts for specific authors and institutions?

Yes, you can retrieve bibliometric data like citation counts for authors and institutions. The Skill supports filtering and sorting across works, authors, institutions, and sources by cited-by counts and other metrics using the OpenAlex API.

Do I need an OPENALEX_API_KEY to search scholarly works, or are there rate limits?

You do not need an OPENALEX_API_KEY to search scholarly works, but it is optional for higher rate limits. The Skill includes operational guardrails to handle standard rate limits and encourages field selection to reduce context bloat.

Why does my literature search return empty results and how can I avoid incorrect matches?

Your literature search returns empty results when no matches are found, and the Skill never fabricates results on empty responses. To avoid incorrect matches, use the resolve-then-filter workflow to accurately disambiguate entities before applying filters.

Does this approach support exploring research taxonomies like topics and sustainable development goals?

Yes, this approach supports exploring research taxonomies including domains, fields, subfields, topics, and sustainable development goals. You can use the CLI to query and navigate these hierarchical taxonomy structures via the OpenAlex API.