VOSviewer

VOSviewer-Integration

Zweck: Jeden bibliografischen Datensatz in ein funktionsfähiges VOSviewer-Netzwerk umwandeln – entweder als JSON-Datei, die direkt in VOSviewer Online geladen wird (keine Installation), oder als .map- + .net-Paar für die Desktop-Version.

Wann dieser Skill verwendet werden sollte

Lösen Sie diesen Skill aus, wenn der Benutzer nach einem der folgenden Punkte fragt:

• Mapa bibliométrico / bibliometrische Karte
• Rede de coautoria / Koautorschaftsnetzwerk
• Rede de citação / Ko-Zitationsnetzwerk / bibliografische Kopplung
• Mapa de termos / Begriffskarte / Begriffsko-Okkurrenz
• "Visualizar artigos do PubMed/Crossref/Scopus/RIS no VOSviewer"
• "Quero ver a rede de autores/termos/keywords de …"
• Explizit: "VOSviewer", "app.vosviewer.com", ".map", ".net", ".json VOSviewer"

Ziehen Sie diesen Skill auch in Betracht, wenn der Benutzer einen Datensatz mit akademischen Referenzen (NotebookLM-Quellen, acervo, bibliografia_parsed.json) hat und diesen visuell erkunden möchte.

Kernkonzepte

VOSviewer arbeitet mit Items (Knoten), die durch Links (Kanten) verbunden sind und in Clustern organisiert sind. Items können Autoren, Dokumente, Begriffe, Schlüsselwörter, Zeitschriften, Organisationen, Länder usw. sein.

Vier Analysetypen:

1. Koautorschaft: Items = Autoren/Organisationen/Länder, Linkstärke = Anzahl gemeinsamer Veröffentlichungen
2. Ko-Zitation: Items = zitierte Referenzen/Autoren/Quellen, Linkstärke = Anzahl der Dokumente, die beide zitieren
3. Bibliografische Kopplung: Items = Dokumente/Autoren/Quellen, Linkstärke = Anzahl gemeinsamer zitierter Referenzen
4. Ko-Okkurrenz: Items = Schlüsselwörter/Begriffe, Linkstärke = Anzahl der Dokumente, in denen beide vorkommen

Von VOSviewer akzeptierte Dateiformate

Format	Erweiterung	Verwendungszweck
VOSviewer JSON	.json	Am besten zum Teilen. Einzelne Datei, die über URL in VOSviewer Online geladen wird. Enthält Items + Links + Konfiguration.
Map + Network	.map + .net	Klassisches Desktop-Format. Tabulatorgetrennt. .map = Items, .net = Links.
Bibliografische DB	Verschiedene	Rohexporte aus Web of Science, Scopus, Dimensions, Lens, PubMed (MEDLINE), Crossref JSON, RIS. VOSviewer parst diese direkt.

Faustregel: Erstellen Sie nach Möglichkeit die JSON-Datei: Sie ist am flexibelsten, am einfachsten teilbar und funktioniert in VOSviewer Online (keine Desktop-Installation erforderlich).

VOSviewer JSON-Schema (wesentlich)

{
  "network": {
    "items": [
      {
        "id": 1,                          // eindeutige Ganzzahl
        "label": "cultura digital",       // Anzeigename
        "description": "optionales HTML",   // wird im Popover angezeigt
        "url": "https://...",             // optionaler Durchklick
        "x": 0.42,                        // optional; VOSviewer berechnet, falls nicht angegeben
        "y": -0.17,                       // optional
        "cluster": 1,                     // ganzzahlige Cluster-ID
        "weights": {                      // beliebige numerische Gewichte
          "Dokumente": 12,
          "Zitationen": 58,
          "Gesamte Linkstärke": 23
        },
        "scores": {                       // optionale numerische Werte zur Färbung
          "Durchschn. Pub.-Jahr": 2022.4
        }
      }
    ],
    "links": [
      {"source_id": 1, "target_id": 2, "strength": 3}
    ]
  },
  "config": {
    "terminology": {                      // optional: Bezeichnungen anpassen
      "item": "Begriff", "items": "Begriffe",
      "link": "Ko-Okkurrenz", "links": "Ko-Okkurrenzen",
      "cluster": "Cluster", "clusters": "Cluster"
    },
    "templates": [                        // optional: Label-/Farbvisualisierung
      { "label_size": {"min": 0.5, "max": 2.0} }
    ]
  }
}

Kanonischer Workflow

Führen Sie die folgenden Schritte aus, wenn der Benutzer eine VOSviewer-Visualisierung anfordert:

1. Datenquelle identifizieren

Fragen Sie (oder leiten Sie ab):

• PubMed-Abfrage: verwenden Sie mcp__7899fadf-...__search_articles + get_article_metadata (dieses Projekt hat den PubMed MCP)
• Crossref: WebFetch https://api.crossref.org/works?query=...&rows=100 (kostenlos, kein Schlüssel)
• OpenAlex: WebFetch https://api.openalex.org/works?search=...&per_page=100
• NotebookLM-Quellen: mcp__notebooklm-mcp__source_get_content pro Quelle
• Lokale Datei: RIS, BibTeX, CSV, JSON im Projekt (verwenden Sie Read/Glob)
• Manuelle Liste: Benutzer fügt DOIs oder Titel ein

2. Analysetyp auswählen

