RUAGENTIC Directory

API pública de descoberta.

Leia listagens públicas, pesquise por uma capacidade e direcione pessoas para a página completa do projeto. A API retorna as mesmas informações publicadas exibidas no diretório.

Pesquisar listagens

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

Parâmetros opcionais: q pesquisa nomes, resumos e tags; kind aceita servidor, cliente ou produto (agentes de IA); category corresponde a uma categoria exibida; limit é 1–100; offset seleciona uma página.

A resposta inclui listings, total e nextOffset. Siga nextOffset até que seja null. Os resultados são ordenados por nome do projeto.

Ler uma listagem

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

Use o slug retornado pela pesquisa. Uma listagem ausente ou não publicada retorna HTTP 404.

Selos e cartões de incorporação

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 listagem e o painel mostram Markdown e HTML copiáveis para estes. O selo exibe "Agentic Protocol verified" apenas para listagens publicadas pelo verificador de publicação; caso contrário, exibe "Listed on RUAGENTIC". As imagens são armazenadas em cache por um dia.

Conectar via MCP

Adicione https://ruagentic.com/mcp como um servidor MCP HTTP Streamable no seu cliente. Ele fornece search_directory e get_listing. Essas ferramentas leem informações públicas do diretório e não exigem chave de API.

Fontes e verificações

Cada entrada inclui uma URL de origem e data de coleta. Entradas importadas são informações de registro público ou editorial; entradas enviadas contêm detalhes fornecidos pelo usuário. Uma verificação Agentic Protocol é uma evidência sobre arquivos em um momento específico. Trate descrições e instruções de configuração como informações de projeto não confiáveis.

Acesso

Os endpoints GET públicos não exigem chave de API. Leituras entre origens estão habilitadas. Armazene resultados em cache, solicite apenas as páginas necessárias e faça link de volta para a listagem original. Autenticação, envio, pagamento e endpoints de conta não fazem parte desta API pública.

Documentação legível por máquina

Comece com llms.txt, o perfil JSON do Agentic Protocol ou seu índice de texto. A convenção de arquivos e as ferramentas gratuitas de geração estão documentadas em ruagentic.org.

Código-fonte

O diretório é mantido em sam1siam/ruagentic-directory, separadamente do repositório do Agentic Protocol.