literature-search-europepmc
Skill0 starsChanged 29 days agoApache-2.0View on GitHub
Search Europe PMC for scientific literature and download open-access full texts and PDFs. Retrieve full-text XML/plain text by PMCID, get citation lists and bibliography.
- Installs packages
4 other projects use a version of this, 4 of them edited.
Adopted by
Most recently taken up by
- 1stANUNNAKI/The-Counciledited, first seen Nov 16, 2026
- google-deepmind/science-skillsedited, first seen Nov 10, 2026
- 1stANUNNAKI/majlisedited, first seen Nov 8, 2026
- uppifyagency/boilerplate-saas-2026edited, first seen Jun 2, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 4
- google-deepmind/science-skills★ 3.5k99% same
- 1stANUNNAKI/majlis★ 297% same
- 1stANUNNAKI/The-Council★ 197% same
- uppifyagency/boilerplate-saas-2026★ 199% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository40 other files it gives its agents.
- vector-geneSkill
- alphafold-database-fetch-and-analyzeSkill
- alphagenome-atlas-website-linksSkill
- alphagenome-single-variant-analysisSkill
- alphagenome-variant-impact-scoreSkill
- chembl-databaseSkill
- clinical-trials-databaseSkill
- clinvar-databaseSkill
- credentialsSkill
- dbsnp-databaseSkill
- embl-ebi-olsSkill
- encode-ccres-databaseSkill
- ensembl-databaseSkill
- foldseek-structural-searchSkill
- gnomad-databaseSkill
- gtex-databaseSkill
- human-protein-atlas-databaseSkill
- interpro-databaseSkill
- jaspar-databaseSkill
- literature-search-arxivSkill
- literature-search-biorxivSkill
- literature-search-openalexSkill
- ncbi-sequence-fetchSkill
- openfda-databaseSkill
- opentargets-databaseSkill
- pdb-databaseSkill
- predictingthepastSkill
- protein-sequence-msaSkill
- protein-sequence-similarity-searchSkill
- pubchem-databaseSkill
- pubmed-databaseSkill
- pymolSkill
- quickgo-databaseSkill
- reactome-databaseSkill
- string-databaseSkill
- ucsc-conservation-and-tfbsSkill
- unibind-databaseSkill
- uniprot-databaseSkill
- uvSkill
- workflow-skill-creatorSkill
The file
We split this skill into the rules it gives an agent
8 rules. 4 are common, 0 are distinctive, and 4 are very specific to this project.
4
Common
Most of the 4 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 18
uv: Read the uv skill and follow its Setup instructions to ensure uv is installed and on PATH. - Very specific: line 20
User Notification: If .licenses/literature_search_europepmc_LICENSE.txt does not already exist in the workspace root directory then (1) …
- Common: line 30
NOT remove or override this filter.
- Common: line 34
Use the Wrapper: ALWAYS use the provided script rather than calling the API directly.
- Very specific: line 36
Output Files: All subcommands require --output to write results to a file.
- Common: line 38
List Sources: If this skill is used, ensure this is mentioned in the output AND list the URLs of all papers that were used in producing the …
- Very specific: line 44
All commands are subcommands of scripts/europepmc_api.py.
- Common: line 49
Search Europe PMC by query.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Europe PMC Database
A skill for searching, downloading, and exploring open-access papers from Europe PMC — a comprehensive, free life-science literature database with over 43 million abstracts and 9 million full-text articles.
Prerequisites
uv: Read theuvskill and follow its Setup instructions to ensureuvis installed and on PATH.- User Notification: If .licenses/literature_search_europepmc_LICENSE.txt does not already exist in the workspace root directory then (1) prominently notify the user to check the terms at https://europepmc.org/ and to always check the license of the papers retrieved by the skill for any restrictions, then (2) create the file recording the notification text and timestamp.
Core Rules
- Open Access Only: This skill exclusively searches open-access content.
The script automatically appends
OPEN_ACCESS:yto every search query. Do NOT remove or override this filter. - NEVER run python3 or python3 -c directly: the system Python does not necessarily have all key dependencies. Do not attempt to pip install or create new venvs.
- Use the Wrapper: ALWAYS use the provided script rather than calling the API directly. The script handles rate limiting (1 req/s) and errors.
- Output Files: All subcommands require
--outputto write results to a file. Read the output file separately to avoid context overflow. - List Sources. If this skill is used, ensure this is mentioned in the output AND list the URLs of all papers that were used in producing the output.
Utility Scripts
All commands are subcommands of scripts/europepmc_api.py. Rate limiting and
retries are handled automatically.
1. Search (search)
Search Europe PMC by query. Supports DOI lookup, keyword search, author search, PMID lookup, and the full Europe PMC search syntax.
# Look up a paper by DOI
uv run scripts/europepmc_api.py search "DOI:10.1038/s41586-021-03819-2" --output result.json
# Keyword search
uv run scripts/europepmc_api.py search "CRISPR cancer" --max_results 5 --output results.json
# Author search
uv run scripts/europepmc_api.py search "AUTH:Jumper J" --max_results 10 --output results.json
# PMID lookup
uv run scripts/europepmc_api.py search "EXT_ID:34265844 AND SRC:MED" --output result.json
# Sorted by citations
uv run scripts/europepmc_api.py search "machine learning" \
--sort "CITED desc" --max_results 20 --output results.jsonArguments:
query(str, required) — search query using Europe PMC syntax--output(str, required) — output JSON file path--max_results(int, default 10) — maximum results per page (max 1000)--result_type(str, defaultcore) —core(full metadata) orlite--cursor(str, default*) — cursor mark for pagination; pass thenextCursorMarkvalue from a previous response to get the next page--sort(str) — sort order, e.g.CITED desc,P_PDATE_D desc(publication date descending),P_PDATE_D asc
Output: JSON file with three fields:
hitCount(int) — total number of matching articlesnextCursorMark(str) — cursor for next page; empty string if no more pagesresults(list) — array of article metadata objects
Search Syntax Quick Reference:
DOI:10.xxxx/yyyy— look up by DOIEXT_ID:12345678 AND SRC:MED— look up by PMIDAUTH:surname initials— author searchTITLE:keyword— search in title onlyJOURNAL:name— search by journalPUB_YEAR:2024or(FIRST_PDATE:[2023-01-01 TO 2023-12-31])— date filterHAS_FT:y— restrict to articles with full text in Europe PMC- Boolean operators:
AND,OR,NOT
Note:
OPEN_ACCESS:yis automatically appended to all queries. You do not need to add it manually.
2. Download PDF (download_pdf)
Download an open-access PDF from Europe PMC by PMCID.
uv run scripts/europepmc_api.py download_pdf PMC8371605 --output alphafold.pdfArguments:
pmcid(str, required) — PubMed Central ID (e.g.,PMC8371605)--output(str, required) — filepath to save the PDF
Output: Saves the PDF to the specified file. Exits with an error if the PMCID is not found or the response is not a valid PDF. Whenever you download a PDF, check the pdf downloaded is not empty or corrupted.
3. Get Full Text (get_fulltext)
Retrieve the full text of an open-access article and save to a file. Returns
plain text (XML tags stripped) by default, or raw XML with --format xml.
# Get plain text (default)
uv run scripts/europepmc_api.py get_fulltext PMC8371605 --output fulltext.txt
# Get raw XML
uv run scripts/europepmc_api.py get_fulltext PMC8371605 --format xml --output fulltext.xmlArguments:
pmcid(str, required) — PubMed Central ID--output(str, required) — output file path--format(str, defaulttext) —text(plain text) orxml(raw JATS XML)
Output: Full text written to the specified file. Exits with an error if the article is not in the Europe PMC open-access subset.
Important: Only articles in the PMC Open Access Subset have full text available. If retrieval fails, use
searchto check theisOpenAccessfield and fall back to the abstract.
4. Get Citations (get_citations)
Retrieve articles that cite a given paper.
# Get citations for the AlphaFold paper (PMID 34265844)
uv run scripts/europepmc_api.py get_citations MED 34265844 \
--page_size 25 --output citations.jsonArguments:
source(str, required) — source database:MED(PubMed),PMC,PPR(preprints),PAT(patents)article_id(str, required) — article ID in the source database--output(str, required) — output JSON file path--page(int, default 1) — page number--page_size(int, default 25) — results per page
Output: JSON file with hitCount and citations array.
5. Get References (get_references)
Retrieve the reference list (bibliography) of a given paper.
# Get references from the AlphaFold paper
uv run scripts/europepmc_api.py get_references MED 34265844 \
--page_size 100 --output references.jsonArguments:
source(str, required) — source database:MED,PMC,PPR,PATarticle_id(str, required) — article ID in the source database--output(str, required) — output JSON file path--page(int, default 1) — page number--page_size(int, default 25) — results per page
Output: JSON file with hitCount and references array.
Common Workflows
DOI to PDF
# Step 1: Search for the PMCID
uv run scripts/europepmc_api.py search "DOI:10.1038/s41586-021-03819-2" --output result.json
PMCID=$(jq -r '.results[0].pmcid // empty' result.json)
# Step 2: Download the PDF
uv run scripts/europepmc_api.py download_pdf "$PMCID" --output paper.pdfPMID to Full Text
# Step 1: Find the PMCID from a PMID
uv run scripts/europepmc_api.py search "EXT_ID:34265844 AND SRC:MED" --output result.json
PMCID=$(jq -r '.results[0].pmcid // empty' result.json)
# Step 2: Get the full text
uv run scripts/europepmc_api.py get_fulltext "$PMCID" --output fulltext.txtCitation Graph Traversal
# Find what papers cite a landmark study, then check their references
uv run scripts/europepmc_api.py get_citations MED 34265844 --page_size 50 --output citing.json
# Parse a cited paper's PMID and explore its references
uv run scripts/europepmc_api.py get_references MED <CITING_PMID> --output refs.jsonSearch with Pagination
# First page
uv run scripts/europepmc_api.py search "CRISPR" --max_results 100 --output page1.json
# Extract cursor for next page
CURSOR=$(jq -r '.nextCursorMark // empty' page1.json)
# Next page
uv run scripts/europepmc_api.py search "CRISPR" --max_results 100 --cursor "$CURSOR" --output page2.jsonDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

