Przejdź do treści
Biblioteka skilli
Nauka i badania · Research

fetch-paper

/fetch-paper

Pobiera legalną wersję otwartego dostępu artykułu po DOI lub identyfikatorze arXiv, bez obchodzenia paywalli.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/resolve_oa.py

Co robi i kiedy

Pobiera legalną wersję otwartego dostępu artykułu po DOI lub identyfikatorze arXiv, bez obchodzenia paywalli.

Oryginalny opis (EN)

Fetches a legal open-access copy of a paper from its DOI or arXiv ID — resolves through Unpaywall, arXiv PDF/HTML, and the open-access ACM Digital Library. Use when the user wants to fetch, download, read, or get the PDF or full text of a specific paper. Single polite fetch, transient processing only: it never stores paper text in the repo, never bypasses paywalls, and never uses shadow libraries. For finding papers by topic or venue, use find-papers first; this skill starts from an identifier.

Jak działa

  1. When to use
  2. Inputs
  3. Process
  4. Output
  5. Guardrails
  6. References
Sekcje z nagłówków SKILL.md, w oryginale · 92 linii, 583 słów
Podgląd SKILL.md
---
name: fetch-paper
description: >-
  Fetches a legal open-access copy of a paper from its DOI or arXiv ID —
  resolves through Unpaywall, arXiv PDF/HTML, and the open-access ACM Digital
  Library. Use when the user wants to fetch, download, read, or get the PDF or
  full text of a specific paper. Single polite fetch, transient processing
  only: it never stores paper text in the repo, never bypasses paywalls, and
  never uses shadow libraries. For finding papers by topic or venue, use
  find-papers first; this skill starts from an identifier.
---

# Fetch Paper

Resolves one DOI or arXiv ID to a **legal** open-access copy (PDF URL, arXiv
HTML rendering, landing page) and optionally downloads it for transient
reading. This is the fetch layer that `find-papers`, `literature-review`,
`study-exemplars`, and `draft-related-work` build on.

## When to use

- The user has a DOI, doi.org URL, arXiv ID, or arxiv.org URL and wants the paper.
- Another skill needs full text for a paper it found (lit review, exemplar study).
- The user asks "is there an open-access version of this paper?"
- NOT for topic/title/venue search — run `find-papers` first to get the identifier.

## Inputs

- Exactly one identifier per fetch: a DOI (`10.1145/3589132.3625571`,
  `https://doi.org/...`) or an arXiv ID (`2403.12345`, `arXiv:2403.12345v2`,
  `cs/0309136`, or any arxiv.org URL). arXiv-issued DOIs (`10.48550/arXiv.*`)
  are auto-converted.
- `UNPAYWALL_EMAIL` (or `CONTACT_EMAIL`) env var — a real address; Unpaywall
  rejects placeholders with HTTP 422. The script prompts if unset.

## Process

1. **Resolve the identifier.** Run:

   ```
   python3 scripts/resolve_oa.py <DOI-or-arXiv-ID> --json
   ```

   The script handles everything deterministic: identifier normalization,
   Unpaywall `best_oa_location` lookup, arXiv PDF/HTML URLs, the post-2026
   ACM DL open-access fallback for `10.1145/*` DOIs, rate limiting, 429
   backoff, and response caching under `.cache/fetch-paper/`. Never hand-roll
   these API calls.

2. **Interpret the result** (exit codes: 0 = OA found, 3 = no legal OA copy,
   2 = bad input/config, 1 = network failure):
   - Prefer `html_url` (arXiv HTML) when present — easiest to read directly.
   - Otherwise use `pdf_url`. Read the meaning of `oa_status`, `version`, and
     `license` in [references/oa-sources.md](references/oa-sources.md).
   - `version: submittedVersion` means a preprint — warn the user that the
     published version may differ before they quote or cite page numbers.

3. **Fetch the full text transiently.** Either read the URL directly, or:

   ```
   python3 scripts/resolve_oa.py <ID> --download
   ```

   which saves the PDF to a fresh temp directory (never the repo). Read it,
   extract what the task needs, then delete it. `dl.acm.org` blocks scripted
   downloads — give the user the URL to open in a browser instead.

4. **If exit code is 3 (no legal OA copy):** relay the script's suggestions —
   author homepages / institutional repositories (search via `find-papers`),
   arXiv by title, the user's library access, or emailing the authors. Never
   suggest Sci-Hub, LibGen, or any shadow library, and never try to bypass a
   paywall. Full rules: [references/copyright-and-politeness.md](references/copyright-and-politeness.md).

5. **Process, don't persist.** Quote at most short excerpts in your analysis.
   Never write paper text, abstracts, or the PDF into the repository or any
   committed file. Metadata (DOI, title, BibTeX fields) is always fine.

## Output

- A resolution report (human-readable, or JSON with `--json`): `is_oa`,
  `oa_status`, `license`, `version`, `pdf_url`, `html_url`, `landing_url`,
  `source`, plus notes.
- With `--download`: a transient PDF in a temp directory, path printed to stderr.
- Nothing is ever written into the repository.

## Guardrails

- One identifier per invocation — never loop this script over a list of DOIs
  for bulk harvesting (ACM ToU and arXiv policy both prohibit it). For a
  handful of papers in a session, run it one at a time and let the built-in
  rate limits breathe.
- Legal sources only; transient processing only; no storage, no redistribution.
- Cite the published DOI, not the preprint, when both exist — and verify every
  citation with `verify-citations` before it lands in a bibliography.
- Never submit anything to any system on the user's behalf.

## References

- [references/oa-sources.md](references/oa-sources.md) — Unpaywall fields and
  errors, arXiv URL patterns, ACM DL open access, troubleshooting.
- [references/copyright-and-politeness.md](references/copyright-and-politeness.md)
  — what is safe to keep vs. transient-only, politeness contract.
Pliki w paczce (4)
  • SKILL.md 5 KB
  • references/copyright-and-politeness.md 3 KB
  • references/oa-sources.md 6 KB
  • scripts/resolve_oa.py 21 KB

Wersje

W bazie nie ma innych skilli o nazwie fetch-paper.

Migawka bazy z 13.11.2026 · wersja paczki b6dc0ca809cb (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100paper-fetch
    Pobiera PDF artykułu naukowego na podstawie DOI, identyfikatora arXiv, tytułu lub cytowania, także hurtowo, przez Unpaywall i inne źródła wersji open access.
  • 100paper-download
    Pobiera PDF artykułów po DOI lub identyfikatorze arXiv, najpierw z dostępu otwartego, a potem przez przeglądarkę z uczelni.
  • 100arxiv
    Wyszukuje, pobiera i streszcza prace naukowe z arXiv oraz zapisuje je w lokalnej bibliotece artykułów.
  • 100arxiv
    Wyszukuje, pobiera i streszcza prace naukowe z arXiv.
  • 100aris-arxiv
    Wyszukuje, pobiera i streszcza artykuły naukowe z arXiv i zapisuje je w lokalnej bibliotece prac.
  • 100download-papers
    Pobiera artykuły naukowe jako PDF na podstawie adresu URL, DOI, tytułu lub cytowania, domyślnie dołączonym skryptem pomocniczym, a przy samym tytule przez wyszukiwanie w sieci i arXiv.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.