REST API, UCP, MCP-Server, XML/JSON-Feed, Kalender und Analysen — alles, was KI-Agenten und ERP-Systeme für die Integration mit dem Scopio European Marktplatz benötigen.
Alle Endpunkte erfordern ein Bearer-Token. Generieren Sie Ihren Schlüssel in Kontoeinstellungen → Integrationen → API-Schlüssel. Format: sk_mkt_...
Authorization: Bearer sk_mkt_YOUR_KEYapplication/jsonhttps://business.scopio.plSchnelltest — curl
curl -X POST \
https://business.scopio.pl/api/seller/products \
-H "Authorization: Bearer sk_mkt_..." \
-H "Content-Type: application/json" \
-d '[{"ean":"8721199108286","price":29.99,"qty":10}]'Antwort
{"updated":1,"pending_review":0,"errors":0}Alle Methoden akzeptieren EAN + Preis + Menge. Wählen Sie die Methode, die zu Ihrem Tech-Stack passt.
Echtzeit-JSON-Sync. Array von Produkten, bis zu 10.000 pro Anfrage. EANs im Katalog gehen sofort live.
XML-Katalog hochladen. Generisches Format und Google Shopping RSS werden unterstützt. Ideal für ERP-Systeme.
Geben Sie uns Ihre JSON-Feed-URL an. Wir rufen sie automatisch in regelmäßigen Abständen ab.
Excel-Datei hochladen. Erforderliche Spalten: EAN, Preis, Menge. Keine Programmierkenntnisse erforderlich.
FTP-Zugangsdaten einmalig speichern. Wir rufen Ihre Produktdatei (JSON, XML oder CSV) bei Bedarf ab.
JSON-RPC 2.0 Standard für KI-Agenten. Claude, ChatGPT und Gemini können Datenbank-Tools direkt aufrufen.
EANs abgeglichen → sofort live auf dem Marktplatz
Unbekannte EANs → zur automatischen Verifizierung in die Warteschlange gestellt
Validierungsfehler mit Details pro Produkt
JSON-RPC 2.0 Endpunkt. Claude, ChatGPT, Gemini und jeder benutzerdefinierte Agent rufen Scopio-Tools direkt auf — kein manueller Datenexport erforderlich.
sync_productsÜbermittelt Produkt-Array an den Marktplatz. Gibt Anzahl aktualisierter, in Prüfung befindlicher und fehlerhafter Produkte zurück.
params: {"products": [{"ean": "string", "price": number, "qty": number}]}check_eanPrüft EAN im Scopio-Katalog. Gibt Status zurück: live | pending | unknown.
params: {"ean": "string"}get_offersRuft die aktuell aktiven Marktplatz-Angebote des Händlers ab.
params: {}Endpunkt
POST /api/seller/products/mcpBeispielanfrage
{
"jsonrpc": "2.0",
"method": "sync_products",
"params": {
"products": [
{"ean":"8721199108286","price":29.99,"qty":10}
]
},
"id": 1
}Antwort
{
"jsonrpc": "2.0",
"result": {"updated":1,"pending_review":0,"errors":0},
"id": 1
}Ein separater, breiterer Endpunkt für KI-Agenten — Handel, Immobilien, Reisen, Social Media und mehr, alles über eine Verbindung.
Endpunkt
POST https://api.scopio.pl/mcpProdukte suchen, Kategorien durchsuchen, Warenkorb, Kasse.
Immobiliensuche nach Lage, Preis und Ausstattung.
Flüge, Preiskalender und Hotels mit fertigen Buchungslinks.
Verfügbarkeit und Bestand von Medikamenten an verschiedenen Standorten prüfen.
Hashtags und Captions generieren, Beiträge veröffentlichen und planen.
Produktfotos, Videos und virtuelle Anprobe generieren.
Geschäftskontakte finden, anreichern und für Outreach einreihen.
Ein markenfähiges KI-Chat-Widget, das sich an jedes Geschäft anpasst.
Einen bestehenden Online-Shop-Katalog verbinden und synchronisieren.
Serviceebenen direkt aus dem Gespräch durchsuchen und abonnieren.
Im Gegensatz zum oben beschriebenen Produkt-Sync-Endpunkt — der speziell für das Hochladen des eigenen Katalogs in Scopio gebaut wurde — gibt dieser allgemeine Server jedem KI-Agenten Zugriff auf die gesamte Plattform: Kataloge durchsuchen, Reisen planen, Apothekenbestände prüfen, einen vollständigen Social-Media-Publishing-Workflow durchführen, KI-Inhalte generieren und mehr. Einige Tools sind kostenlos und ohne jede Authentifizierung offen; der Rest wird mit einem Scopio-Abonnement aktiviert, und der Agent führt den Nutzer direkt im Gespräch durch die Auswahl eines Plans und den Erhalt eines Schlüssels.
Einige Tools sind kostenlos und für jeden Agenten offen — kein Konto erforderlich. Tiefergehende Tools erfordern ein aktives Abonnement.
Ermöglicht es KI-Agenten, freie Termine autonom im Namen der Kunden zu prüfen und zu buchen.
Freie Termine abrufen
GET /api/calendar/slots?date=2025-06-15&duration=30Rückgabe: [{slot_id, start, end, available}]
Termin buchen
POST /api/calendar/book{
"slot_id": "...",
"client_name": "Jan Kowalski",
"client_email": "jan@firma.pl",
"service_name": "Demo call",
"duration": 30
}Sehen Sie, wie oft Claude, ChatGPT, Gemini und andere Agenten mit Ihren Produkten interagiert haben.
GET /api/seller/analytics{
"total_30d": 142,
"by_type": {
"mcp_query": 98,
"product_query": 31,
"calendar_booking": 13
},
"by_agent": {
"claude": 67,
"chatgpt": 44,
"gemini": 31
},
"trend_7d": [
{"date":"2026-05-20","count":12}, ...
],
"top_products": [
{"ean":"8721199108286","count":23}
]
}Konfigurieren Sie eine Webhook-URL in Ihrem Panel. Wir senden POST-Benachrichtigungen über Ereignisse (z. B. order.placed) in Echtzeit.
Webhook registrieren
POST /api/seller/webhooks{
"url": "https://yourshop.pl/scopio-hook",
"events": ["order.placed","product.updated"]
}Nutzdaten — order.placed
{
"event": "order.placed",
"order_id": "ORD-2026-...",
"ean": "8721199108286",
"qty": 2,
"buyer_country": "DE",
"created_at": "2026-05-26T12:00:00Z"
}Verwalten Sie Integrationseinstellungen, synchronisieren Sie Produkte konform mit EU-GPSR und rufen Sie TikTok Shop-Bestellungen ab.
/api/seller/tiktok/configGibt den Verbindungsstatus, den Shopnamen, die Region sowie die Standard-GPSR- und Lager-Mappings zurück.
/api/seller/tiktok/configSpeichert oder aktualisiert die Verbindungseinstellungen für den TikTok Shop, Versandvorlagen und GPSR-IDs.
{
"region": "PL",
"default_category_id": "602123",
"default_warehouse_id": "123456789",
"default_gpsr_manufacturer_id": "mfg_uuid",
"default_gpsr_responsible_person_id": "rp_uuid",
"auto_upload_products": true,
"sync_inventory_realtime": true
}/api/seller/tiktok/warehousesRuft die Liste der aktiven Lagerhäuser aus Ihrem TikTok Shop-Logistikprofil ab, die für Bestandsupdates benötigt werden.
/api/seller/tiktok/syncLöst die sofortige Synchronisierung von Angeboten im TikTok Shop aus. Überprüft den EAN-Status, lädt Bilder hoch, richtet EU-GPSR-Sicherheitsdetails ein oder aktualisiert Preise/Bestände.
Liste der zu synchronisierenden EANs (optional, leeres Array synchronisiert alles).
{
"eans": ["5901234123457", "5901234123464"]
}Antwort
{
"success": true,
"synced_count": 2,
"created": 1,
"updated": 1,
"message": "TikTok EU Sync: 1 created, 1 updated."
}/api/seller/tiktok/ordersRuft im Cache gespeicherte TikTok Shop-Bestellungen ab. Verwenden Sie den Abfrageparameter ?refresh=1, um Live-Bestellungen direkt von der TikTok-API abzurufen.
Welche Authentifizierungsmethode verwendet die Scopio-API?
Bearer API-Schlüssel. Generieren Sie den Schlüssel sk_mkt_... im B2B-Konto. Fügen Sie den Header hinzu: Authorization: Bearer sk_mkt_...
Welche Produktfelder sind für die Synchronisierung erforderlich?
Minimum: ean (String), price (Nummer), qty (Ganzzahl). Beispiel: [{"ean":"5901234123457","price":29.99,"qty":10}]
Unterstützt Scopio das UCP (Universal Commerce Protocol)?
Ja. Scopio ist die erste Plattform in Europa, die den UCP-Standard implementiert, sodass KI-Agenten Angebote dynamisch abrufen und Käufe abwickeln können.
Wie funktioniert die TikTok Shop-Integration?
Es ist vollautomatisch. Sie verbinden Ihren TikTok Shop per OAuth, legen Standardeinstellungen fest (Versand, Kategorie, Lager, GPSR-Profile) und rufen POST /api/seller/tiktok/sync mit EAN-Codes auf. Scopio erledigt den Rest.
Können KI-Agenten Termine im Kalender buchen?
Ja. Der Endpoint GET /api/calendar/slots gibt freie Termine zurück, und POST /api/calendar/book erstellt die Buchung.
Wie verfolge ich Interaktionen von KI-Modellen?
Die Abfrage GET /api/seller/analytics liefert 30-Tage-Statistiken aufgeteilt nach LLM-Modellen (Claude, ChatGPT, Gemini usw.), die auch in Ihrem Dashboard angezeigt werden.
Was ist der Unterschied zwischen dem Produkt-Sync-MCP und dem allgemeinen MCP-Server?
Der Produkt-Sync-Endpunkt (POST /api/seller/products/mcp) ist eng darauf ausgelegt, den eigenen Katalog in Scopio hochzuladen. Der allgemeine MCP-Server (POST https://api.scopio.pl/mcp) ist ein viel breiterer Endpunkt, der die gesamte Plattform abdeckt — Marktplatzsuche, Immobilien, Reisen, Apotheke, Social-Media-Publishing, KI-Inhaltserstellung, Lead-Generierung und mehr — nutzbar von jedem KI-Agenten, nicht nur von Verkäufern, die ihr Inventar synchronisieren.
Brauche ich einen API-Schlüssel, um den allgemeinen MCP-Server zu nutzen?
Nicht für jedes Tool. Ein Teil der Tools, wie die Hashtag- und Caption-Generierung, ist kostenlos und für jeden Agenten ohne Authentifizierung offen. Tiefergehende Tools erfordern ein aktives Scopio-Abonnement — rufen Sie zuerst das Katalog-Tool auf, um verfügbare Pläne zu sehen, und abonnieren Sie dann direkt im Gespräch.
Bereit zur Integration?
Generieren Sie Ihren API-Schlüssel, wählen Sie Ihre Methode und senden Sie das erste Produkt. Erhalten Sie eine sofortige Antwort.