Benutzer sagt	Analysetyp	Items	Verbindung nach
"rede de autores" / "co-authorship"	Koautorschaft	Autoren	gemeinsame Veröffentlichungen
"mapa de termos" / "keyword map"	Ko-Okkurrenz	Schlüsselwörter/Begriffe	Ko-Okkurrenz in Zusammenfassungen/Titeln
"co-citação" / "co-citation"	Ko-Zitation	zitierte Referenzen	gemeinsame Zitation durch ein gemeinsames Papier
"artigos similares" / "coupling"	bibliografische Kopplung	Dokumente	gemeinsame Referenzen
"mapa de temas" / "themes"	Ko-Okkurrenz	Begriffe	Ko-Okkurrenz

Standard bei Unklarheit: Schlüsselwort-/Begriffsko-Okkurrenz: Dies ist die nachsichtigste Analyse und funktioniert nur mit Titeln + Zusammenfassungen.

3. Netzwerk erstellen

Verwenden Sie das entsprechende Konverterskript in scripts/ (siehe unten). Alle Skripte geben eine VOSviewer-JSON-Datei im aktuellen Projekt aus.

4. Ergebnis öffnen

Zwei Optionen: Beide dem Benutzer präsentieren:

Option A: VOSviewer Online (keine Installation):

1. Hosten Sie die JSON-Datei an einem öffentlich erreichbaren Ort (GitHub raw, S3, Netlify, Cloudflare R2, ein Gist usw.)
2. Erstellen Sie die URL:

   https://app.vosviewer.com/?json=<URL-kodierte-URL-zur-json>
   

3. Teilen Sie diese URL mit dem Benutzer. Durch Klicken wird das Netzwerk direkt im Browser geladen.

Option B: VOSviewer Desktop:

1. Speichern Sie die JSON-Datei lokal
2. Weisen Sie den Benutzer an: VOSviewer öffnen → Datei → Öffnen → JSON-Datei auswählen
3. Alternativ stellen Sie .map- + .net-Dateien (tabulatorgetrennt) bereit

5. Optimierung anbieten

Nach der Erstellung der ersten Version bieten Sie an:

• Items nach Mindestgewicht filtern (z. B. Schlüsselwörter, die ≥ 5 Mal vorkommen)
• Clusteranzahl über den Auflösungsparameter ändern
• Jahreszahlenwerte hinzufügen, um zeitliche Trends anzuzeigen (ältestes = blau, neuestes = rot)
• Synonyme über ein Thesaurus zusammenführen (z. B. "KI" ↔ "künstliche Intelligenz")

Skripte

Dieser Skill enthält fertige Konverterskripte in scripts/:

• scripts/pubmed_to_vosviewer.py: PubMed-Abfrage → JSON für Schlüsselwortko-Okkurrenz
• scripts/crossref_to_vosviewer.py: Crossref-Abfrage → JSON für Koautorschaft
• scripts/openalex_to_vosviewer.py: OpenAlex-Abfrage → JSON für Konzeptko-Okkurrenz
• scripts/ris_to_vosviewer.py: RIS-Datei → JSON für Schlüsselwortko-Okkurrenz
• scripts/json_to_map_net.py: VOSviewer-JSON in .map + .net für Desktop konvertieren
• scripts/open_in_vosviewer.py: VOSviewer-Online-URL erstellen (oder Desktop öffnen)

Alle Skripte sind reine Python-Standardbibliothek (keine pip-Abhängigkeiten), sofern nicht anders angegeben.

Thesaurus (portugiesischfreundlich)

reference/thesaurus-pt.txt enthält gebräuchliche brasilianisch-portugiesische Synonymnormalisierungen (z. B. ia → inteligência artificial, chatgpt → modelos de linguagem, aps → atenção primária). Laden Sie dieses Thesaurus, wenn Sie Begriffsko-Okkurrenzkarten für portugiesische Gesundheits-/Bildungsdatensätze erstellen.

Konvention für Ausgabeverzeichnis

Speichern Sie alle erstellten Dateien in vosviewer-out/ im aktuellen Projektstammverzeichnis (ggf. erstellen):

vosviewer-out/
├── YYYY-MM-DD_topic.json        # VOSviewer JSON
├── YYYY-MM-DD_topic.map         # Desktop-Map-Datei (falls angefordert)
├── YYYY-MM-DD_topic.net         # Desktop-Netzwerkdatei (falls angefordert)
└── README.md                     # Was erstellt wurde, wie und die Online-URL

Antwortformat

Geben Sie dem Benutzer bei der Übermittlung eines VOSviewer-Ergebnisses IMMER Folgendes mit:

1. Datensatzübersicht: Quelle, Anzahl der Items, Anzahl der Links, Datumsbereich (falls verfügbar)
2. Dateipfad(e): Wo die JSON/Map/Net-Dateien gespeichert wurden
3. VOSviewer-Online-URL: falls das JSON an einem erreichbaren Ort gehostet wurde
4. Desktop-Anleitung: ein Satz, wie die JSON-Datei lokal geöffnet wird
5. Nächste Schritte: Was als Nächstes optimiert werden kann (Filter, Clusteranzahl, Thesaurus usw.)

Halten Sie die Antwort prägnant. Fügen Sie das vollständige JSON nicht in den Chat ein: nur die Zusammenfassung und die URL/den Pfad.

Referenzlinks

• VOSviewer-Startseite: https://www.vosviewer.com/
• VOSviewer Online: https://app.vosviewer.com/
• Handbuch (JSON-Format): https://app.vosviewer.com/docs/file-types/json-file-type/
• Desktop-Handbuch: https://www.vosviewer.com/documentation/Manual_VOSviewer_1.6.20.pdf