BoardVault pueden leerlo programas y asistentes de IA además de personas. Todo lo que hay aquí devuelve lo que puede leer un visitante del sitio —hilos, posts y casos de reparación publicados, y la descripción de los archivos públicos— y nada más. Los archivos en sí se descargan en la web, con una cuenta gratuita.
API de lectura
- Dirección base:
https://boardvault.ragoxcell.com/api/v1 - Descripción: OpenAPI 3.1: cada endpoint, parámetro y forma de respuesta.
- Para leer no hace falta clave. Sin clave hay 60 peticiones por minuto y dirección IP. La clave de API de un miembro (Ajustes → Claves de API) lo sube a 120, añade sus documentos propios y compartidos, y es necesaria para
/mey para los enlaces de descarga. - Idioma: envía
Accept-Language: esoen; las direcciones de las respuestas (url) lo siguen. - Los errores son
application/problem+jsoncon unrequest_id.
| Endpoint | Qué devuelve |
|---|---|
GET /search?q=NM-D562 |
Placas, archivos públicos (también por el texto de sus páginas), hilos, posts y casos |
GET /forum/categories |
Categorías del foro |
GET /forum/threads?category=schematics |
Hilos, primero los de actividad más reciente |
GET /forum/threads/{id} |
Un hilo con sus respuestas, votos y solución aceptada |
GET /posts?tag=soldadura |
Posts publicados del blog |
GET /posts/{id} |
Un post (Markdown y HTML) con sus comentarios |
GET /cases?board=820-02020 |
Casos de reparación publicados |
GET /cases/{id} |
Síntoma, diagnóstico, mediciones, componentes y solución |
GET /documents?type=schematic |
Archivos públicos, primero los más nuevos |
GET /documents/{id} |
La descripción de un archivo, sus versiones y su SHA-256 |
GET /boards/{number} |
Una placa escrita de cualquier forma, con sus archivos públicos |
curl "https://boardvault.ragoxcell.com/api/v1/search?q=PU501" -H "Accept-Language: es"
Servidor MCP para asistentes de IA
BoardVault tiene un servidor Model Context Protocol en https://boardvault.ragoxcell.com/mcp (HTTP en streaming, sin iniciar sesión). Sus herramientas son de solo lectura:
search: placas, archivos, hilos, posts y casosget_thread,get_post,get_repair_case,get_document,get_board: leen un elemento por su id o su direcciónlist_recent: lo nuevo (hilos, posts, casos, archivos, categorías del foro)
Claude Code:
claude mcp add --transport http boardvault https://boardvault.ragoxcell.com/mcp
Claude (web y escritorio): Ajustes → Conectores → Añadir conector personalizado, con la dirección https://boardvault.ragoxcell.com/mcp.
Cursor, VS Code y otros clientes:
{ "mcpServers": { "boardvault": { "url": "https://boardvault.ragoxcell.com/mcp" } } }
Usar lo que lees
- Cita la página (
url) y menciona al miembro que la escribió; las aportaciones pertenecen a sus autores. - Respeta los límites de arriba. No se permite descargar archivos de forma masiva (condiciones de uso).
- El contenido lo escriben los miembros y puede contener errores; reparar conlleva riesgos.
También están el mapa del sitio, los feeds Atom del foro, la biblioteca, el blog y los casos de reparación, y un resumen para asistentes de IA en /llms.txt. Dudas: boardvault@ragoxcell.com.