palemoky/chinese-poetry-api

これは何？

主な機能

• 01詩・作者・王朝・ジャンルを扱うREST APIとGraphQL APIを提供します。
• 02langパラメーターで簡体字と繁体字を切り替えられます。
• 03全文検索に加え、題名・本文・作者を対象に検索できます。
• 04一文字での一致を含むフィルターを指定して、ランダムに詩を取得できます。
• 05IPごとのレート制限とカーソルページネーションを備えています。
• 06amd64とarm64に対応したDockerイメージを提供します。

ユースケース

• アプリやWebサイトに古典詩の検索機能や引用を追加する。
• ランダム取得や文字フィルターを使って、飛花令や詩のクイズゲームを作る。
• 現実的なセルフホスト型データソースを使って、Webスクレイピングを練習する。
• 繁体字または簡体字の中国語表記で詩のデータを検索する。

クイックスタート

1. 1

   Dockerで実行する

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

   サブモジュールを含めてリポジトリをクローンする

   git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git
3. 3

   Makefileでデータを処理してサーバーを起動する

   make process-data
4. 4

   サーバーを起動する

   make run-server

使う前に知っておきたいこと

• !Poetryのデータはサブモジュールから取得するため、サブモジュールを含めてクローンするか、別途取得する必要があります。
• !Makefileを使う場合、サーバーを起動する前にデータ処理の手順を実行する必要があります。

トピック

よくある質問

chinese-poetry-api とは？

約40万首の簡体字・繁体字中国語の古典詩を収録し、RESTとGraphQLのエンドポイントを提供するGo製APIサービス。 chinese-poetry-apiは、中国古典詩のデータベースを提供するGoサービスです。唐詩、宋詞、元曲など約40万作品を収録しています。詩を一覧表示したり、王朝・作者・ジャンルで絞り込んだり、題名・本文・作者で検索したりできるほか、飛花令のような遊びに使える一文字フィルターを含め、ランダムに詩を取得できます。

chinese-poetry-api は無料で使えますか？ライセンスは？

chinese-poetry-api は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

chinese-poetry-api は今もメンテナンスされていますか？

活発にメンテナンス中。chinese-poetry-api の最終コミットは 2026年10月7日 です。

chinese-poetry-api は何に使えますか？

アプリやWebサイトに古典詩の検索機能や引用を追加する。 ランダム取得や文字フィルターを使って、飛花令や詩のクイズゲームを作る。 現実的なセルフホスト型データソースを使って、Webスクレイピングを練習する。 繁体字または簡体字の中国語表記で詩のデータを検索する。

chinese-poetry-api のインストール方法は？

Dockerで実行する: docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest サブモジュールを含めてリポジトリをクローンする: git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git Makefileでデータを処理してサーバーを起動する: make process-data サーバーを起動する: make run-server

chinese-poetry-api はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/palemoky/chinese-poetry-api