Open Library作品搜索:JSON/分页及官方1/3 req/s使用规则已有文档;认证、费用和实时quota仍未知,未调用。
调用方式 / profile:openlibrary-search-documentation · 组件版本:documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847 · 引用此版本与调用方式
已记录条件
- invocation_mode = api:支持。Supported within this profile and component version. 依据:openlibrary-search-documentation-e1
- execution_location = remote:支持。Supported within this profile and component version. 依据:openlibrary-search-documentation-e1
- output_format = json:支持。Supported within this profile and component version. 依据:openlibrary-search-documentation-e2
- output_structure = json_object:支持。Supported within this profile and component version. 依据:openlibrary-search-documentation-e2
- auth_required = false:未知(可能存在冲突或待复核)。该页只有公开URL示例,没有明确无需认证的声明。 依据:
入口与前提
- 协议
- HTTPS GET(文档查询URL)
- 认证
- 本页未明确认证、账户或API key条件,不能由公开示例推断免认证
- 价格是否查明
- unknown
- 配额是否查明
- unknown
https://openlibrary.org/search.json
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- fields=*被文档称为响应开销大,不能解释成收费声明。
- 嵌套editions当前仅展示一个,分页尚在规划;不承诺返回全部版本。
- 总API文档:未标识请求1 req/s,带User-Agent及联系邮箱的标识请求3 req/s;不是当前账户quota或SLA。
- 常规频繁使用标识应用和联系邮箱或电话;本次没有发送联系资料。
- 缓存响应;不用作批量数据后台或高流量商业基础设施;违规可能限速/封锁。
- 认证、费用、完整许可、当前quota、运行版本和可用性仍unknown;仅固定公开文档,未调用。
配方 openlibrary-search-documentation-recipe · 修订 2
所需调用能力:
- search_book_work_metadata
运行前提:
- 仅官方文档声明,配方proposed;本站未连接、注册、调用第三方工具或核验实际账户。
- fields=*被文档称为响应开销大,不能解释成收费声明。
- 嵌套editions当前仅展示一个,分页尚在规划;不承诺返回全部版本。
- 总API文档:未标识请求1 req/s,带User-Agent及联系邮箱的标识请求3 req/s;不是当前账户quota或SLA。
- 常规频繁使用标识应用和联系邮箱或电话;本次没有发送联系资料。
- 缓存响应;不用作批量数据后台或高流量商业基础设施;违规可能限速/封锁。
- 认证、费用、完整许可、当前quota、运行版本和可用性仍unknown;仅固定公开文档,未调用。
使用步骤:
- 准备已获授权的最小输入,核对本profile的适用范围、认证与费用;不填私人信息或凭据到公开示例。
- 候选GET https://openlibrary.org/search.json?q=the+lord+of+the+rings&fields=key,title,author_name&limit=1;不得使用私有数据或批量镜像。
- 未来获准调用后核对HTTP/MCP状态、返回结构与请求条件,保留缺项/限流/权限错误;本次没有执行此步骤。
- 输入约定
- q/Solr查询或title/author;仅请求必要fields;offset/limit或page/limit,page从1开始。lang仅语言偏好,严格语言过滤应在query内表达。
- 输出约定
- JSON对象含start、总数和docs[];本页num_found/numFound两种示例,schema不保证稳定。默认works,非全部editions。
- 成功检查
- 未来核对docs数组、总数字段兼容及page/offset;空结果/字段变化保留原响应和unknown。
- 失败与回退
- 条件不满足、认证/限流/结构错误即停止该调用并保留unknown;不切换付费服务、不猜工具名、不执行写操作。
适用证据
openlibrary-search-documentation-e1 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/mcp-public-batch-20261024-01/sources/openlibrary-search-documentation.txt:L82-L93
- 来源版本
- documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847
- 内容摘要
- d137b8fbd463035cc500d9ee512d15c62d71a5510baeb42f34e12e65bab53253
- 采集时间
- 2026-10-24T04:38:31.3260513+00:00
Search API Developer Center → APIs → Search API URL: https://openlibrary.org/search.json Parameter Description q The solr query. See Search HowTo for sample queries fields The fields to get back from solr. The special value * may be provided to fetch all fields (however this will result in an expensive response, please use sparingly). To fetch availability data from archive.org, add the special value, availability . Example: /search.json?q=harry%20potter&fields=*,availability&limit=1. This will fetch the availability data of the first item in the `ia` field.
覆盖条件:invocation_mode=api; execution_location=remote
openlibrary-search-documentation-e2 · 来源文档声明
- 原文定位
- .local/deep-cards-v1/mcp-public-batch-20261024-01/sources/openlibrary-search-documentation.txt:L131-L141
- 来源版本
- documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847
- 内容摘要
- d137b8fbd463035cc500d9ee512d15c62d71a5510baeb42f34e12e65bab53253
- 采集时间
- 2026-10-24T04:38:31.3260513+00:00
Response Format The response with be of the following format. { "start": 0, "num_found": 629, "docs": [ {...}, {...}, ... {...}] }
覆盖条件:output_format=json; output_structure=json_object
openlibrary-search-documentation-supplement-1 · 来源文档声明
- 原文定位
- .local\deep-cards-v1\resumed-public-capture-20261024-01\sources\openlibrary-general-20261024-01.text.txt:L143-L144; original HTML lines [815, 818]
- 来源版本
- documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847
- 内容摘要
- 085ae7b9913726a3e234863ac8246e0795496c2fd82920b6c64c26d4deccd15a
- 采集时间
- 2026-10-24T12:09:26.0897354+00:00
Default (non-identified requests): 1 request per second
覆盖条件:invocation_mode=api
openlibrary-search-documentation-supplement-2 · 来源文档声明
- 原文定位
- .local\deep-cards-v1\resumed-public-capture-20261024-01\sources\openlibrary-general-20261024-01.text.txt:L140-L150; original HTML lines [813, 825]
- 来源版本
- documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847
- 内容摘要
- 085ae7b9913726a3e234863ac8246e0795496c2fd82920b6c64c26d4deccd15a
- 采集时间
- 2026-10-24T12:09:26.0897354+00:00
If your application will make regular, frequent use of Open Library's APIs (e.g. multiple calls per minute), please add a HEADER that specifies a User-Agent string with (a) the name of your application and (b) your contact email or phone number, so we may contact you when we notice high request volume. In addition, identified requests will enjoy a 3x request limit. Default (non-identified requests): 1 request per second Identified requests (with User-Agent and email ): 3 requests per second
覆盖条件:invocation_mode=api
openlibrary-search-documentation-supplement-3 · 来源文档声明
- 原文定位
- .local\deep-cards-v1\resumed-public-capture-20261024-01\sources\openlibrary-general-20261024-01.text.txt:L119-L138; original HTML lines [778, 810]
- 来源版本
- documentation-set-sha256:3da1c6297c858e63329bb9da9f47fc0b9e29062fb264600375d74b7fd663d847
- 内容摘要
- 085ae7b9913726a3e234863ac8246e0795496c2fd82920b6c64c26d4deccd15a
- 采集时间
- 2026-10-24T12:09:26.0897354+00:00
These APIs are not intended to serve as a bulk data backend or high-traffic commercial infrastructure. For bulk access, please download our free monthly data dumps or contact us at openlibrary@archive.org . Please Do: Make useful, time-sensitive requests on behalf of human users Cache responses whenever possible Identify your application with a User-Agent header and email Please Do Not: Scrape HTML pages (use API endpoints instead) or harvest HTML in bulk Distribute requests across multiple IPs Make hundreds of single-book requests (use search.json for batch results) Use Open Library as a backend for high-traffic commercial services Violations may result in aggressive rate limiting or blocking.
覆盖条件:invocation_mode=api
结构化配方尚未提供或不适用于本版本;旧用法文字保留,连接与执行结果未知。