open-library-api
安装方式
先用 Prompt 核对来源,也可切换到安装命令或下载可用的安装包。
用 AI 助手安装
复制提示词,让助手先核对固定版本和依赖。
查看 Prompt收起 Prompt
先检查当前 Agent 是否已安装 SkillPI Skill Finder。如果尚未安装,请按官方仓库的说明安装并启用:https://github.com/Findskills/skillpi。然后使用 Skill Finder 打开此 SkillPI 详情页并定位 "open-library-api":https://skillpi.com/zh/skills/deepskill-573f32556b6d833dadb4fe2ffc8b7506e3e99d88dbec8cdb7b089b491c68bb00。安装前核对上游来源和版本:https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba/skills/43-wentorai-research-plugins/skills/literature/search/open-library-api/SKILL.md。来源不一致时停止并说明差异。核对通过后,用 Skill Finder 安装目标 Skill,并报告安装路径和来源版本。
此命令从 GitHub 来源仓库获取指定技能。运行前请先查看源文件。
npx skills add https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba/skills/43-wentorai-research-plugins/skills/literature/search/open-library-api --skill open-library-api来源与配置
查看 GitHub 源码brycewang-stanford/Auto-Empirical-Research-Skills固定提交 bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba
配置方式待核实
请查看原始来源中的适用工具、依赖和权限要求。
安装实测待补充
本条目面向资料查询与搜索场景,提供“open-library-api”技能的目录入口。公开标签:learning、图书检索、ISBN查询、元数据。请通过固定上游版本核对实际功能、依赖与权限;此页为 Skillπ 独立编写的用途介绍和原站链接,不代表运行安全保证。原文与附件依各自许可开放。
文件浏览
---
name: open-library-api
description: "Search and access book metadata via the Open Library API"
metadata:
openclaw:
emoji: "📕"
category: "literature"
subcategory: "search"
keywords: ["Open Library", "book search", "ISBN lookup", "Internet Archive", "book metadata", "digital library"]
source: "https://openlibrary.org/"
---
# Open Library API
## Overview
Open Library (by the Internet Archive) catalogs every book ever published — 40M+ editions, 20M+ unique works. The API provides book search, ISBN/OCLC lookup, cover images, and reading access for 2M+ borrowable ebooks. Particularly useful for monograph discovery, edition tracking, and bibliographic verification. Free, no authentication required.
## API Endpoints
### Search Books
```bash
# Full-text search
curl "https://openlibrary.org/search.json?q=machine+learning&limit=20"
# Search by title
curl "https://openlibrary.org/search.json?title=deep+learning&limit=10"
# Search by author
curl "https://openlibrary.org/search.json?author=goodfellow&title=deep+learning"
# Filter by subject
curl "https://openlibrary.org/search.json?q=statistics&subject=data+analysis"
# Filter by publication year
curl "https://openlibrary.org/search.json?q=artificial+intelligence&first_publish_year=2020"
# Sort by edition count
curl "https://openlibrary.org/search.json?q=calculus&sort=editions"
```
### Book Details
```bash
# Get work (canonical book entity)
curl "https://openlibrary.org/works/OL45804W.json"
# Get edition
curl "https://openlibrary.org/books/OL7353617M.json"
# Get by ISBN
curl "https://openlibrary.org/isbn/9780262035613.json"
# Bibliographic data via Books API
curl "https://openlibrary.org/api/books?bibkeys=ISBN:9780262035613&format=json&jscmd=data"
```
### Cover Images
```bash
# By ISBN (S/M/L sizes)
https://covers.openlibrary.org/b/isbn/9780262035613-M.jpg
# By OLID
https://covers.openlibrary.org/b/olid/OL7353617M-L.jpg
```
### Author Data
```bash
# Get author
curl "https://openlibrary.org/authors/OL34184A.json"
# Search authors
curl "https://openlibrary.org/search/authors.json?q=hinton"
# Author's works
curl "https://openlibrary.org/authors/OL34184A/works.json?limit=20"
```
### Search Parameters
| Parameter | Description | Example |
|-----------|-------------|---------|
| `q` | General search | `q=neural+networks` |
| `title` | Title search | `title=deep+learning` |
| `author` | Author search | `author=bengio` |
| `subject` | Subject filter | `subject=computer+science` |
| `isbn` | ISBN lookup | `isbn=9780262035613` |
| `first_publish_year` | Publication year | `first_publish_year=2020` |
| `limit` | Results (max 100) | `limit=50` |
| `offset` | Pagination | `offset=50` |
| `sort` | Sort order | `new`, `editions`, `old` |
| `fields` | Return fields | `key,title,author_name` |
## Response Structure (Search)
```json
{
"numFound": 1250,
"docs": [
{
"key": "/works/OL45804W",
"title": "Deep Learning",
"author_name": ["Ian Goodfellow", "Yoshua Bengio", "Aaron Courville"],
"first_publish_year": 2016,
"isbn": ["9780262035613"],
"publisher": ["MIT Press"],
"subject": ["Machine learning", "Neural networks"],
"edition_count": 8,
"cover_i": 8739161,
"ebook_access": "borrowable"
}
]
}
```
## Python Usage
```python
import requests
BASE_URL = "https://openlibrary.org"
def search_books(query: str, limit: int = 20,
subject: str = None) -> list:
"""Search Open Library for books."""
params = {"q": query, "limit": limit}
if subject:
params["subject"] = subject
resp = requests.get(f"{BASE_URL}/search.json", params=params)
resp.raise_for_status()
data = resp.json()
results = []
for doc in data.get("docs", []):
results.append({
"key": doc.get("key"),
"title": doc.get("title"),
"authors": doc.get("author_name", []),
"year": doc.get("first_publish_year"),
"publisher": doc.get("publisher", [None])[0],
"isbn": doc.get("isbn", [None])[0],
"editions": doc.get("edition_count", 0),
"subjects": doc.get("subject", [])[:5],
"ebook": doc.get("ebook_access"),
})
return results
def get_by_isbn(isbn: str) -> dict:
"""Look up a book by ISBN."""
resp = requests.get(
f"{BASE_URL}/api/books",
params={
"bibkeys": f"ISBN:{isbn}",
"format": "json",
"jscmd": "data",
},
)
resp.raise_for_status()
data = resp.json()
return data.get(f"ISBN:{isbn}", {})
def get_author_works(author_key: str, limit: int = 20) -> list:
"""Get works by an author."""
resp = requests.get(
f"{BASE_URL}/authors/{author_key}/works.json",
params={"limit": limit},
)
resp.raise_for_status()
return resp.json().get("entries", [])
# Example: search CS textbooks
books = search_books("algorithms data structures",
subject="computer science")
for b in books[:5]:
print(f"[{b['year']}] {b['title']} — {', '.join(b['authors'][:2])}")
print(f" Publisher: {b['publisher']} | Editions: {b['editions']}")
# Example: ISBN lookup
info = get_by_isbn("9780262035613")
print(f"Title: {info.get('title')}")
print(f"URL: {info.get('url')}")
```
## References
- [Open Library](https://openlibrary.org/)
- [Open Library API](https://openlibrary.org/developers/api)
- [Open Library Data Dumps](https://openlibrary.org/developers/dumps)
版本历史
-
v2026.07
GitHub ↗
原版更新说明
## Highlights - **First tagged release.** Every gate is green: `make check` (validate + 183 unit tests + eval-harness + numeric benchmarks), validate-catalog, quality-evals, and OpenSSF Scorecard on `main`. - **Rigor double loop at 13 method families.** Each family closes taxonomy tag → eval scenario (does the agent avoid the method's known traps?) → deterministic numeric benchmark (does it recover the true effect?). New this cycle: heterogeneous treatment effects (CATE) and quantile treatment effects (QTE). - **Paper-WorkFlow flagship at 29/29 executable rigor gates**, now merged to its `main` with a drift-gated README badge — the credibility artifact is checked by CI, so it can never silently go stale ([RIGOR.md](https://github.com/brycewang-stanford/Paper-WorkFlow/blob/main/RIGOR.md)). - **1,150 vendored skills / 69 collections**, all license-audited, security-scanned, tracked in a machine-readable catalog with CI-enforced freshness, and importable as a single whole-repo router skill. - **Hardened weekly upstream syncs**: synced trees must pass the full gate before merge; this cycle both sync PRs were verified, patched (StatsPAI's SkillOpt execution-gate card restored), and merged. - **First-party plugin marketplace** (Python / R / Stata empirical-analysis plugins + guide) shipped in the previous cycle, now under a tagged version. ## Known Follow-Ups - Ecosystem benchmark comparison (AERS vs econometrics agents on the shared benchmark suite) — [PLAN-2026-07 week 3](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/main/docs/PLAN-2026-07.md). - Decomposition (Oaxaca–Blinder) and shift-share (Bartik) method families (weeks 3–4). - GitHub Pages catalog site, README demo screenshots, five-language README consistency script (week 4). ## Catalog - Top-level collections: **69** - `SKILL.md` files: **1150** - Cataloged agent tools: **335** ([`tools/CATALOG.md`](../tools/CATALOG.md)) ## Methodological rigor - Method families in the coverage map: **13** ([`RIGOR_COVERAGE.md`](RIGOR_COVERAGE.md)) - Eval scenarios: **26** (138 rubric items, 122 auto-checkable) ([`../eval-harness/`](../eval-harness/README.md)) - Benchmark tasks: **13** (70 gold checks, 58 required) ([`../benchmark/`](../benchmark/README.md)) ### Method families (skills tagged) - `iv`: 27 - `rdd`: 25 - `panel-fe`: 19 - `staggered-did`: 17 - `bayesian`: 13 - `did`: 10 - `event-study`: 10 - `matching`: 10 - `synthetic-control`: 10 - `cate`: 8 - `dml`: 8 - `survival`: 3 - `quantile`: 2 ### Eval scenarios by category - `causal-identification`: 14 - `citation-hygiene`: 1 - `reproducibility`: 2 - `research-integrity`: 1 - `runtime-safety`: 1 - `statistical-validity`: 2 - `writing-compliance`: 3 - `writing-style`: 2 ## License buckets - AGPL-3.0: 1 - Apache-2.0: 1 - CC-BY-NC-4.0 (non-commercial): 1 - CC-BY-SA-4.0: 1 - CC-BY-SA-4.0 (repository default): 4 - GPL-3.0: 1 - MIT: 35 - MIT Non-Commercial: 1 - Mixed (per-skill; see folder): 2 - UNKNOWN - check upstream: 22 ## Quality gates - `make check` — catalog/provenance/audit/eval freshness, repo hygiene, Paper-WorkFlow gates, stdlib unit tests, eval-harness lint + graded smoke, and the strict numeric benchmark (reference-gold drift fails the build). - External links and OpenSSF Scorecard run on their scheduled workflows.
当前收录版本
0.0.1
质量评测
满分 100。前四项来自 DeepSkill 收录的质量报告。
评分依据
提供图书元数据搜索和获取功能,解决用户明确的核心任务痛点
评分依据
触发词精准完整,覆盖多种变体,边界清晰
评分依据
Phase/步骤清晰,有出口条件,含端到端示例
评分依据
工具来源明确,参数正确,覆盖主要异常
计算方式
取前四项原始分值的算术平均,四舍五入取整。可通过收录报告核对各项评分与说明,运行记录需单独查证。
权限与使用前检查
根据当前主文档自动整理,命中内容可能是示例或防护说明;不是实际权限声明,也未覆盖附件、外部依赖或运行行为。
未从主文档识别到上述常见操作,不能据此判断无需权限或没有风险。
文档引用的域名或地址
这些地址可能用于文档链接或示例,不是已批准的联网清单。使用前核对实际目的地及发送的数据。
- covers.openlibrary.org
- openlibrary.org
安全评级与访问范围
risk · 静态证据核验,不代表运行安全保证。
使用前请由宿主核对并授权实际文件读写、外部服务和联网目的地;本站的核验不会授予任何运行权限。
用户讨论
还没有已核实的点评。