Envolve qualquer banco de dados SQL com APIs REST e GraphQL instantâneas, um Studio visual de administração e um servidor MCP nativo para agentes de IA.
38,6 mil5 milTypeScriptOtherAtualizado há 24 horas
palemoky/chinese-poetry-api
Serviço de API em Go para poesia clássica chinesa, com endpoints REST e GraphQL e um acervo de quase 400 mil poemas em chinês simplificado e tradicional.
- Estrelas
- 3,465
- Forks
- 455
- Issues abertas
- 8
- Último commit
- há 13 dias
O que é?
chinese-poetry-api é um serviço em Go que disponibiliza um banco de dados de poesia clássica chinesa, incluindo poemas da dinastia Tang, letras da dinastia Song, canções de drama da dinastia Yuan e outros gêneros, com quase 400 mil obras. É possível listar e filtrar poemas por dinastia, autor ou gênero, pesquisar por título, conteúdo ou autor e obter poemas aleatórios, inclusive usando filtros de caracteres individuais para jogos como 飞花令.
A API está disponível via REST e GraphQL. Todos os endpoints aceitam o parâmetro lang para retornar texto em chinês simplificado (zh-Hans) ou tradicional (zh-Hant), já que as duas variantes são armazenadas no mesmo banco de dados. O serviço inclui limitação de requisições por IP integrada, paginação baseada em cursor e uma imagem Docker com builds para amd64 e arm64.
Os dados vêm do dataset chinese-poetry, com correções de erros de digitação e atribuições feitas em um fork mantido pelo autor. O processamento de dados e a inicialização do servidor são gerenciados por um Makefile.
Recursos principais
- 01Disponibiliza APIs REST e GraphQL para poemas, autores, dinastias e gêneros.
- 02Alterna entre chinês simplificado e tradicional usando o parâmetro lang.
- 03Oferece pesquisa de texto completo e busca por título, conteúdo ou autor.
- 04Permite obter poemas aleatórios com filtros, incluindo correspondência de caracteres individuais.
- 05Inclui limitação de requisições por IP e paginação por cursor.
- 06É distribuído como imagem Docker para amd64 e arm64.
Casos de uso
- Adicionar consultas ou citações de poesia clássica a um app ou site.
- Criar um jogo de 飞花令 ou de perguntas sobre poesia usando consultas aleatórias e filtros por caractere.
- Praticar web scraping com uma fonte de dados realista e hospedada localmente.
- Consultar dados de poesia chinesa em escrita tradicional ou simplificada.
Início rápido
- 1
Executar com Docker
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest - 2
Clonar o repositório com os submódulos
git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git - 3
Processar os dados e iniciar o servidor com Makefile
make process-data - 4
Iniciar o servidor
make run-server
Antes de usar
- Os dados de Poetry vêm dos submódulos, então você precisa clonar o repositório incluindo-os ou buscá-los separadamente.
- O fluxo de trabalho com Makefile exige uma etapa de processamento dos dados antes de iniciar o servidor.
Tópicos
Perguntas frequentes
- O que é chinese-poetry-api?
- Serviço de API em Go para poesia clássica chinesa, com endpoints REST e GraphQL e um acervo de quase 400 mil poemas em chinês simplificado e tradicional. chinese-poetry-api é um serviço em Go que disponibiliza um banco de dados de poesia clássica chinesa, incluindo poemas da dinastia Tang, letras da dinastia Song, canções de drama da dinastia Yuan e outros gêneros, com quase 400 mil obras. É possível listar e filtrar poemas por dinastia, autor ou gênero, pesquisar por título, conteúdo ou autor e obter poemas aleatórios, inclusive usando filtros de caracteres individuais para jogos como 飞花令.
- chinese-poetry-api é gratuito? Qual é a licença?
- chinese-poetry-api é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- chinese-poetry-api ainda é mantido?
- Manutenção ativa. O último commit de chinese-poetry-api foi em 7 de out. de 2026.
- Para que posso usar chinese-poetry-api?
- Adicionar consultas ou citações de poesia clássica a um app ou site. Criar um jogo de 飞花令 ou de perguntas sobre poesia usando consultas aleatórias e filtros por caractere. Praticar web scraping com uma fonte de dados realista e hospedada localmente. Consultar dados de poesia chinesa em escrita tradicional ou simplificada.
- Como instalar chinese-poetry-api?
- Executar com Docker: docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest Clonar o repositório com os submódulos: git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git Processar os dados e iniciar o servidor com Makefile: make process-data Iniciar o servidor: make run-server
- Onde consigo chinese-poetry-api?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/palemoky/chinese-poetry-api
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Framework web para Go inspirado no Express, construído sobre o mecanismo fasthttp, para criar APIs REST e servidores web.
40,2 mil2,1 milGoMITAtualizado ontem
Plataforma de desenvolvimento Postgres que oferece um banco Postgres hospedado com autenticação, APIs geradas automaticamente, armazenamento e recursos em tempo real como alternativa ao Firebase.
111,8 mil17,2 milTypeScriptApache-2.0Atualizado há 16 horas
Moby é o projeto open source de containers do Docker, com componentes modulares para criar, executar e orquestrar sistemas baseados em containers.
72,2 mil19,3 milGoApache-2.0Atualizado ontem
Um mecanismo de busca rápido e tolerante a erros de digitação, com API para buscas textuais, semânticas e híbridas em sites e aplicativos.
59,6 mil2,8 milRustOtherAtualizado há 9 horas
Framework de código aberto em Go que organiza prompts reutilizáveis de IA, chamados Patterns, por tarefa e os executa pela linha de comando ou por uma REST API.
44,4 mil4,3 milGoMITAtualizado anteontem