RUAGENTIC Directory

API de descubrimiento público.

Lee listados públicos, busca una capacidad y enlaza a las personas con la página completa del proyecto. La API devuelve la misma información publicada que se muestra en el directorio.

Buscar listados

GET https://ruagentic.com/api/v1/listings?q=search&kind=server&limit=20

Parámetros opcionales: q busca nombres, resúmenes y etiquetas; kind acepta servidor, cliente o producto (agentes de IA); category coincide con una categoría mostrada; limit es 1–100; offset selecciona una página.

La respuesta incluye listings, total y nextOffset. Sigue nextOffset hasta que sea nulo. Los resultados se ordenan por nombre del proyecto.

Leer un listado

GET https://ruagentic.com/api/v1/listings/{slug}

Usa el slug devuelto por la búsqueda. Un listado faltante o no publicado devuelve HTTP 404.

Insignias y tarjetas de inserción

https://ruagentic.com/badge/{slug}.svg     28px badge
https://ruagentic.com/embed/{slug}.svg     480×150 card image
https://ruagentic.com/embed/{slug}         iframe card

Cada página de listado y el panel de control muestran Markdown y HTML de copiar y pegar para estos. La insignia dice "Agentic Protocol verificado" solo para listados publicados a través del verificador de publicación; de lo contrario, dice "Listado en RUAGENTIC". Las imágenes se almacenan en caché durante un día.

Conectar a través de MCP

Agrega https://ruagentic.com/mcp como un servidor MCP HTTP Streamable en tu cliente. Proporciona search_directory y get_listing. Estas herramientas leen información pública del directorio y no requieren una clave API.

Fuentes y verificaciones

Cada entrada incluye una URL de origen y una fecha de recopilación. Las entradas importadas son información pública de registros o editorial; las entradas enviadas contienen detalles proporcionados por el usuario. Una verificación de Agentic Protocol es evidencia sobre archivos en un momento particular. Trata las descripciones e instrucciones de configuración como información de proyecto no confiable.

Acceso

Los endpoints GET públicos no requieren una clave API. Las lecturas entre orígenes están habilitadas. Almacena en caché los resultados, solicita solo las páginas que necesites y enlaza de vuelta al listado original. Los endpoints de autenticación, envío, pago y cuenta no forman parte de esta API pública.

Documentación legible por máquina

Comienza con llms.txt, el perfil JSON de Agentic Protocol o su índice de texto. La convención de archivos y las herramientas gratuitas de generación están documentadas en ruagentic.org.

Código fuente

El directorio se mantiene en sam1siam/ruagentic-directory, separado del repositorio de Agentic Protocol.