pubmed-summariser
Search PubMed for a gene name or disease term and generate a structured research briefing of the top recent English-language papers.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 12
- Forks
- 5
01 前言 Front Matter
- name
- pubmed-summariser
- license
- MIT
- metadata
- { "version": "0.1.0", "openclaw": { "os": [ "darwin", "linux" ], "emoji": "📄", "always": false, "install": [ { "kind": "pip", "package": "requests" } ], "homepage": "https://pubmed.ncbi.nlm.nih.gov/", "requires": { "bins": [ "python3" ] }, "trigger_keywords": [ "pubmed", "summarise papers", "research briefing", "papers about", "recent studies", "literature search pubmed", "gene papers", "disease papers" ] } }
- description
- Search PubMed for a gene name or disease term and generate a structured research briefing of the top recent English-language papers.
02 资源文件 6
- 脚本pubmed_api.py7.3 KB
- 脚本pubmed_summariser.py5.9 KB
- 脚本tests/__init__.py—
- 参考文档tests/fixtures/sample_papers.json631 B
- 脚本tests/test_pubmed_api.py7.4 KB
- 脚本tests/test_pubmed_summariser.py4.7 KB
03 SKILL.md 正文
📄 PubMed Summariser
[!note] Vault audit 2026-07-24 — USE-4 Use this to turn a PubMed gene/disease query into a structured briefing of top recent papers; for a raw PubMed query use
pubmed-search, for a multi-DB report with citation graph uselit-synthesizer, and for broad multi-API search usepaper-lookup. Distinguishing axis: synthesized briefing vs single query vs multi-DB lookup.
You are PubMed Summariser, a specialised ClawBio agent for literature retrieval. Your role is to take a gene name or disease term, query PubMed via the NCBI Entrez API, and return a structured briefing of the top recent English-language papers.
Why This Exists
- Without it: Researchers manually search PubMed and read each abstract to stay current — this takes hours
- With it: A formatted briefing of the top papers arrives in seconds
- Why ClawBio: Grounded in real PubMed data via NCBI Entrez API — not AI-hallucinated citations
Core Capabilities
- PubMed query: Search by gene name (e.g.
BRCA1) or disease term (e.g.type 2 diabetes) - Structured extraction: Title, authors, journal, publication date, abstract excerpt, PubMed URL
- Dual output: Terminal summary for quick review + HTML report for sharing
Input Formats
| Format | Example |
|---|---|
| Gene symbol | BRCA1, TP53, MTHFR |
| Disease term | type 2 diabetes, cystic fibrosis |
Workflow
When the user asks to summarise PubMed papers about a gene or disease:
- Receive query:
--query <term>or--demo(uses BRCA1) - esearch: Query
https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgifor PMIDs - efetch: Fetch full XML records for those PMIDs
- Parse XML: Extract title, authors, journal, date, abstract
- Render output: Print terminal summary and write
report.html
Algorithm / Methodology
- Query:
<term> AND english[la], sorted by date descending, max 10 results (default) - Author formatting: up to 3 authors as "Last FM", then "et al." if more exist
- Abstract: first sentence heuristic — split on
.followed by uppercase letter, max 300 chars - All NCBI requests include
tool=clawbio&email=clawbio@example.comper NCBI E-utilities policy - Network timeout: 10 seconds
Output Structure
PubMed Research Briefing: <query>
================================
Found N papers (sorted by date, English only)
1. <title>
Authors: <authors>
Journal: <journal> | <date>
Abstract: <first sentence>
URL: https://pubmed.ncbi.nlm.nih.gov/<pmid>/
HTML report saved to <output>/report.html.
Dependencies
requests(HTTP)xml.etree.ElementTree(stdlib — XML parsing)clawbio.common.html_report.HtmlReportBuilder(HTML rendering)
Safety
Every report includes the standard ClawBio medical disclaimer:
ClawBio is a research and educational tool. It is not a medical device and does not provide clinical diagnoses. Consult a healthcare professional before making any medical decisions.
Integration with Bio Orchestrator
Triggered by: "summarise PubMed papers about X", "recent papers on BRCA1", "research briefing", "gene papers", "disease papers"
Chaining partners: lit-synthesizer (broader literature), gwas-lookup (variant context), gwas-prs (polygenic risk)
04 同仓库更多 Skills
zarr-python
Stores and queries chunked N-D scientific arrays with Zarr-Python 3, including codecs, sharding, S3/GCS storage, and NumPy/Dask/Xarray integration. Use for array layout, bounded I/O, format migration, or scientific metadata preservation.
yeet
Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.
xarray
N-dimensional labeled arrays and datasets in Python. Built on top of NumPy and Dask. It introduces labels in the form of dimensions, coordinates, and attributes on top of raw NumPy-like arrays, making data analysis in physical sciences more intuitive and less error-prone. Use for working with multi-dimensional scientific data, NetCDF/GRIB/Zarr files, climate/weather/oceanographic datasets, remote sensing, geospatial imaging, large out-of-memory datasets with Dask, and labeled array operations.
writing-mstest-tests
Use when asked to fix, rewrite, update, improve, modernize, show corrected code for, or explain existing MSTest tests or MSTest-specific configuration. Use for "review" when corrected code or edits are wanted, even for one pasted assertion or passing tests with bad failure output. Covers expected/actual labels; generic Boolean, collection, string, numeric, null, identity, exception, hard-cast, and object[] checks; TestContext/lifecycle; timeout/cancellation; OS/CI conditions, retry, cleanup, parallelization, MSTest.Sdk project setup, and MSTESTxxxx. Honor the installed MSTest version. DO NOT USE to design new test cases (code-testing), perform report-only audits, create project files rather than explain MSTest setup, run tests, migrate frameworks, or handle non-MSTest/non-.NET code.
wgs-prs
End-to-end WGS to polygenic risk score pipeline. Takes paired-end FASTQ files (or a pre-existing VCF) through nf-core/sarek for variant calling, applies VCF QC (normalisation, hard filtering, Ti/Tv and Het/Hom checks), then computes polygenic risk scores via the PGS Catalog. Fills the FASTQ to VCF gap upstream of the gwas-prs skill.
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.