tocify — Weekly Journal ToC Digest (RSS → OpenAI → digest.md)

Built an automated literature-monitoring pipeline that pulls new publications from journal RSS feeds, uses an OpenAI model to rank papers against configurable research interests, and generates a curated weekly Markdown digest. The workflow runs automatically through GitHub Actions and commits updated results back to the repository, making the system easy to fork and customize.

Skills: Python · OpenAI API / LLM integration · Prompt engineering · RSS/data ingestion · GitHub Actions · CI/CD automation · API key/secret management · Markdown · Research workflow automation

It’s meant to be forked and customized.

---

What’s in this repo

• digest.py — the pipeline (fetch RSS → filter → OpenAI triage → render markdown)
• feeds.txt — RSS feed list (supports comments; optionally supports Name | URL)
• interests.md — your keywords + narrative seed (used for relevance)
• prompt.txt — the prompt template (easy to tune without editing Python)
• digest.md — generated output (auto-updated)
• .github/workflows/weekly-digest.yml — scheduled GitHub Action runner
• requirements.txt — Python dependencies

---

Quick start (fork + run)

1) Fork the repo

• Click Fork on GitHub to copy this repo into your account.

2) Enable OpenAI billing / credits

The OpenAI API requires an active billing setup or credits.

• Go to the OpenAI Platform and ensure billing is enabled and/or credits are available.
• If you see errors like insufficient_quota or You exceeded your current quota, this is the cause.
• I recommend putting in spending limits. This uses very little compute, but it's nice to be careful.

3) Create an OpenAI API key

Create an API key in the OpenAI Platform and copy it.

Important: never commit this key to the repo.

4) Add the API key as a GitHub Actions secret

In your forked repo:

• Go to Settings → Secrets and variables → Actions
• Click New repository secret
• Name: OPENAI_API_KEY
• Value: paste your OpenAI API key

That’s it—GitHub will inject it into the workflow at runtime.

5) Configure your feeds

Edit feeds.txt.

You can use comments:

# Core journals
Nature Neuroscience | https://www.nature.com/neuro.rss
PLOS Biology | https://journals.plos.org/plosbiology/rss

# Preprints
bioRxiv neuroscience | https://www.biorxiv.org/rss/subject/neuroscience.xml