chinese-poetry-api开源古诗词在线免费API接口网站分享

一、项目基础概述

GitHub开源项目chinese-poetry-api是一套基于Go语言开发的古诗词接口服务，内置近40万首古典诗词数据，涵盖唐诗、宋词、元曲、诗经、楚辞等传统文学素材，开箱即用无需额外导入数据库。项目同时提供REST API、GraphQL两套接口，搭配Docker容器一键部署，适合博客、小程序、网站、AI工具接入诗词素材。

二、项目核心功能特性

1、海量完整诗词素材库

数据库整合近40万首经典古诗词，覆盖多朝代文学作品，可按朝代、作者、文体类型做分类筛选，素材覆盖范围广，满足绝大多数内容展示、文案生成、文学查询需求。

2、高性能底层架构

后端采用Go语言开发，原生支持高并发请求；内置简繁体极速转换逻辑，单次转换仅需300纳秒，接口响应速度快，大量并发访问场景下不会出现卡顿延迟。

3、多维度检索能力

• 全文检索：输入任意词句，匹配标题、正文、注释内容；

• 精准筛选：单独按作者、朝代、诗词体裁过滤数据；

• 随机获取接口：一键随机返回单首/多首诗词，适合每日诗词展示功能；

4、简繁体一键切换

数据库同时存储简体、繁体两套文本，调用接口时仅需携带URL参数 ?lang=zh-Hans（简体）、?lang=zh-Hant（繁体），无需前端自行转换文字。

5、双接口协议支持

同时提供REST标准接口与GraphQL灵活查询接口，小型项目使用REST快速开发；复杂多条件组合查询场景选用GraphQL，按需获取字段，减少无效数据传输。

6、内置防护与运维能力

自带IP访问限流机制，限制单IP短时间高频请求，避免接口被恶意爬虫滥用，保障服务稳定运行；适配amd64、arm64多服务器架构，云主机、树莓派均可部署。

7、Docker容器化快速部署

官方打包完整镜像，一行Docker命令即可启动完整API服务，无需配置Go环境、数据库，本地、服务器均可快速搭建私有诗词接口服务。

三、Docker最简部署命令

执行以下命令即可后台启动服务，本地1279端口访问接口：

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

四、适用开发场景

• 个人博客、资讯网站，添加每日古诗词板块；

• 微信小程序、APP文学类素材接口；

• AI文案、写作辅助工具，批量调取诗词素材；

• 编程学习爬虫练习，用于接口爬取实训；

• 校园、传统文化类网站诗词检索功能；

五、项目优势总结

chinese-poetry-api整合海量诗词数据，依托Go语言实现高并发接口服务，兼顾部署便捷性与检索灵活性。Docker一键部署降低搭建门槛，简繁体切换、双接口、限流防护等配套功能齐全，无论是直接使用官方在线接口，还是本地私有化部署私有API，都是低成本获取古诗词素材的优质开源方案。