How Google's ADK team ran an overnight agentic optimization drive on a 200k-line Python codebase — and, crucially, which four of Argon's six proposals were rejected in code review and why.
Dieser Artikel dokumentiert den automatisierten Publishing-Workflow, der verwendet wurde, um Updates des Comprehensive Modular Forms Preprint vollständig über API-Aufrufe auf Zenodo bereitzustellen – ohne Browser-Uploads, ohne manuelles Ausfüllen von Formularen.
Das Preprint des Riemann-Projekts durchlief an einem einzigen Tag drei Revisionen: die Erstveröffentlichung, eine Verbesserung der Tabellenformatierung und eine Korrektur der Autorenzeile. Jede Revision erforderte ein Update unter derselben DOI (über das neue Versionssystem von Zenodo). Die Durchführung über die Web-UI wäre fehleranfällig und langsam gewesen. Ein automatisierter Workflow bedeutete, dass jede Revision nur etwa 30 Sekunden Skriptausführungszeit kostete, statt 5 Minuten des Durchklickens durch Formulare.
Zenodo betreibt InvenioRDM v14, welches eine REST-API unter /api/records/{id}/draft bereitstellt. Der vorgesehene Workflow ist:
PUT /api/records/{id}/draft mit MetadatenPOST /api/records/{id}/draft/actions/publishDies schlägt auf eine subtile, aber nicht behebbare Weise fehl. Wenn der Browser einen Entwurf erstellt, reserviert InvenioRDM im Backend automatisch eine DOI. Aber PUT /api/records/{id}/draft ersetzt die gesamte Entwurfsressource – einschließlich der Metadaten – und löscht dabei die DOI-Referenz. Die PID bleibt im Backend registriert, sodass eine erneute Reservierung mit "A PID already exists" fehlschlägt, während die Veröffentlichung mit "Missing DOI for required field" scheitert. Der Entwurf ist korrumpiert und muss gelöscht werden.
Die Legacy Deposit API (/api/deposit/depositions) vermeidet dies vollständig: Sie gibt bei der Erstellung eine prereserve_doi zurück, die über nachfolgende PUT-Aufrufe hinweg stabil bleibt.
Zenodo bietet eine Bearer-Token-Authentifizierung an, aber für eine schnelle Iteration habe ich Session-Cookies verwendet, die über einen Browser-Debugger gewonnen wurden. Die Cookies werden als Datei im Netscape-Format übergeben:
# Netscape HTTP Cookie File
zenodo.org FALSE / TRUE 1780692402 session <session_token>
zenodo.org FALSE / TRUE 1780472171 csrftoken <csrf_token>
Zusammen mit den Cookies sind zwei kritische Header erforderlich:
X-CSRFToken: der Wert des csrftoken (CSRF-Schutz)Referer: https://zenodo.org/ (Origin-Validierung)Das Skript folgt fünf Schritten:
[POST] Create new version → /api/deposit/depositions/{id}/actions/newversion
[DELETE] Remove old PDF → /api/deposit/depositions/{new_id}/files/{file_id}
[POST] Upload new PDF → /api/deposit/depositions/{new_id}/files
[PUT] Update metadata → /api/deposit/depositions/{new_id} (with JSON body)
[POST] Publish → /api/deposit/depositions/{new_id}/actions/publish
r = session.post(f"{BASE}/deposit/depositions/{DEPOSIT_ID}/actions/newversion")
new_deposit = r.json()
new_id = new_deposit["id"]
Die Antwort liefert eine neue Entwurfs-ID zurück. Der alte, veröffentlichte Datensatz bleibt zugänglich – die neue Version wird über die gemeinsame conceptdoi darauf verlinken.
files = session.get(f"{BASE}/deposit/depositions/{new_id}/files").json()
for f in files:
requests.delete(f"{BASE}/deposit/depositions/{new_id}/files/{f['id']}",
cookies=cookies,
headers={"X-CSRFToken": csrf, "Referer": "https://zenodo.org/"})
Die neue Version von Zenodo kopiert alle Dateien aus der vorherigen Version. Wir müssen diese löschen, bevor wir Ersatzdateien hochladen (es gibt keinen Endpunkt zum Ersetzen von Dateien – nur zum Hinzufügen und Löschen).
with open("paper.pdf", "rb") as fh:
r = requests.post(f"{BASE}/deposit/depositions/{new_id}/files",
cookies=cookies,
headers={"X-CSRFToken": csrf, "Referer": "https://zenodo.org/"},
files={"file": ("paper.pdf", fh)})
Beachten Sie die Verwendung von requests.post (nicht das Session-Objekt) für Datei-Uploads. Der Content-Type-Header (application/json) des session-Objekts kollidiert mit Multipart-Form-Daten.
r = session.get(f"{BASE}/deposit/depositions/{new_id}")
current = r.json()
meta = current.get("metadata", {})
meta["title"] = "Your Title"
meta["creators"] = [{"name": "Weiss, Tobias", "affiliation": "Independent"}]
meta["upload_type"] = "publication"
meta["publication_type"] = "preprint"
meta["access_right"] = "open"
meta["license"] = "CC-BY-4.0"
session.put(f"{BASE}/deposit/depositions/{new_id}", json={"metadata": meta})
Der PUT-Aufruf bewahrt die vorreservierte DOI – aus diesem Grund verwenden wir die Legacy-API und nicht die v14-Draft-API.
r = session.post(f"{BASE}/deposit/depositions/{new_id}/actions/publish")
# Returns 202 Accepted with state="done" on success
Die Antwort enthält die finale DOI und die öffentliche URL.
import requests
BASE = "https://zenodo.org/api"
DEPOSIT_ID = "20479512" # initial deposit ID
COOKIES = {
"session": "<your_session>",
"csrftoken": "<your_csrftoken>"
}
CSRF = COOKIES["csrftoken"]
HEADERS = {"X-CSRFToken": CSRF, "Referer": "https://zenodo.org/"}
# 1. Neue Version
r = requests.post(f"{BASE}/deposit/depositions/{DEPOSIT_ID}/actions/newversion",
cookies=COOKIES, headers=HEADERS)
new_id = r.json()["id"]
# 2. Alte Dateien löschen
for f in requests.get(f"{BASE}/deposit/depositions/{new_id}/files",
cookies=COOKIES, headers=HEADERS).json():
requests.delete(f"{BASE}/deposit/depositions/{new_id}/files/{f['id']}",
cookies=COOKIES, headers=HEADERS)
# 3. Neue Datei hochladen
with open("paper.pdf", "rb") as fh:
requests.post(f"{BASE}/deposit/depositions/{new_id}/files",
cookies=COOKIES, headers=HEADERS,
files={"file": ("paper.pdf", fh)})
# 4. Metadaten aktualisieren
meta = requests.get(f"{BASE}/deposit/depositions/{new_id}",
cookies=COOKIES, headers=HEADERS).json()["metadata"]
meta.update({
"title": "Your Title",
"creators": [{"name": "Weiss, Tobias", "affiliation": "Independent"}],
"upload_type": "publication",
"publication_type": "preprint",
"license": "CC-BY-4.0",
})
requests.put(f"{BASE}/deposit/depositions/{new_id}",
cookies=COOKIES, headers=HEADERS, json={"metadata": meta})
# 5. Veröffentlichen
r = requests.post(f"{BASE}/deposit/depositions/{new_id}/actions/publish",
cookies=COOKIES, headers=HEADERS)
print(f"Published: {r.json()['doi_url']}")
| Revision | DOI | Dateigröße | Was wurde geändert |
|---|---|---|---|
| v1 | 10.5281/zenodo.20479512 | 195 KB | Erstveröffentlichung |
| v2 | 10.5281/zenodo.20479919 | 221 KB | Korrektur der Autorenzeile, booktabs Tabellenformat |
| v3 | 10.5281/zenodo.20480198 | 221 KB | Finales Cleanup der Autorenzeile |
Alle drei Revisionen teilen sich die Concept-DOI: 10.5281/zenodo.20479511. Die neueste Version wird immer über die Concept-DOI-URL bereitgestellt, während die einzelnen DOIs dauerhaft zugänglich bleiben.
Die Legacy-API verwenden. Die /api/deposit/depositions Endpunkte sind stabil und der Prereserve-DOI-Mechanismus funktioniert. Die v14 /api/records/{id}/draft API weist einen nicht behebaren DOI-Deadlock auf.
Session-Cookies laufen ab. Zenodo-Session-Token haben eine begrenzte Lebensdauer. Verwenden Sie für produktive CI/CD-Pipelines stattdessen einen Personal Access Token.
Neue Versionen kopieren alle Dateien. Löschen Sie immer alte Dateien, bevor Sie neue hochladen. Es gibt keinen Endpunkt zum Ersetzen von Dateien.
requests.post für Datei-Uploads verwenden, nicht das Session-Objekt. Der Content-Type: application/json Header im Session-Objekt kollidiert mit Multipart-Form-Daten.
Beschädigte Entwürfe über die Legacy-API löschen. Wenn ein Entwurf in den DOI-Deadlock-Zustand gerät, verwenden Sie DELETE /api/deposit/depositions/{id} mit derselben Cookie-Authentifizierung, um ihn zu bereinigen.
Der naheliegendste nächste Schritt ist die Einbettung des Publish-Skripts in einen GitHub Actions (oder Forgejo Actions) Workflow. Bei jedem Push eines Release-Tags (v*) würde der Workflow:
Dies eliminiert den verbleibenden manuellen Schritt des Ausführens eines Skripts mit Session-Cookies. Ein in einem Repository-Secret gespeicherter Zenodo Personal Access Token ersetzt die Cookie-Authentifizierung vollständig.
Der aktuelle Workflow erfordert das manuelle Kopieren von Session- und CSRF-Token-Cookies aus den Browser-Entwicklertools bei jedem Durchlauf. Eine BrowserMCP Integration könnte diesen Schritt vollständig automatisieren:
zenodo.org (unter Verwendung der bestehenden Login-Session)page.evaluate(() => document.cookie) oder der CDP Network.getCookies MethodeDies eliminiert den fehleranfälligsten manuellen Schritt. Der auf der Host-Maschine laufende MCP-Server kann auch den Datei-Upload übernehmen – BrowserMCP hat Zugriff auf lokale Dateien und kann das PDF lesen und direkt per POST an die Zenodo-API senden, ohne dass ein separates Python-Skript erforderlich ist.
Für Headless-CI-Umgebungen kann BrowserMCP die Authentifizierung über die Zenodo-Login-Seite (E-Mail + Passwort) durchführen und die resultierenden Session-Cookies programmatisch extrahieren, wodurch der gesamte Ablauf vollautomatisch erfolgt.
Session-Cookies waren praktisch, aber fragil (sie laufen ab und das CSRF-Token muss aktualisiert werden). Die Zenodo-API unterstützt die Bearer-Token-Authentifizierung via Authorization: Bearer <token>. Eine Produktions-Pipeline sollte:
requests.Session(headers={"Authorization": f"Bearer {token}"}) verwenden – keine Cookies, keine CSRF-HeaderDie Token-Berechtigungen (Scopes) können auf den Schreibzugriff für Deposits beschränkt werden, was die Angriffsfläche im Vergleich zu einem vollständigen Session-Cookie reduziert.
Zenodo unterstützt Community-Collections, die verwandte Datensätze gruppieren. Eine zukünftige Version des Workflows könnte:
Derzeit wird nur das PDF hochgeladen. Viele computergestützte Arbeiten rechtfertigen ergänzendes Material:
Der Publish-Endpunkt gibt 202 Accepted zurück, was bedeutet, dass die Veröffentlichung asynchron erfolgt. Eine zukünftige Erweiterung könnte den Status des Datensatzes abfragen und eine Benachrichtigung (E-Mail, Slack-Webhook oder Matrix-Nachricht) senden, sobald die DOI aufgelöst wird. Dies ist besonders nützlich für Batch-Updates über mehrere Deposits hinweg.
Zenodo-DOIs werden von Preprint-Servern wie arXiv, HAL und OSF zunehmend akzeptiert. Eine natürliche Erweiterung ist ein Cross-Posting-Workflow, der: