Skip to content

K-Dense-AI/scientific-agent-skills / skills/paper-lookup

paper-lookup

Flagged

Searches 18 scholarly APIs for papers, preprints, citations, open-access full text, repository records, and journal OA status, and returns results with reproducible provenance. Covers PubMed, PMC, Europe PMC, bioRxiv, medRxiv, arXiv, OpenAlex, Crossref, Semantic Scholar, CORE, Unpaywall, OpenCitations, PubTator3, Zenodo, Figshare, ROR, BioStudies, and DOAJ. Use when searching for papers, citations, DOI/PMID/arXiv lookups, abstracts, full text, open-access PDFs, preprints, citation graphs, author publications, biomedical entity annotations, deposited records (Zenodo, Figshare, BioStudies), institution ROR IDs, or any scholarly literature query. Triggers on mentions of any supported database or requests like "find papers on X", "look up this DOI", "who cites this paper", or "get me the PDF".

FileKindSize
SKILL.mdskill md25.5 KB
references/arxiv.mdmarkdown11.9 KB
references/biorxiv.mdmarkdown6.7 KB
references/biostudies.mdmarkdown4.0 KB
references/core.mdmarkdown4.6 KB
references/crossref.mdmarkdown5.5 KB
references/doaj.mdmarkdown4.2 KB
references/europepmc.mdmarkdown9.0 KB
references/figshare.mdmarkdown3.1 KB
references/medrxiv.mdmarkdown5.0 KB
references/openalex.mdmarkdown5.5 KB
references/opencitations.mdmarkdown4.6 KB
references/pmc.mdmarkdown7.1 KB
references/pubmed.mdmarkdown4.5 KB
references/pubtator.mdmarkdown4.5 KB
references/ror.mdmarkdown4.2 KB
references/semantic-scholar.mdmarkdown7.1 KB
references/unpaywall.mdmarkdown3.5 KB
references/zenodo.mdmarkdown3.8 KB
scripts/_common.pyscript8.2 KB
scripts/arxiv_atom.pyscript8.0 KB
scripts/jats_to_text.pyscript11.0 KB
scripts/openalex_abstract.pyscript6.3 KB
scripts/paginate.pyscript19.2 KB

references/ror.md

View on GitHub
# ROR (Research Organization Registry)

Open registry of research organizations. Use it to turn an affiliation string
into a ROR ID (`https://ror.org/05a0ya142`) or to look up one org. It is not
a paper database. OpenAlex and Crossref already *carry* ROR IDs on works;
this API is how you resolve or check an existing ID.

All figures below verified 2026-09-10. Use the **v2** routes.

## Base URL

```
https://api.ror.org/v2
```

Docs: https://ror.readme.io/docs/rest-api

## Authentication

None. Heartbeat: `GET https://api.ror.org/heartbeat` → `OK`.

## Rate Limits

2000 requests / 5 minutes / IP. Traffic spikes around midnight UTC. For bulk
matching, run the API locally (Docker) rather than hammering the public host.

## Identifier

A ROR ID is `https://ror.org/` plus nine characters (`0` + 6 alphanumeric +
2 check-ish chars), e.g. `https://ror.org/05a0ya142`. The path
`/v2/organizations/05a0ya142` accepts the suffix alone.

## Key Endpoints

### 1. Keyword / identifier search

```
GET /v2/organizations?query={text}
```

Searches **only** `names` and `external_ids` (GRID, ISNI, Wikidata, Crossref
Funder ID). It does not search addresses, websites, or relationships.

Unquoted common words explode. Verified:

| `query` | `number_of_results` | First hit |
|---|---|---|
| `Broad Institute` | 13016 | Broad Institute (lucky, not guaranteed) |
| `"Broad Institute"` | 3 | Broad Institute |

Never take `items[0]` as the match without reading `names` and `status`.
Quote the string (`%22…%22`) when the user gave a proper name.

Pages contain at most 20 active records. `page` is 1-based and capped at 500 (10,000 results); exceeding it can return HTTP 200 with `errors`. Use the ROR dump for the whole registry. Filter and page per
https://ror.readme.io/docs/api-filtering and
https://ror.readme.io/docs/api-paging. Pass `all_status=true` if you need
inactive / withdrawn orgs in a list.

### 2. Affiliation matcher (unstructured strings)

```
GET /v2/organizations?affiliation={raw affiliation}
```

Best for "Broad Institute of MIT and Harvard, Cambridge, MA" dumped from a
PDF. As of 2026-05-26 this parameter defaults to the **single search**
strategy.

The JSON is **not** the same as `?query=`. Each item is a match wrapper:

```json
{
  "substring": "Broad Institute of MIT and Harvard, Cambridge, MA",
  "score": 1.0,
  "matching_type": "SINGLE SEARCH",
  "chosen": true,
  "organization": { "id": "https://ror.org/05a0ya142", "names": […], "status": "active" }
}
```

Read `items[].organization` and `chosen`. `items[0].id` is absent — that is
how a naive parse reports "no ROR ID" after a successful match.

Verified: 10 items, first `chosen` true, organization is Broad Institute.

### 3. One organization

```
GET /v2/organizations/{ror_id_or_suffix}
```

```
GET /v2/organizations/05a0ya142
```

Always returns the record, including `inactive` / `withdrawn`. Lists hide
those statuses by default; a single-id GET does not. Check `status` before
writing the ID into metadata.

v2 records have `names[]` (with types: ror_display, alias, acronym, label),
not a top-level `name`. `/organizations/{id}` without `/v2` currently still
returns the v2 shape; call `/v2/` so a future default change does not flip
the schema under you.

## Typical Workflow

1. Proper name or GRID/ISNI → `?query="…"` and inspect the shortlist.
2. Messy affiliation line → `?affiliation=` and keep rows with
   `chosen: true`. If none is chosen, report the candidates for review; neither a high score nor the first position establishes a match.
3. Known ROR ID → GET the record and confirm `status: active`.
4. Then, if the user wanted papers from that org, search OpenAlex /
   Crossref with the ROR ID. Do not search ROR for papers.

## Failure Modes

| What you did | What happens | What to do |
|---|---|---|
| Unquoted `University` / `Institute` query | Thousands of hits | Quote the name; do not auto-pick |
| Read `items[0].id` on an affiliation response | `null` | Use `items[0].organization.id` |
| Wrote an inactive ROR from a single-id GET | Record exists, `status` is not `active` | Read `status` |
| Used v1 field `name` | Missing | Use `names[].value` |

## Official sources reviewed 2026-09-30

- https://ror.readme.io/docs/rest-api
- https://ror.readme.io/docs/api-paging
- https://ror.readme.io/docs/api-affiliation
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall