vosviewer

Integración con VOSviewer

Propósito: convertir cualquier conjunto de datos bibliográficos en una red funcional de VOSviewer: ya sea un archivo JSON que se carga directamente en VOSviewer Online (sin instalación), o un par .map + .net para la versión de escritorio.

Cuándo usar esta habilidad

Activa esta habilidad cuando el usuario solicite cualquiera de los siguientes:

• Mapa bibliométrico / bibliometric map
• Rede de coautoria / co-authorship network
• Rede de citação / co-citation network / bibliographic coupling
• Mapa de termos / keyword map / term co-occurrence
• "Visualizar artigos do PubMed/Crossref/Scopus/RIS no VOSviewer"
• "Quero ver a rede de autores/termos/keywords de …"
• Explícitamente: "VOSviewer", "app.vosviewer.com", ".map", ".net", ".json VOSviewer"

Considera también esta habilidad cuando el usuario tenga un conjunto de referencias académicas (fuentes de NotebookLM, acervo, bibliografia_parsed.json) y quiera explorarlo visualmente.

Conceptos fundamentales

VOSviewer trabaja con ítems (nodos) conectados por enlaces (aristas), organizados en clústeres. Los ítems pueden ser autores, documentos, términos, palabras clave, revistas, organizaciones, países, etc.

Cuatro tipos de análisis:

1. Coautoría: ítems = autores/organizaciones/países, fuerza del enlace = número de artículos coescritos
2. Cocitación: ítems = referencias citadas/autores/fuentes, fuerza del enlace = número de documentos que citan ambos
3. Acoplamiento bibliográfico: ítems = documentos/autores/fuentes, fuerza del enlace = número de referencias citadas compartidas
4. Co-ocurrencia: ítems = palabras clave/términos, fuerza del enlace = número de documentos donde ambos aparecen

Formatos de archivo que VOSviewer acepta

Formato	Extensión	Caso de uso
VOSviewer JSON	.json	Mejor para compartir. Un solo archivo se carga en VOSviewer Online mediante URL. Contiene ítems + enlaces + configuración.
Mapa + Red	.map + .net	Formato clásico de escritorio. Separado por tabuladores. .map = ítems, .net = enlaces.
Base de datos bibliográfica	Varios	Exportaciones originales de Web of Science, Scopus, Dimensions, Lens, PubMed (MEDLINE), Crossref JSON, RIS. VOSviewer las analiza directamente.

Regla general: Produce el archivo JSON cuando sea posible: es el más flexible, compartible y funciona en VOSviewer Online (sin necesidad de instalar el escritorio).

Esquema JSON de VOSviewer (esenciales)

{
  "network": {
    "items": [
      {
        "id": 1,                          // entero único
        "label": "cultura digital",       // nombre para mostrar
        "description": "HTML opcional",   // se muestra en el popover
        "url": "https://...",             // clic opcional
        "x": 0.42,                        // opcional; VOSviewer lo calcula si se omite
        "y": -0.17,                       // opcional
        "cluster": 1,                     // id del clúster (entero)
        "weights": {                      // pesos numéricos arbitrarios
          "Documentos": 12,
          "Citas": 58,
          "Fuerza total del enlace": 23
        },
        "scores": {                       // puntuaciones numéricas opcionales para colorear
          "Año promedio de publicación": 2022.4
        }
      }
    ],
    "links": [
      {"source_id": 1, "target_id": 2, "strength": 3}
    ]
  },
  "config": {
    "terminology": {                      // opcional: personalizar etiquetas
      "item": "término", "items": "términos",
      "link": "co-ocurrencia", "links": "co-ocurrencias",
      "cluster": "clúster", "clusters": "clústeres"
    },
    "templates": [                        // opcional: visualización de etiquetas/colores
      { "label_size": {"min": 0.5, "max": 2.0} }
    ]
  }
}

Flujo de trabajo canónico

Sigue estos pasos cuando el usuario solicite una visualización de VOSviewer:

1. Identificar la fuente de datos

Pregunta (o infiere) a partir de:

• Consulta PubMed: usa mcp__7899fadf-...__search_articles + get_article_metadata (este proyecto tiene el MCP de PubMed)
• Crossref: WebFetch https://api.crossref.org/works?query=...&rows=100 (gratuito, sin clave)
• OpenAlex: WebFetch https://api.openalex.org/works?search=...&per_page=100
• Fuentes de NotebookLM: mcp__notebooklm-mcp__source_get_content por fuente
• Archivo local: RIS, BibTeX, CSV, JSON en el proyecto (usa Read/Glob)
• Lista manual: el usuario pega DOIs o títulos

2. Elegir el tipo de análisis

El usuario dice	Tipo de análisis	Ítems	Enlaces por
"rede de autores" / "coautoría"	coautoría	autores	artículos coescritos
"mapa de termos" / "mapa de palabras clave"	co-ocurrencia	palabras clave/términos	co-ocurrencia en resúmenes/títulos
"co-citação" / "cocitación"	cocitación	referencias citadas	co-citados por un artículo común
"artículos similares" / "acoplamiento"	acoplamiento bibliográfico	documentos	referencias compartidas
"mapa de temas" / "temas"	co-ocurrencia	términos	co-ocurrencia

Por defecto cuando sea ambiguo: co-ocurrencia de palabras clave/términos: es el análisis más permisivo y funciona solo con títulos + resúmenes.

3. Construir la red

Usa el script convertidor apropiado en scripts/ (ver más abajo). Todos los scripts generan un archivo JSON de VOSviewer en el proyecto actual.

4. Abrir el resultado

Dos opciones: preséntalas ambas al usuario:

Opción A: VOSviewer Online (sin instalación):

1. Aloja el archivo JSON en cualquier lugar accesible públicamente (GitHub raw, S3, Netlify, Cloudflare R2, un gist, etc.)
2. Construye la URL:

   https://app.vosviewer.com/?json=<URL-codificada-de-la-URL-del-json>
   

3. Comparte esta URL con el usuario. Al hacer clic, la red se carga directamente en el navegador.

Opción B: VOSviewer Escritorio:

1. Guarda el archivo JSON localmente
2. Indica al usuario: abre VOSviewer → Archivo → Abrir → selecciona el archivo JSON
3. Alternativamente, proporciona archivos .map + .net separados por tabuladores

5. Ofrecer ajustes

Después de producir la primera versión, ofrece:

• Filtrar ítems por peso mínimo (ej., palabras clave que aparecen ≥ 5 veces)
• Cambiar la cantidad de clústeres mediante el parámetro de resolución
• Añadir puntuaciones por año para mostrar tendencias temporales (más antiguo = azul, más reciente = rojo)
• Fusionar sinónimos mediante un tesauro (ej., "ia" ↔ "inteligencia artificial")

Scripts

Esta habilidad incluye scripts convertidores listos en scripts/:

• scripts/pubmed_to_vosviewer.py: consulta PubMed → JSON de co-ocurrencia de palabras clave
• scripts/crossref_to_vosviewer.py: consulta Crossref → JSON de coautoría
• scripts/openalex_to_vosviewer.py: consulta OpenAlex → JSON de co-ocurrencia de conceptos
• scripts/ris_to_vosviewer.py: archivo RIS → JSON de co-ocurrencia de palabras clave
• scripts/json_to_map_net.py: convertir JSON de VOSviewer → .map + .net para escritorio
• scripts/open_in_vosviewer.py: construir la URL de VOSviewer Online (o abrir escritorio)

Todos los scripts son Python solo con biblioteca estándar (sin dependencias pip) a menos que se indique lo contrario.

Tesauro (amigable en portugués)

reference/thesaurus-pt.txt contiene normalizaciones comunes de sinónimos en portugués brasileño (ej., ia → inteligência artificial, chatgpt → modelos de linguagem, aps → atenção primária). Cárgalo al construir mapas de co-ocurrencia de términos para conjuntos de datos portugueses de salud/educación.

Convención de ubicación de salida

Guarda todos los archivos producidos en vosviewer-out/ en la raíz del proyecto actual (crea la carpeta si no existe):

vosviewer-out/
├── YYYY-MM-DD_topic.json        # JSON de VOSviewer
├── YYYY-MM-DD_topic.map         # archivo de mapa de escritorio (si se solicita)
├── YYYY-MM-DD_topic.net         # archivo de red de escritorio (si se solicita)
└── README.md                     # Qué se generó, cómo y la URL en línea

Formato de respuesta

Al entregar un resultado de VOSviewer al usuario, SIEMPRE incluye:

1. Resumen del conjunto de datos: fuente, número de ítems, número de enlaces, rango de fechas (si está disponible)
2. Ruta(s) de archivo(s): dónde se guardaron los archivos JSON/map/net
3. URL de VOSviewer Online: si el JSON se alojó en algún lugar accesible
4. Instrucciones para escritorio: una línea sobre cómo abrir el JSON localmente
5. Próximos pasos: qué ajustar a continuación (filtro, cantidad de clústeres, tesauro, etc.)

Mantén la respuesta concisa. No pegues el JSON completo en el chat: solo el resumen y la URL/ruta.

Enlaces de referencia

• Página principal de VOSviewer: https://www.vosviewer.com/
• VOSviewer Online: https://app.vosviewer.com/
• Manual (formato JSON): https://app.vosviewer.com/docs/file-types/json-file-type/
• Manual de escritorio: https://www.vosviewer.com/documentation/Manual_VOSviewer_1.6.20.pdf