chinese-poetry-api(诗泉)是一个基于 Go 语言编写的高性能中国古诗词 API 服务,托管在 GitHub 上并采用开源方式发布。它把唐诗、宋词、元曲、诗经、楚辞等近 40 万首诗词整理成开箱即用的接口,同时提供 REST 与 GraphQL 两种调用方式,并内置简体与繁体中文双语支持,通过 lang 参数即可切换。项目提供 Docker 镜像,一条命令就能在本地或服务器上跑起来,也提供在线版供直接体验。对于做古诗词产品、国学应用或 AI 国学助手的开发者来说,它省去了自行采集、清洗、校对几十万条诗词数据的繁琐环节,让数据层直接可用。
痛点是什么
做古诗词类产品,真正让人头大的往往不是页面和交互,而是数据。几十万条诗词要从哪里来、错字怎么校、朝代与作者怎么对应、简繁体怎么同时支持,每一项都是体力活。自己爬取不仅耗时,还容易遇到版权与数据质量问题;即便拿到原始数据,还要再设计数据库、写查询接口、做分页与搜索。很多小团队和个人开发者就卡在这一步,创意还没验证,精力已经耗在整理数据上,项目迟迟无法进入真正的产品开发阶段。
主要功能特点
chinese-poetry-api 把数据整理与接口服务一次性做好,开发者只需调用即可,覆盖搜索、随机取诗、分类浏览等常见需求。
海量诗词数据开箱即用
收录近 40 万首诗词,涵盖唐诗、宋词、元曲、诗经、楚辞等,无需自行采集校对。
REST 与 GraphQL 双接口
同时提供两种调用方式,按项目习惯选择,前端后端都能快速接入。
简繁双语与强大搜索
同一数据库存储简繁中文,支持全文、标题、内容、作者分类搜索。
随机诗词与飞花令场景
支持按作者、体裁、朝代过滤随机取诗,还能按单字检索,适配飞花令玩法。
为什么值得关注
它最值钱的地方不是诗多,而是这些诗已经能直接拿来做东西,从数据到接口的链路被彻底打通。
Docker 一键部署
官方镜像开箱即用,支持多架构,本地或服务器都能快速启动服务。
适合快速验证产品创意
飞花令、每日一诗、儿童背诗、猜作者、AI 国学助手等场景都能直接接入。
项目地址:https://github.com/palemoky/chinese-poetry-api,在线版:https://poetry.palemoky.com。
做古诗词产品,真正让人头大的,往往不是页面。
而是你得先自己整理几十万条诗词数据。
这个 GitHub 项目 诗泉,直接把这一步省掉了。
接近 40 万首唐诗、宋词、元曲、诗经、楚辞,已经整理成现成 API。
想做:
飞花令
每日一诗
儿童背诗
猜作者
古诗词搜索
AI 国学助手
基本都能直接接。
我刚拿它做了个“小学生古诗闯关” HTML,补下一句、猜作者、飞花令,很快就跑起来了。
它最值钱的不是“诗多”,而是这些诗已经能直接拿来做东西。
还有在线版,国内一般也能直接打开体验。
在线版:
https://poetry.palemoky.com/
GitHub:
https://github.com/palemoky/chinese-poetry-api