# 鹿鸣川书籍搜索 API

鹿鸣川提供公开的中文书籍搜索 API。接口返回 JSON 格式的书籍元数据；资源可用时，同时返回百度网盘或夸克网盘直达链接。

## Endpoint

`GET https://lunarora.com/api/v1/search`

无需 API Key。

## 请求参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `q` | 是 | string | 搜索词，长度为 2–80 个字符，可搜索书名、作者或主题。 |
| `limit` | 否 | integer | 返回数量，默认为 10，范围为 1–100。 |

接口没有 `lang` 参数，返回的书籍元数据语言固定为 `zh-CN`。

## 请求示例

```bash
curl --get 'https://lunarora.com/api/v1/search' \
  --data-urlencode 'q=心理学' \
  --data-urlencode 'limit=10'
```

## 响应示例

```json
{
  "apiVersion": "1",
  "query": "心理学",
  "contentLanguage": "zh-CN",
  "count": 1,
  "limit": 10,
  "downloadLinksStatus": "available",
  "results": [
    {
      "type": "Book",
      "title": "书名",
      "authorsText": "作者",
      "isbn": "9780000000000",
      "description": "书籍简介",
      "tags": ["心理学"],
      "rating": 8.8,
      "bookUrl": "https://lunarora.com/book/9780000000000",
      "coverUrl": "https://lunarora.com/api/cover/9780000000000?size=small",
      "hasDownloadLinks": true,
      "downloadLinks": [
        {
          "provider": "quark",
          "url": "https://pan.quark.cn/s/...",
          "extractionCode": null,
          "description": "EPUB",
          "fileSize": null,
          "updatedAt": "2026-07-23T00:00:00.000Z"
        }
      ]
    }
  ]
}
```

## 下载链接字段

- `downloadLinksStatus`：下载链接 Manifest 的状态，当前可用值为 `available`。
- `hasDownloadLinks`：当前书籍是否有可用网盘链接。
- `downloadLinks[].provider`：网盘提供方，值为 `quark` 或 `baidu`。
- `downloadLinks[].url`：可直接访问的网盘 URL。
- `downloadLinks[].extractionCode`：提取码；不需要提取码时为 `null`。

接口不记录下载点击统计。请根据响应中的缓存头合理缓存结果。

## 错误响应

- `400 Bad Request`：`q` 或 `limit` 不符合要求。
- `503 Service Unavailable`：书籍目录搜索服务暂时不可用，可稍后重试。

## 机器可读文档

- OpenAPI 3.1：https://lunarora.com/openapi.json
- OpenSearch：https://lunarora.com/opensearch.xml
- LLM 简要说明：https://lunarora.com/llms.txt
- LLM 完整说明：https://lunarora.com/llms-full.txt