Para desarrolladores e IA

API y datos de la Wiki

El Centro de Ayuda de Silkroad Latino expone su contenido para que buscadores, agentes y modelos de IA lo consuman fácilmente: archivos llms.txt y Markdown, una API REST de solo lectura, y un servidor MCP. Todo es de solo lectura y de acceso público.

1 · Archivos para IA (llms.txt)

Siguiendo el estándar llmstxt.org. Sin integración: cualquier IA puede leerlos.

GET/llms.txtÍndice curado de la wiki por categoría, con enlaces.

GET/llms-full.txtTodos los artículos concatenados en Markdown (ingesta en un fetch).

GET/faq/{slug}/mdUn artículo en Markdown limpio.

2 · API REST (JSON)

Respuestas JSON con Content-Type: application/json y CORS: * (usable desde el navegador). Cacheables 5 min.

GET/api/articlesLista de artículos publicados + categorías. Filtros: ?category={slug}, ?locale=en

GET/api/articles/{slug}Un artículo: markdown, texto plano y bloques. ?format=md para markdown crudo.

GET/api/search?q={consulta}Búsqueda typo-tolerant. Agregá &semantic=1 para búsqueda semántica (por significado, lenguaje natural) y &limit=N (máx 20).

Ejemplo:

curl "https://wiki.silkroadlatino.com/api/articles/mbot-guia" | jq '.title, .url'
curl "https://wiki.silkroadlatino.com/api/search?q=restablecer%202fa"

3 · Servidor MCP

Servidor Model Context Protocol (transport Streamable HTTP) para que agentes como Claude consulten la wiki como una herramienta. Solo lectura.

Endpoint:  https://wiki.silkroadlatino.com/mcp
Transport: streamable-http (POST JSON-RPC)

Herramientas disponibles:

search_wiki(query) — búsqueda semántica (por significado / lenguaje natural, tolera typos): pasá una pregunta completa y devuelve los artículos más relevantes.
get_article(slug) — contenido completo de un artículo en Markdown.
list_categories() — categorías con su descripción y conteo.
list_articles(category?) — lista de artículos, opcionalmente por categoría.

Conectar en Claude Desktop (u otro cliente que use stdio):

{
  "mcpServers": {
    "silkroad-wiki": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://wiki.silkroadlatino.com/mcp"]
    }
  }
}

En clientes con conectores remotos nativos (Claude.ai), agregá la URL https://wiki.silkroadlatino.com/mcp como conector personalizado.

4 · Límites de uso (fair use)

Para mantener el servicio estable, los endpoints tienen rate-limit por IP. Al superarlo se devuelve 429 Too Many Requests; esperá unos segundos y reintentá.

Recurso	Límite	Ráfaga
/api/* (REST, búsqueda)	100 / min	50
/mcp (servidor MCP)	100 / min	30
Resto del sitio	sin límite estricto	—

Sé buen ciudadano: cacheá las respuestas, no hagas scraping agresivo y preferí /llms-full.txt (un fetch) en vez de recorrer todos los artículos. Para volúmenes altos o casos especiales, escribinos por los canales de la comunidad.

5 · Notas

Contenido en español por defecto; inglés con ?locale=en o bajo /en.
Todo el contenido pertenece a Silkroad Latino. Citá la fuente y enlazá a https://wiki.silkroadlatino.com.
El panel de administración (/admin, /api/admin/*) es privado y no forma parte de esta API.