Cliente de API para terminal que guarda solicitudes HTTP, GraphQL, gRPC, WebSocket y SSE en archivos .http de texto plano que puedes versionar con git.
2 mil59GoApache-2.0Actualizado hace 4 días
fullstorydev/grpcurl
Herramienta de línea de comandos para llamar a servidores gRPC, como curl pero con entradas JSON sobre gRPC y detección de esquemas mediante reflexión del servidor o archivos proto.
Alternativa open source a:Postman
- Estrellas
- 12,861
- Forks
- 589
- Issues abiertos
- 121
- Último commit
- hace 9 días
¿Qué es?
grpcurl permite invocar métodos RPC en servidores gRPC desde la línea de comandos. Como gRPC usa Protocol Buffers binarios en la red, curl no puede comunicarse directamente con estos servidores. grpcurl acepta cuerpos de solicitud en JSON, los convierte a protobuf y muestra las respuestas en un formato legible.
La herramienta detecta los esquemas de servicios de tres formas: consulta un servidor que admita la reflexión del servidor gRPC, lee archivos fuente .proto o carga archivos protoset compilados. Admite métodos unarios y de streaming, incluidos los streams bidireccionales controlados de forma interactiva desde una terminal. Funciona con servidores TLS y de texto plano, también con TLS mutuo y certificados de cliente.
Además de la CLI, el repositorio ofrece un paquete de biblioteca Go con funciones auxiliares para crear otras herramientas que invoquen dinámicamente endpoints gRPC.
Funciones clave
- 01Envía cuerpos de solicitud JSON y los convierte automáticamente a protobuf.
- 02Admite métodos unarios, de streaming del servidor, de streaming del cliente y de streaming bidireccional.
- 03Detecta esquemas mediante la reflexión del servidor, archivos .proto o archivos protoset.
- 04Admite conexiones de texto plano, TLS y TLS mutuo.
- 05Enumera servicios y describe símbolos; también puede exportar archivos proto o protoset.
Casos de uso
- Depurar un servicio gRPC enviando solicitudes de prueba desde la terminal.
- Crear scripts para llamadas gRPC en pipelines de shell, por ejemplo, con jq para generar cuerpos de solicitud.
- Explorar una API gRPC desconocida enumerando sus servicios y métodos.
- Crear herramientas internas que invoquen dinámicamente endpoints gRPC mediante la biblioteca Go.
Inicio rápido
- 1
Instala grpcurl en macOS con Homebrew
brew install grpcurl - 2
O instálalo desde el código fuente con la cadena de herramientas de Go
go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest - 3
Enumera los servicios de un servidor compatible con la reflexión
grpcurl localhost:8787 list
Antes de usarlo
- Para invocar, se necesita un servidor gRPC; para conocer el esquema, se requiere la reflexión del servidor, archivos proto o archivos protoset.
Temas
Preguntas frecuentes
- ¿Qué es grpcurl?
- Herramienta de línea de comandos para llamar a servidores gRPC, como curl pero con entradas JSON sobre gRPC y detección de esquemas mediante reflexión del servidor o archivos proto. grpcurl permite invocar métodos RPC en servidores gRPC desde la línea de comandos. Como gRPC usa Protocol Buffers binarios en la red, curl no puede comunicarse directamente con estos servidores. grpcurl acepta cuerpos de solicitud en JSON, los convierte a protobuf y muestra las respuestas en un formato legible.
- ¿grpcurl es gratuito? ¿Qué licencia tiene?
- grpcurl es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿grpcurl sigue mantenido?
- Mantenimiento activo. El último commit de grpcurl fue el 13 oct 2026.
- ¿Para qué puedo usar grpcurl?
- Depurar un servicio gRPC enviando solicitudes de prueba desde la terminal. Crear scripts para llamadas gRPC en pipelines de shell, por ejemplo, con jq para generar cuerpos de solicitud. Explorar una API gRPC desconocida enumerando sus servicios y métodos. Crear herramientas internas que invoquen dinámicamente endpoints gRPC mediante la biblioteca Go.
- ¿Cómo se instala grpcurl?
- Instala grpcurl en macOS con Homebrew: brew install grpcurl O instálalo desde el código fuente con la cadena de herramientas de Go: go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest Enumera los servicios de un servidor compatible con la reflexión: grpcurl localhost:8787 list
- ¿Dónde consigo grpcurl?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/fullstorydev/grpcurl
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Hurl es una herramienta de línea de comandos para ejecutar y probar solicitudes HTTP escritas en archivos de texto plano.
19,3 mil750RustApache-2.0Actualizado ayer
Un cliente HTTP de línea de comandos rápido y fácil de usar que reproduce gran parte de la sintaxis de HTTPie con un inicio más rápido.
8,1 mil151RustMITActualizado hace 4 días
CLI y servidor HTTP que convierten archivos OpenAPI v2/v3 y Postman Collection en API simuladas con validación de solicitudes y un proxy de validación.
5,1 mil414TypeScriptApache-2.0Actualizado hace 10 días
Cliente HTTP de terminal (TUI) que define y ejecuta solicitudes REST a partir de colecciones YAML con control de versiones.
1,2 mil40RustMITActualizado hace 5 días
Cliente HTTP para API que funciona en la terminal, alternativa a Postman e Insomnia, con solicitudes guardadas en archivos YAML.
12,5 mil291GoApache-2.0Actualizado hace 7 días