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

hathitrust-catalog

/hathitrust-catalog

Wyszukuje rekordy bibliograficzne i zdigitalizowane woluminy w kolekcji HathiTrust ponad 17 mln woluminów po ISBN, OCLC, LCCN, ISSN lub identyfikatorze HathiTrust, w tym metadane MARC.

Licencja
MIT
Ostatnia zmiana repozytorium
26.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
7
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

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

Skrypty: scripts/hathitrust_api.py

Co robi i kiedy

Wyszukuje rekordy bibliograficzne i zdigitalizowane woluminy w kolekcji HathiTrust ponad 17 mln woluminów po ISBN, OCLC, LCCN, ISSN lub identyfikatorze HathiTrust, w tym metadane MARC.

Oryginalny opis (EN)

Look up bibliographic records and digitized volumes in HathiTrust's 17M+ volume collection by ISBN, OCLC, LCCN, ISSN, or HathiTrust ID. Use this skill whenever the user wants to check if a book has been digitized, find which libraries hold a copy, get MARC metadata for a known identifier, or link a bibliographic reference to its HathiTrust digital version. Also triggers when cross-referencing identifiers from other library catalogs (Harvard, Library of Congress) against HathiTrust holdings.

Jak działa

  1. Critical: Things Claude Won't Know Without This Skill
  2. Identifier Types
  3. Response Structure
  4. Python Script
  5. Typical Workflow: Cross-Reference with Other Catalogs
  6. API Etiquette
  7. Related Skills
  8. Resources
  9. Feedback and Citation
Sekcje z nagłówków SKILL.md, w oryginale · 163 linii, 772 słów
Podgląd SKILL.md
---
name: hathitrust-catalog
description: Look up bibliographic records and digitized volumes in HathiTrust's 17M+ volume collection by ISBN, OCLC, LCCN, ISSN, or HathiTrust ID. Use this skill whenever the user wants to check if a book has been digitized, find which libraries hold a copy, get MARC metadata for a known identifier, or link a bibliographic reference to its HathiTrust digital version. Also triggers when cross-referencing identifiers from other library catalogs (Harvard, Library of Congress) against HathiTrust holdings.
version: 1.0.1
---

# HathiTrust Bibliographic API Skill

Look up records and digitized volumes in HathiTrust's collection of 17M+ volumes from major research libraries.

## Critical: Things Claude Won't Know Without This Skill

### This is a lookup API, NOT a search API

HathiTrust's Bibliographic API retrieves records by **known identifiers** only. There is no keyword or title search. You must have an ISBN, OCLC number, LCCN, ISSN, or HathiTrust ID.

```
WORKS:     https://catalog.hathitrust.org/api/volumes/brief/isbn/0140449264.json
NOT POSSIBLE: https://catalog.hathitrust.org/api/volumes/brief/search?q=hamlet
```

If you only have a title/author, search another catalog first (LibraryCloud, Library of Congress) to get an ISBN or OCLC number, then look it up here.

### Two endpoint variants: brief vs full

| Endpoint | Returns | Use when |
|----------|---------|----------|
| `/api/volumes/brief/` | Metadata + items (no MARC) | You just need titles, ISBNs, holdings, digital access links |
| `/api/volumes/full/` | Same + complete MARC-XML | You need full cataloging data |

### Empty results are not errors

When no record matches, the API returns `{"records": {}, "items": []}` with HTTP 200 — not a 404. Always check if `records` is empty.

### Batch up to 20 lookups in one request

Use the multi-ID endpoint to batch lookups:

```
/api/volumes/brief/json/isbn:0140449264|oclc:228668653
```

Pipe-separated as `type:value`. Max 20 per request.

## Identifier Types

| Type | Example | Notes |
|------|---------|-------|
| `isbn` | `0140449264` or `9780140449266` | ISBN-10 or ISBN-13, digits only (+ trailing X) |
| `oclc` | `228668653` | OCLC number, digits only |
| `lccn` | `72081773` | URL-encode spaces; do not encode `/` (404) |
| `issn` | `03785955` | Digits only |
| `htid` | `mdp.39015058510069` | HathiTrust volume ID |
| `recordnumber` | `000578050` | 9-digit HathiTrust record number |

## Response Structure

```json
{
  "records": {
    "009058846": {
      "recordURL": "https://catalog.hathitrust.org/Record/009058846",
      "titles": ["The Odyssey / Homer ; translated by Robert Fagles."],
      "isbns": ["0140268863", "9780140268867"],
      "oclcs": ["34228839"],
      "lccns": ["96017900"],
      "publishDates": ["1997"]
    }
  },
  "items": [
    {
      "orig": "University of Michigan",
      "htid": "mdp.39015042182054",
      "itemURL": "https://babel.hathitrust.org/cgi/pt?id=mdp.39015042182054",
      "rightsCode": "ic",
      "usRightsString": "Limited (search-only)",
      "lastUpdate": "20240115",
      "enumcron": false
    }
  ]
}
```

