Python技术迷

chinese-poetry-api:近 40 万首古诗词,一行 Docker 就能起个接口服务

好家伙,东哥刷到 chinese-poetry-api 的时候,第一反应不是“文艺”,而是:这玩意儿省后端活啊。

它把唐诗、宋词、元曲、诗经、楚辞这些古诗词数据,整理成一个开箱即用的 API 服务。项目页里写的是基于 Go,支持 REST 和 GraphQL,数据量接近 40 万首,还能按朝代、作者、诗词类型去分。

Image

这类东西最适合谁?给网站、小程序、博客、电子墨水屏、桌面小组件加点“今日诗词”的朋友。以前真要自己整,先找数据,再清洗,再想接口结构,最后还得处理搜索,挺烦。

它这里直接给了搜索和随机接口,比如搜“静夜思”,或者随机来一首李白,甚至能带作者、类型、朝代过滤。简繁体也不是另起一套库,参数里加 lang=zh-Hant 就行。

部署也很直:

docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest

东哥看到一键 Docker,一般还会顺手看三件事:端口、配置文件、数据怎么跟着走。这个项目仓库里有 docker-compose.yml、.env.example,数据部分用 submodule 管着,自己改部署时别忘了把 submodule 拉下来,不然本地跑着跑着就开始迷糊。

Image

还有个点挺实用:它内置 IP 限流,支持 amd64/arm64 镜像。小项目可能用不上,但公网挂出去的话,限流这东西有总比没有强,尤其是免费服务器,被人刷几下就难受。

别把它想复杂了,它不是“AI 诗词鉴赏大师”,更像一个干净的古诗词后端底座。要做氛围感、随机诗句、搜索页、作者页,这就够了。

GitHub地址:palemoky/chinese-poetry-api。