Was macht Zitationsverwaltung?
Übersicht
Verwalte Zitationen systematisch während des gesamten Forschungs- und Schreibprozesses. Dieses Skill bietet Werkzeuge und Strategien für die Suche in akademischen Datenbanken (Google Scholar, PubMed), die Extraktion genauer Metadaten aus mehreren Quellen (CrossRef, PubMed, arXiv), die Validierung von Zitierinformationen und die Erstellung korrekt formatierter BibTeX-Einträge.
Entscheidend für die Aufrechterhaltung der Zitiergenauigkeit, die Vermeidung von Referenzfehlern und die Sicherstellung reproduzierbarer Forschung. Integriert sich nahtlos in das Literaturrecherche-Skill für umfassende Forschungs-Workflows.
Wann dieses Skill verwenden
Verwende dieses Skill, wenn:
- Du nach bestimmten Artikeln auf Google Scholar oder PubMed suchst
- Du DOIs, PMIDs oder arXiv-IDs in korrekt formatierte BibTeX konvertierst
- Du vollständige Metadaten für Zitationen extrahierst (Autoren, Titel, Zeitschrift, Jahr, usw.)
- Du bestehende Zitationen auf Genauigkeit überprüfst
- Du BibTeX-Dateien bereinigst und formatierst
- Du stark zitierte Artikel in einem bestimmten Bereich findest
- Du sicherstellst, dass Zitierinformationen mit der tatsächlichen Veröffentlichung übereinstimmen
- Du eine Bibliographie für ein Manuskript oder eine Abschlussarbeit erstellst
- Du auf doppelte Zitationen prüfst
- Du ein konsistentes Zitierformat sicherstellst
Wenn ein Dokument, das aus diesen Zitationen erstellt wird, ein Diagramm benötigt, verwende das scientific-schematics-Skill.
Kern-Workflow
Die Zitationsverwaltung folgt einem systematischen Prozess. Jede Phase unten zeigt den kanonischen Befehl; jede Variante, Option und Metadatenquellendetails finden sich in references/core_workflow.md.
Phase 1: Artikelsuche und -entdeckung
Finde relevante Artikel. Durchsuche mehr als eine Datenbank – die Abdeckung unterscheidet sich stark und eine einzige Quelle ist die häufigste Ursache für eine verzerrte Referenzliste.
# OpenAlex: multidisziplinäre REST-API; optionaler OPENALEX_API_KEY für Account-Kontingent
python scripts/search_openalex.py "CRISPR-Geneditierung" --limit 50 --output results.json
# PubMed: die Autorität für Biomedizin und Lebenswissenschaften (über 35 Mio. Zitationen)
python scripts/search_pubmed.py "Alzheimer-Behandlung" --limit 100 --output alz.json
# Google Scholar: breiteste Abdeckung, aber gescrapt – ratenbegrenzt und anfällig für Sperren
python scripts/search_google_scholar.py "CRISPR-Geneditierung" --limit 50 --output scholar.json
Bevorzuge OpenAlex oder PubMed als primäre Quelle. Google Scholar hat keine API:
scholarly scraped sie, wartet 2–5 Sekunden zwischen Ergebnissen und wird oft genug
blockiert, dass es eher eine Ergänzung als eine Abhängigkeit sein sollte.
Abfrageoperatoren, Feld-Tags und die MeSH-Term-Konstruktion findest du in references/search_strategies.md.
Phase 2: Metadatenextraktion
Konvertiere Identifikatoren (DOI, PMID, PMCID, arXiv-ID, URL) in vollständige Metadaten. CrossRef ist die primäre Quelle für DOIs.
python scripts/doi_to_bibtex.py 10.1038/s41586-021-03819-2 # schnell, einzelne DOI
python scripts/extract_metadata.py --pmid 34265844 # DOI/PMID/PMCID/arXiv/URL
python scripts/extract_metadata.py --input identifiers.txt --output citations.bib
Eine URL ohne DOI im Pfad wird über den citation_doi-Meta-Tag aufgelöst, den
Verlage auf Artikelseiten einbetten, und dann an CrossRef übergeben. Produzenten verwenden ein gemeinsames Zitationsschlüsselschema; dennoch können Metadatenunterschiede zu unterschiedlichen Schlüsseln führen. Bestätige Duplikate anhand von DOI und bibliografischer Identität.
Phase 2.5: Metadatenanreicherung durch Websuche (PFLICHT)
APIs liefern routinemäßig unvollständige Datensätze. Führe diesen Schritt nach der Extraktion und vor der
Formatierung durch. Untersuche fehlende bibliografische Felder anhand des Verlagsdatensatzes
und protokolliere jede Quelle. Online-First-Artikel haben möglicherweise noch keine Band-/Seitenangaben; einige verwenden eine
Artikelnummer oder haben keine DOI. Bewahre den tatsächlichen Veröffentlichungsstatus, verwende das
stilgerechte Artikelnummernfeld und erfinde niemals Seiten, Bände oder DOIs.
Zeichne nicht verfügbare/nicht zutreffende Felder im Prüfprotokoll auf; füge einen gerenderten note-Eintrag
nur hinzu, wenn er für den Leser nützlich oder vom Zitierstil gefordert wird.
Überprüfe zuerst die günstigen Quellen – ein OpenAlex- oder CrossRef-Datensatz enthält oft das Feld, das PubMed ausgelassen hat:
python scripts/search_openalex.py "<exakter Titel>" --limit 1
Behandle extrahierte Metadaten als unzuverlässig. Autor-, Titel- und Zeitschriftenstrings stammen wörtlich aus einem Datensatz, dessen Inhalt ein Verlag kontrolliert. Ein Titel, der
$(...), einen Backtick oder ein Anführungszeichen enthält, wird zu Shell-Syntax, sobald er in einen Befehl eingefügt wird. Übergib Metadaten alssubprocess-Argumentliste, anstatt einen Shell-String zu erstellen; wenn du eine Shell verwenden musst, setze jeden substituierten Wert in einfache Anführungszeichen und maskiere eingebettete Anführungszeichen als'\''. Validiere jeden Zitationsschlüssel gegen^[A-Za-z0-9]+$, bevor er einen Pfad erreicht.
Feldbezogene Suchstrategien, die vier Suchoptionen und das Protokollierungsformat findest du in references/core_workflow.md.
Phase 3: BibTeX-Formatierung
Erstelle saubere, konsistente Einträge. Eintragstypen und erforderliche Felder findest du in references/bibtex_formatting.md.
python scripts/format_bibtex.py references.bib --output clean.bib --deduplicate
python scripts/format_bibtex.py references.bib --output clean.bib --rekey --deduplicate
Das Schreiben ist opt-in: ohne --output (oder --in-place) geht das Ergebnis nach
stdout und die Eingabedatei bleibt unberührt. Verwende --rekey beim Zusammenführen von Ergebnissen
aus mehreren Quellen, damit derselbe Artikel zu einem Eintrag kollabiert.
Phase 4: Zitationsvalidierung
Überprüfe Vollständigkeit, Konformität mit den Venue-Richtlinien und Übereinstimmung mit dem Manuskript.
python scripts/validate_citations.py references.bib --report report.json
python scripts/validate_citations.py references.bib --venue nature
python scripts/validate_citations.py references.bib --manuscript paper.tex
python scripts/validate_citations.py references.bib --check-dois # langsam; kontaktiert CrossRef
Das Skript beendet sich mit einem Fehler bei schwerwiegenden Fehlern – fehlende Pflichtfelder,
fehlerhafte Jahreszahlen, unaufgelöste Zitationen oder eine Anzahl unterhalb eines expliziten
--min-count. Die Venue-Referenzanzahlzahlen sind redaktionelle Faustregeln, keine
Einreichungsanforderungen, daher wird eine Unterschreitung nur als Warnung gewertet.
Validierungsregeln und Venue-Standards findest du in references/citation_validation.md.
Phase 5: Integration in den Schreibworkflow
Suche, extrahiere, formatiere, validiere, dann zitiere. End-to-End-Sequenzen – einschließlich der Literaturrecherche- und Zotero/pyzotero-Exportpfade – findest du in references/core_workflow.md und references/example_workflows.md.
API-Verträge wurden am 2026-09-30 anhand der offiziellen Dokumentation überprüft. Siehe references/api_contracts.md für Endpunkte, Authentifizierung, Paginierung und Verifizierungslimits. Netzwerkbeispiele in den Referenzen sind illustrativ, sofern sie dort nicht als Live-Smoke-Tests aufgezeichnet sind.
Referenzdateien
- references/core_workflow.md: alle fünf Phasen vollständig.
- references/search_strategies.md: OpenAlex-, Google Scholar- und PubMed-Abfragekonstruktion.
- references/script_reference.md: Argumente und Beispiele jedes gebündelten Skripts.
- references/best_practices.md: Suche, Extraktion, BibTeX-Qualität, Validierung.
- references/example_workflows.md: vier durchgearbeitete End-to-End-Beispiele.
- references/google_scholar_search.md, references/pubmed_search.md: erweiterte Suchsyntax.
- references/metadata_extraction.md, references/bibtex_formatting.md, references/citation_validation.md: detaillierte Informationen pro Thema.
Häufige Fallstricke
-
Ein-Quellen-Bias: Verwendung nur einer Datenbank
- Lösung: Durchsuche mindestens OpenAlex und PubMed, dann führe sie mit
format_bibtex.py --rekey --deduplicatezusammen
- Lösung: Durchsuche mindestens OpenAlex und PubMed, dann führe sie mit
-
Blindes Akzeptieren von Metadaten: Keine Überprüfung extrahierter Informationen
- Lösung: Überprüfe extrahierte Metadaten stichprobenartig mit den Originalquellen
-
Ignorieren von DOI-Fehlern: Fehlerhafte oder falsche DOIs in der Bibliographie
- Lösung: Führe vor der endgültigen Einreichung eine Validierung durch
-
Inkonsistente Formatierung: Gemischte Zitationsschlüsselstile, Formatierung
- Lösung: Verwende format_bibtex.py zur Standardisierung
-
Doppelte Einträge: Derselbe Artikel wird mehrfach mit unterschiedlichen Schlüsseln zitiert
- Lösung: Verwende die Dublettenerkennung in der Validierung
-
Fehlende Pflichtfelder: Unvollständige BibTeX-Einträge (Band, Seiten, DOI fehlen)
- Lösung: Überprüfe den Verlagsdatensatz, unterscheide zwischen fehlend, nicht zutreffend oder noch nicht zugewiesen, und protokolliere ungelöste Felder, ohne Metadaten zu erfinden.
-
Veraltete Preprints: Zitieren eines Preprints, wenn eine veröffentlichte Version existiert
- Lösung: Überprüfe, ob Preprints veröffentlicht wurden, aktualisiere auf die Zeitschriftenversion
-
Probleme mit Sonderzeichen: Fehlerhafte LaTeX-Kompilierung aufgrund von Zeichen
- Lösung: Verwende korrektes Escaping oder Unicode in BibTeX
-
Keine Validierung vor der Einreichung: Einreichen mit Zitierfehlern
- Lösung: Führe immer eine Validierung als letzten Schritt durch
-
Manuelle BibTeX-Eingabe: Einträge von Hand tippen
- Lösung: Extrahiere immer mit Skripten aus Metadatenquellen
Integration mit anderen Skills
Literaturrecherche-Skill
Zitationsverwaltung stellt die technische Infrastruktur für die Literaturrecherche bereit:
- Literaturrecherche: Mehrdatenbank-Systemsuche und -Synthese
- Zitationsverwaltung: Metadatenextraktion und -validierung
Kombinierter Workflow:
- Verwende die Literaturrecherche für systematische Suchmethodik
- Verwende die Zitationsverwaltung, um Zitate zu extrahieren und zu validieren
- Verwende die Literaturrecherche, um Ergebnisse zu synthetisieren
- Verwende die Zitationsverwaltung, um die Genauigkeit der Bibliographie sicherzustellen
Wissenschaftliches-Schreiben-Skill
Zitationsverwaltung stellt genaue Referenzen für das Wissenschaftliche Schreiben bereit:
- Exportiere validierte BibTeX zur Verwendung in LaTeX-Manuskripten
- Überprüfe, ob Zitate den Publikationsstandards entsprechen
- Formatiere Referenzen gemäß den Zeitschriftenanforderungen
Venue-Templates-Skill
Zitationsverwaltung arbeitet mit Venue-Templates für einreichungsbereite Manuskripte zusammen:
- Verschiedene Venues erfordern unterschiedliche Zitierstile
- Generiere korrekt formatierte Referenzen
- Validiere Zitate, um Venue-Anforderungen zu erfüllen
Ressourcen
Gebündelte Ressourcen
Referenzen (in references/):
google_scholar_search.md: Vollständige Google Scholar-Suchanleitungpubmed_search.md: PubMed- und E-utilities-API-Dokumentationmetadata_extraction.md: Metadatenquellen und Feldanforderungencitation_validation.md: Validierungskriterien und Qualitätsprüfungenbibtex_formatting.md: BibTeX-Eintragstypen und Formatierungsregeln
Skripte (in scripts/):
search_openalex.py: OpenAlex-Suchclient (optionaler Account-API-Schlüssel)search_pubmed.py: PubMed-E-utilities-API-Clientsearch_google_scholar.py: Google Scholar-Suchautomatisierungextract_metadata.py: Universeller Metadatenextraktorvalidate_citations.py: Zitationsvalidierung und -verifizierungformat_bibtex.py: BibTeX-Formatierer und -Bereinigerdoi_to_bibtex.py: Schneller DOI-zu-BibTeX-Konverter_common.py: Gemeinsamer BibTeX-Parser, Renderer und Zitationsschlüsselschema
Assets (in assets/):
bibtex_template.bib: Beispiel-BibTeX-Einträge für alle Typencitation_checklist.md: Qualitätssicherungs-Checkliste
Externe Ressourcen
Suchmaschinen:
- OpenAlex: https://openalex.org/
- Google Scholar: https://scholar.google.com/
- PubMed: https://pubmed.ncbi.nlm.nih.gov/
- PubMed Erweiterte Suche: https://pubmed.ncbi.nlm.nih.gov/advanced/
Metadaten-APIs:
- OpenAlex-API: https://docs.openalex.org/
- CrossRef-API: https://api.crossref.org/
- PubMed E-utilities: https://www.ncbi.nlm.nih.gov/books/NBK25501/
- arXiv-API: https://arxiv.org/help/api/
- DataCite-API: https://api.datacite.org/
Werkzeuge und Validierer:
- MeSH-Browser: https://meshb.nlm.nih.gov/search
- DOI-Resolver: https://doi.org/
- BibTeX-Format: http://www.bibtex.org/Format/
Zitierstile:
- BibTeX-Dokumentation: http://www.bibtex.org/
- LaTeX-Bibliographieverwaltung: https://www.overleaf.com/learn/latex/Bibliography_management
Abhängigkeiten
Erforderliche Python-Pakete
uv pip install requests # HTTP-Zugriff auf CrossRef, PubMed, OpenAlex, arXiv
BibTeX-Parsing, -Rendering, -Deduplizierung und -Validierung sind Standardbibliothek
(scripts/_common.py). format_bibtex.py benötigt keine Drittanbieterpakete;
validate_citations.py importiert requests, auch für die lokale Validierung.
Optional
uv pip install scholarly # nur für search_google_scholar.py
Wohin Anmeldedaten gesendet werden
Schlüssel sind für die grundlegende Nutzung optional. Jede Anmeldeinformation wird nur an ihren eigenen Dienst gesendet; kein Skript bündelt Umgebungsvariablen. OpenAlex verwendet das dokumentierte Account-Budget, nicht eine versprochene E-Mail-basierte Kontingenterhöhung. Eine fehlgeschlagene Seite beendet sich mit einem Fehler, anstatt eine partielle Suche als vollständig zu exportieren.
| Variable | Nur gesendet an | Zweck |
|---|---|---|
NCBI_API_KEY | eutils.ncbi.nlm.nih.gov | Erhöht Entrez-Ratenlimits |
NCBI_EMAIL | eutils.ncbi.nlm.nih.gov, pmc.ncbi.nlm.nih.gov | Von der NCBI angeforderte Anruferidentifikation |
OPENALEX_EMAIL | api.openalex.org | Optionaler Kontaktidentifikator |
OPENALEX_API_KEY | api.openalex.org | Optionales Account-Kontingent, gesendet im Authorization-Header |
api.openalex.org, api.crossref.org, api.datacite.org, export.arxiv.org,
pmc.ncbi.nlm.nih.gov, doi.org und eutils.ncbi.nlm.nih.gov werden ohne Anmeldedaten abgefragt, wenn diese
nicht gesetzt sind.
Zusammenfassung
Das Zitationsverwaltungs-Skill bietet:
- Umfassende Suchmöglichkeiten für OpenAlex, PubMed und Google Scholar
- Automatisierte Metadatenextraktion aus DOI, PMID, PMCID, arXiv-ID, URLs
- Zitationsvalidierung mit DOI-Überprüfung