Envuelve cualquier base de datos SQL con APIs REST y GraphQL instantáneas, un Studio visual de administración y un servidor MCP nativo para agentes de IA.
38,6 mil5 milTypeScriptOtherActualizado hace 24 horas
palemoky/chinese-poetry-api
Servicio de API en Go para poesía clásica china, con endpoints REST y GraphQL sobre un corpus de casi 400.000 poemas en chino simplificado y tradicional.
- Estrellas
- 3,465
- Forks
- 455
- Issues abiertos
- 8
- Último commit
- hace 13 días
¿Qué es?
chinese-poetry-api es un servicio en Go que ofrece una base de datos de poesía clásica china, con poemas de la dinastía Tang, letras de la dinastía Song, canciones de teatro de la dinastía Yuan y más: casi 400.000 obras. Los poemas se pueden listar, filtrar por dinastía, autor o género, buscar por título, contenido o autor, y obtener al azar, incluso con filtros de un solo carácter para juegos como 飞花令.
La API está disponible tanto mediante REST como mediante GraphQL. Todos los endpoints aceptan un parámetro lang para devolver texto en chino simplificado (zh-Hans) o tradicional (zh-Hant), ya que ambas variantes se almacenan en la misma base de datos. El servicio incluye limitación de solicitudes por IP integrada, paginación basada en cursores y una imagen de Docker con versiones para amd64 y arm64.
Los datos provienen del conjunto de datos chinese-poetry, con correcciones de erratas y atribuciones de un fork mantenido por el autor. El procesamiento de datos y el inicio del servidor se gestionan mediante un Makefile.
Funciones clave
- 01Ofrece API REST y GraphQL para poemas, autores, dinastías y géneros.
- 02Permite cambiar entre chino simplificado y tradicional mediante un parámetro lang.
- 03Admite búsqueda de texto completo y búsquedas por título, contenido o autor.
- 04Permite obtener poemas al azar con filtros, incluida la coincidencia de un solo carácter.
- 05Incluye limitación de solicitudes por IP y paginación por cursor.
- 06Se distribuye como imagen de Docker para amd64 y arm64.
Casos de uso
- Añadir consultas o citas de poesía clásica a una aplicación o sitio web.
- Crear un juego de 飞花令 o de preguntas sobre poesía mediante consultas aleatorias y filtros por carácter.
- Practicar web scraping con una fuente de datos realista y autohospedada.
- Consultar datos de poesía china en escritura tradicional o simplificada.
Inicio rápido
- 1
Ejecutar con Docker
docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest - 2
Clonar el repositorio con los submódulos
git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git - 3
Procesar los datos e iniciar el servidor con Makefile
make process-data - 4
Iniciar el servidor
make run-server
Antes de usarlo
- Los datos de Poetry se obtienen de los submódulos, por lo que debes clonar el repositorio con ellos o descargarlos por separado.
- El flujo de trabajo con Makefile requiere procesar los datos antes de iniciar el servidor.
Temas
Preguntas frecuentes
- ¿Qué es chinese-poetry-api?
- Servicio de API en Go para poesía clásica china, con endpoints REST y GraphQL sobre un corpus de casi 400.000 poemas en chino simplificado y tradicional. chinese-poetry-api es un servicio en Go que ofrece una base de datos de poesía clásica china, con poemas de la dinastía Tang, letras de la dinastía Song, canciones de teatro de la dinastía Yuan y más: casi 400.000 obras. Los poemas se pueden listar, filtrar por dinastía, autor o género, buscar por título, contenido o autor, y obtener al azar, incluso con filtros de un solo carácter para juegos como 飞花令.
- ¿chinese-poetry-api es gratuito? ¿Qué licencia tiene?
- chinese-poetry-api es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿chinese-poetry-api sigue mantenido?
- Mantenimiento activo. El último commit de chinese-poetry-api fue el 7 oct 2026.
- ¿Para qué puedo usar chinese-poetry-api?
- Añadir consultas o citas de poesía clásica a una aplicación o sitio web. Crear un juego de 飞花令 o de preguntas sobre poesía mediante consultas aleatorias y filtros por carácter. Practicar web scraping con una fuente de datos realista y autohospedada. Consultar datos de poesía china en escritura tradicional o simplificada.
- ¿Cómo se instala chinese-poetry-api?
- Ejecutar con Docker: docker run -d -p 1279:1279 palemoky/chinese-poetry-api:latest Clonar el repositorio con los submódulos: git clone --recurse-submodules --depth=1 https://github.com/palemoky/chinese-poetry-api.git Procesar los datos e iniciar el servidor con Makefile: make process-data Iniciar el servidor: make run-server
- ¿Dónde consigo chinese-poetry-api?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/palemoky/chinese-poetry-api
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Framework web para Go inspirado en Express y basado en el motor fasthttp, para crear REST APIs y servidores web.
40,2 mil2,1 milGoMITActualizado ayer
La plataforma de desarrollo basada en Postgres ofrece una base de datos Postgres alojada con autenticación, APIs autogeneradas, almacenamiento y funciones en tiempo real, como alternativa a Firebase.
111,8 mil17,2 milTypeScriptApache-2.0Actualizado hace 16 horas
Moby es el proyecto de contenedores de código abierto de Docker, con componentes modulares para crear, ejecutar y orquestar sistemas basados en contenedores.
72,2 mil19,3 milGoApache-2.0Actualizado ayer
Un motor de búsqueda rápido y tolerante a errores tipográficos, con una API para búsquedas de texto completo, semánticas e híbridas en sitios web y aplicaciones.
59,6 mil2,8 milRustOtherActualizado hace 9 horas
Framework de código abierto escrito en Go que organiza prompts de IA reutilizables (llamados Patterns) por tarea y permite ejecutarlos desde la línea de comandos o una API REST.
44,4 mil4,3 milGoMITActualizado anteayer