Key fields:
- **`rightsCode`**: `pd` = public domain (full text available), `ic` = in-copyright (search only)
- **`usRightsString`**: `"Full View"` or `"Limited (search-only)"`
- **`itemURL`**: Direct link to the HathiTrust page-turner viewer
- **`enumcron`**: Volume/issue info (e.g., `"vol. 3"`) or `false`

## Python Script

Use `scripts/hathitrust_api.py` for programmatic access (zero dependencies):

```python
from scripts.hathitrust_api import HathiTrustAPI
ht = HathiTrustAPI()

# Single lookup
record = ht.lookup_isbn("0140449264")

# Multiple identifiers at once
results = ht.batch_lookup([
    ("isbn", "0140449264"),
    ("oclc", "228668653"),
    ("lccn", "96017900"),
])

# Get full MARC-XML
record = ht.lookup_isbn("0140449264", full=True)
marc = ht.get_marc_xml(record)

# Check if digitized and accessible
for item in ht.get_items(record):
    print(f"{item['orig']}: {item['usRightsString']} — {item['itemURL']}")

# Summarize
print(ht.summarize(record))
```

## Typical Workflow: Cross-Reference with Other Catalogs

```python
# 1. Search Harvard for a title
from harvard_api import HarvardLibraryAPI
harvard = HarvardLibraryAPI()
results = harvard.search(title="dream of the red chamber")
isbn = harvard.get_identifiers(results[0]).get("isbn")

# 2. Check HathiTrust for digital version
from hathitrust_api import HathiTrustAPI
ht = HathiTrustAPI()
record = ht.lookup_isbn(isbn)
if record and ht.has_full_view(record):
    print("Full text available:", ht.get_items(record)[0]["itemURL"])
```

## API Etiquette

- No authentication required
- No documented rate limit, but the API is meant for small-batch lookups (not bulk harvesting)
- Use HathiFiles or OAI-PMH for bulk data
- CORS is fully enabled (`access-control-allow-origin: *`)

## Related Skills

- **harvard-library-catalog**: Search Harvard's catalog to find ISBNs/identifiers, then check HathiTrust for digital versions
- **wikidata-search**: Cross-reference Wikidata identifiers (P243 = OCLC) with HathiTrust holdings

## Resources

- `references/api_reference.md` — Complete API spec with all identifier types and response fields
- `scripts/hathitrust_api.py` — Python client with batch lookups, MARC extraction, and access checking

## Feedback and Citation

**Report a problem.** This skill is part of the public repository [kltng/humanities-skills](https://github.com/kltng/humanities-skills). If it fails (an API changed, a script errors, or these instructions are wrong), report it as a GitHub issue:

1. Ask the user before filing. Issues are public.
2. Check for an existing report: `gh issue list --repo kltng/humanities-skills --state all --search "hathitrust-catalog"`
3. File it: `gh issue create --repo kltng/humanities-skills --label bug --title "[hathitrust-catalog] <short summary>" --body "<details>"`. Without `gh`, give the user this link: https://github.com/kltng/humanities-skills/issues/new?template=skill-problem.yml
4. Include the skill name and version, what you ran, the error text, what you expected, and the environment (OS, Python version). Leave out API keys, personal data, private file paths, and unpublished research.

**Cite.** If this skill helped work that is published, please cite it, together with the data source it uses:

> Tang, Kwok-leong. *humanities-skills: hathitrust-catalog* (version <version at the top of this file>). GitHub, <year>. https://github.com/kltng/humanities-skills

When you help a user write up results that relied on this skill, remind them once about this citation.
Pliki w paczce (4)
  • SKILL.md 7 KB
  • evals/evals.json 2 KB
  • references/api_reference.md 3 KB
  • scripts/hathitrust_api.py 10 KB

Wersje

W bazie nie ma innych skilli o nazwie hathitrust-catalog.

Migawka bazy z 13.11.2026 · wersja paczki e563b8d7a1eb (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

  • 100harvard-library-catalog
    Przeszukuje ponad 13 mln rekordów bibliograficznych Harvard Library przez LibraryCloud i pobiera dane MARC i MODS przez PRESTO, by weryfikować tytuły, autorów, ISBN i daty oraz znajdować kolekcje cyfrowe.
  • 100reference-validation
    Waliduje odwołanie bibliograficzne, wyszukując je w sieci i porównując z autorytatywnymi źródłami: autor, tytuł, wydawca, rok oraz identyfikator DOI, arXiv, ISBN lub ISSN.
  • 100yale-library-catalog
    Przeszukuje katalog Biblioteki Uniwersytetu Yale (Alma) przez publiczny SRU oraz Yale LUX przez API JSON: sprawdza dostępność i półkę, szuka po tytule, autorze, ISBN, czyta rekordy MARC i obiekty muzealne.
  • 100openlibrary
    Odpytuje katalog Open Library z terminala: wyszukuje książki i autorów, prace, wydania i numery ISBN, wylicza wszystkie wydania dzieła, czyta oceny społeczności i ustala adresy okładek, bez klucza API.

Uwagi i zgłoszenia

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