github โ†—
pure python ยท zero dependencies ยท 617 loc

๐Ÿ”ฌ pubmed-watcher

Automated PubMed Paper Alerts

Watch PubMed queries and get alerted only about new papers. Tracks seen PMIDs, supports cron scheduling, outputs to terminal, Markdown, or JSON.

// how it works
01
๐Ÿ”Ž
Query PubMed E-utilities
02
๐Ÿ”„
Filter against seen.json
03
๐Ÿ“ฅ
Fetch new paper details
04
๐Ÿ””
Alert only NEW papers
// default queries
// demo output
$ python3 pubmed_watcher.py watch
๐Ÿ”” 12 new papers found across 5 queries (last 7 days) โ”โ”โ” ๐Ÿ”Ž "epigenetic reprogramming aging longevity" โ€” 3 new โ”โ”โ” ๐Ÿ“„ Epigenetic reprogramming reverses age-associated decline in neural stem cell function ๐Ÿ‘ค Zhang W โ€ฆ Bhatt DL ๐Ÿ“ฐ Nature Aging โ€ข 2026 Feb ๐Ÿ”— https://pubmed.ncbi.nlm.nih.gov/39847201/ ๐Ÿ“„ In vivo partial reprogramming extends lifespan in progeroid mice via cellular rejuvenation ๐Ÿ‘ค Ocampo A โ€ฆ Izpisua Belmonte JC ๐Ÿ“ฐ Cell โ€ข 2026 Feb 10 ๐Ÿ”— https://pubmed.ncbi.nlm.nih.gov/39847202/ โ”โ”โ” ๐Ÿ”Ž "senolytics senescent cells therapy" โ€” 4 new โ”โ”โ” ๐Ÿ“„ Dasatinib plus quercetin reduces senescent cell burden in human adipose tissue ๐Ÿ‘ค Kirkland JL โ€ฆ Tchkonia T ๐Ÿ“ฐ Nature Medicine โ€ข 2026 Feb ๐Ÿ”— https://pubmed.ncbi.nlm.nih.gov/39847203/ โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” ๐Ÿ“Š Total: 12 new | 4/5 queries had results
$ python3 pubmed_watcher.py history
๐Ÿ“œ Alert History (last 5 runs) ๐Ÿ”” 2026-02-17 08:00 UTC โ€” 12 new papers (5 queries, 7d window) โ€ข epigenetic reprogramming aging longevity: 3 new โ€ข senolytics senescent cells therapy: 4 new โ€ข AI drug discovery clinical trial: 3 new โ€ข biological age clock methylation: 2 new ๐Ÿ”” 2026-02-16 08:00 UTC โ€” 8 new papers (5 queries, 7d window) โœ… 2026-02-15 08:00 UTC โ€” 0 new papers (5 queries, 7d window) ๐Ÿ”” 2026-02-14 08:00 UTC โ€” 5 new papers (5 queries, 7d window)
// features

๐Ÿ”„ Delta Detection

Tracks every PMID in seen.json. You only get alerted once per paper, even across multiple queries. Perfect for daily cron jobs.

๐Ÿ“ค Output Formats

  • --terminal โ€” Pretty CLI output
  • --markdown โ€” Telegram-ready
  • --json โ€” Machine-readable

โฐ Cron Ready

0 8 * * * python3 pubmed_watcher.py watch --markdown >> /tmp/alerts.md

Run daily, pipe to Telegram, Slack, or email.

๐Ÿ’ป Commands

  • watch โ€” Check all queries
  • add "query" โ€” Add new query
  • list โ€” Show queries
  • remove <id> โ€” Remove query
  • history โ€” Past runs
  • reset-seen โ€” Clear DB