做国风应用，最耗时间的往往不是页面，是数据。前段时间有朋友做小程序，前后端页面两周搞定，整理底层数据却花了一个月。37万首诗词、按作者查、按朝代筛、全文搜索、简繁切换，这些从零开始搭，项目还没开工精力已经耗掉大半。

最近看到一个开源的中国古典诗词 API 服务，开发者拿到就能用，不用自己建库、清洗、补检索。

数据量很扎实：37万余首诗词、1.3万余位诗人，数据来源于开源项目 chinese-poetry。接口设计实用，不是演示好看，真正接入也顺手。

核心功能

随机返回、全文检索、作者/朝代/体裁列表，做筛选器的时候直接调用。所有接口支持简繁切换。首页推荐、搜索、分类浏览、作者专题，这些常见功能基本都能直接搭起来。

部署一行命令，Docker 直接跑。前端更简单，fetch 直接调，不用申请 Key。

fetch('https://poetry.palemoky.com/api/poems/random?author=李白&lang=zh-Hans')
  .then(res => res.json())
  .then(console.log);

开源协议是 GPLv3，自己内部用、学习研究没问题。深度改造后做闭源分发，记得提前确认协议边界。

不是那种让人眼前一亮的创新项目，概念不新，技术栈也不花哨。但它解决了一个很实在的问题：把最耗时间的边角活都帮你做了。

我觉得这才是开源最值钱的地方，不是炫技，是把别人不愿意干的脏活累活干完，让后面的人站在你肩膀上往前跑。

快速上手

如果你也在找诗词 API，或者需要相关服务器，这个项目可以看一看，能节省不少精力，快速验证业务。

源码：github.com/palemoky/chinese-poetry-api

文档：poetry.palemoky.com