Sheets über API und MCP
Erstelle Recherchelisten, ergänze vorhandene Zeilen und bearbeite gespeicherte Sheets mit gemeinsamen Operationsverträgen.
Leadbase-Sheets sind über die HTTP-API und öffentliche MCP-Tools verfügbar, entsprechend Workspace- und Sheet-Berechtigungen. Lies die aktuellen Schemas über OpenAPI oder die Tool-Liste deines MCP-Clients.
Führe HTTP-Operationen mit POST /api/v1/operations/{id} aus. Prüfe mit GET /api/v1/operations/{id} zunächst die vollständigen Eingabe- und Ausgabeschemas. Unterstriche nach sheets. bleiben erhalten; beispielsweise wird sheets.get_enrichment_status in MCP zu sheets_get_enrichment_status.
Eine neue Rechercheliste erstellen
Sende dieses JSON an sheets_research in MCP oder an POST /api/v1/operations/sheets.research. Es fordert echte, möglicherweise kostenpflichtige Recherche an; passe Umfang und stabilen Schlüssel vor der Nutzung an.
Die Zielanzahl count akzeptiert 1–10.000; sie ist eine gewünschte Trefferzahl, kein Credit-Budget und keine Zusage vollständiger Abdeckung. Definiere bis zu 19 typisierte Felder und wähle ein Text- oder URL-Feld als identityField, um doppelte Zeilen zu vermeiden. Definiere sourceUrl nicht selbst: Es ist reserviert und wird automatisch ergänzt.
Die Antwort enthält unmittelbar nach der Annahme sheetId, batchId und Aufträge. Zeige das echte bearbeitbare Sheet mit view_sheet in einem Client mit MCP-Apps-Unterstützung. Nutze sheets_research_status für aktuelle Zielanzahl und Fortschritt sowie enrichment_get mit batchId für Ergebnisse und Credit-Abrechnung. Nur bestätigte Treffer zählen; eine kleinere Liste ist ein Teilergebnis. Lies gespeicherte Zeilen mit sheets_query.
Vorhandene Sheet-Zeilen anreichern
sheets_enrich akzeptiert sheetId, einen stabilen idempotencyKey und ein verschachteltes column. Nutze column: {"columnId":"COLUMN_UUID"} für konfigurierte Recherche oder column: {"name":"Geschäftliche E-Mail","question":"Finde die geschäftliche E-Mail-Adresse dieser Person.","type":"email"} für eine neue Spalte. Übergib die gewählten rowIds oder lasse sie nur dann weg, wenn dein Auftrag alle vorhandenen Zeilen umfasst, bis zu 10.000. Siehe das vollständige Kontaktbeispiel.
Gefüllte Zellen und aktive Arbeit werden übersprungen. Eine neue Spalte wird vor dem Recherchebeginn gespeichert. Prüfe für ausdrücklich gewünschtes Ersetzen oder Ziele in mehreren Spalten stattdessen sheets_start_enrichment. Lies Zellergebnisse mit sheets_get_enrichment_status und sheets_query; diese verwenden Sheet-Lauf- und Zeilenidentitäten statt des eigenständigen Batch-Vertrags mit 100 Elementen.
Bearbeiten, teilen und wiederaufnehmen
Der Tool-Katalog enthält auch Zeilen- und Spaltenbearbeitung, Ordner, Ansichten, Freigaben und Versionsverlauf. Beachte die je Operation erforderlichen Berechtigungen, Versionen und Wiederholungsschlüssel. Versionswerte sind dezimale Strings, keine numerischen Zeitstempel. Errate keine aktuelle Version und überschreibe keine widersprechende Änderung stillschweigend.
Behalte ursprüngliche Argumente und stabile Wiederholungsschlüssel. Rufe unterbrochene Änderungen mit identischen Argumenten und demselben Schlüssel wieder auf; prüfe den aktuellen Stand, bevor du Arbeit bewusst veränderst. Kontozugriff und Sheet-Rollen gelten auch bei gelisteten Tools. Siehe Sheet-Bearbeitung, Freigaben und Verlauf.