literature-search-openalex

Query the OpenAlex scholarly database for papers, authors, institutions, and citation metrics.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/xlinh2301/EditCTC --skill literature-search-openalex-xlinh2301
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: literature-search-openalex
Source: https://github.com/xlinh2301/EditCTC/tree/main/.agents/skills/literature-search-openalex
Command: npx skills add https://github.com/xlinh2301/EditCTC --skill literature-search-openalex-xlinh2301

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Searching academic literature, resolving DOIs, and gathering bibliometric data manually across publisher sites is slow and error-prone. This Skill provides structured CLI access to the OpenAlex database so you can find papers, authors, institutions, and citation statistics programmatically. ## Core Features & Use Cases - Entity Resolution and Lookup: Resolve names to OpenAlex IDs, fetch full metadata for works, authors, sources, institutions, topics, and more, including DOI lookups. - Filtering and Aggregation: Filter, sort, group, and sample scholarly records to compute bibliometrics such as citation counts, h-index, and publication trends by year or institution. - Open-Access PDF Download: Download open-access PDFs with automatic fallback to alternative locations listed in work metadata. - Use Case: Find Geoffrey Hinton's most-cited papers by resolving his author ID, filtering works by that ID, sorting by citation count, and exporting the slimmed results to JSON. ## Quick Start Ask the assistant to use the OpenAlex skill to find the ten most-cited papers by a specific author and list their 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 academic papers using the OpenAlex API?▼

Use the filter command with --search for full-text queries or --filter for structured expressions like publication_year:2023. Resolve names to OpenAlex IDs first, then filter by those IDs for precise results.

How do I find all publications by a specific author in OpenAlex?▼

First run the resolve command on the author's name to get their OpenAlex ID, then filter works with authorships.author.id set to that ID. Sort by cited_by_count:desc to rank by citations.

Does OpenAlex API access require an API key?▼

No, the skill works without a key using the free polite pool, but rate limits are very limited. Providing an OPENALEX_API_KEY enables roughly 10 requests per second and unlocks PDF downloads from the premium content server.

Can I download open-access PDFs through OpenAlex?▼

Yes, the download-pdf command fetches PDFs for a given work ID, trying the OpenAlex content server first and falling back to pdf_url locations in the work metadata. Downloaded files are validated for the %PDF- header.

Why does my OpenAlex query return a 429 rate limit error?▼

A 429 error means you exceeded the request budget, which is very small without an API key. Wait and retry, or add an OPENALEX_API_KEY to your .env file to raise the limit to about 10 requests per second.

What is the difference between resolve and filter in OpenAlex queries?▼

Resolve converts a name into candidate OpenAlex IDs with hints for disambiguation, while filter retrieves entities matching structured criteria. Always resolve names to IDs before filtering, since filtering by name directly is unreliable.