API REST, UCP, Server MCP, feed XML/JSON, Calendario e Analisi — tutto ciò di cui gli agenti IA e i sistemi ERP hanno bisogno per connettersi al mercato europeo Scopio.
Tutti gli endpoint richiedono un token Bearer. Genera la tua chiave in Impostazioni account → Integrazioni → Chiavi API. Formato: sk_mkt_...
Authorization: Bearer sk_mkt_YOUR_KEYapplication/jsonhttps://business.scopio.plTest rapido — 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}]'Risposta
{"updated":1,"pending_review":0,"errors":0}Tutti i metodi accettano EAN + prezzo + quantità. Scegli quello che meglio si adatta al tuo stack tecnologico.
Sincronizzazione JSON in tempo reale. Array di prodotti, fino a 10.000 per richiesta. Gli EAN nel nostro catalogo sono subito online.
Carica il catalogo XML. Formato generico e Google Shopping RSS supportati. Ideale per i sistemi ERP.
Indicaci l'URL del tuo feed JSON. Lo recupereremo e lo analizzeremo automaticamente a intervalli regolari.
Carica un file Excel. Colonne richieste: EAN, Prezzo, Quantità. Nessuna competenza di programmazione richiesta.
Salva le credenziali FTP una volta. Recuperiamo il tuo file di prodotto (JSON, XML o CSV) su richiesta.
Standard JSON-RPC 2.0 per agenti IA. Claude, ChatGPT e Gemini possono chiamare direttamente gli strumenti di database.
EAN abbinati → immediatamente online sul mercato
EAN sconosciuti → messi in coda per la verifica automatica
Errori di validazione con dettagli per ciascun prodotto
Endpoint JSON-RPC 2.0. Claude, ChatGPT, Gemini e qualsiasi altro agente chiamano direttamente gli strumenti Scopio — nessuna esportazione manuale richiesta.
sync_productsTrasmette l'array di prodotti al mercato. Restituisce il numero di prodotti aggiornati, in revisione e con errori.
params: {"products": [{"ean": "string", "price": number, "qty": number}]}check_eanVerifica l'EAN nel catalogo Scopio. Restituisce lo stato: live | pending | unknown.
params: {"ean": "string"}get_offersRecupera le offerte attualmente attive sul mercato per il venditore autenticato.
params: {}Endpoint
POST /api/seller/products/mcpEsempio di richiesta
{
"jsonrpc": "2.0",
"method": "sync_products",
"params": {
"products": [
{"ean":"8721199108286","price":29.99,"qty":10}
]
},
"id": 1
}Risposta
{
"jsonrpc": "2.0",
"result": {"updated":1,"pending_review":0,"errors":0},
"id": 1
}Un endpoint separato e più ampio per agenti IA — commercio, immobili, viaggi, social media e altro, tutto in un'unica connessione.
Endpoint
POST https://api.scopio.pl/mcpCerca prodotti, sfoglia categorie, carrello, checkout.
Cerca annunci immobiliari per posizione, prezzo e servizi.
Voli, calendario prezzi e hotel con link di prenotazione pronti.
Verifica disponibilità e scorte dei farmaci nelle diverse sedi.
Genera hashtag e didascalie, pubblica e pianifica post.
Genera foto, video e prova virtuale dei prodotti.
Trova e arricchisci contatti business, mettili in coda per il contatto.
Un widget di chat IA brandizzabile che si adatta a qualsiasi attività.
Connetti e sincronizza un catalogo di negozio online esistente.
Sfoglia e abbonati ai piani di servizio direttamente dalla conversazione.
A differenza dell'endpoint di sincronizzazione prodotti sopra — costruito appositamente per caricare il proprio catalogo su Scopio — questo server generico dà a qualsiasi agente IA accesso all'intera piattaforma: sfogliare cataloghi, pianificare viaggi, verificare le scorte in farmacia, gestire un'intera pipeline di pubblicazione sui social media, generare contenuti IA e altro. Alcuni strumenti sono gratuiti e aperti senza alcuna autenticazione; gli altri si attivano con un abbonamento Scopio, e l'agente guida l'utente nella scelta di un piano e nell'ottenimento di una chiave senza uscire dalla conversazione.
Alcuni strumenti sono gratuiti e aperti a qualsiasi agente — senza account. Gli strumenti più avanzati richiedono un abbonamento attivo.
Consente agli agenti IA di verificare la disponibilità e prenotare riunioni in modo autonomo per conto dei clienti.
Ottieni slot disponibili
GET /api/calendar/slots?date=2025-06-15&duration=30Restituisce: [{slot_id, start, end, available}]
Prenota uno slot
POST /api/calendar/book{
"slot_id": "...",
"client_name": "Jan Kowalski",
"client_email": "jan@firma.pl",
"service_name": "Demo call",
"duration": 30
}Scopri quante volte Claude, ChatGPT, Gemini e altri agenti hanno interagito con i tuoi prodotti.
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}
]
}Configura un URL di webhook nel tuo pannello. Invieremo notifiche POST sugli eventi (ad esempio, order.placed) in tempo reale.
Registra webhook
POST /api/seller/webhooks{
"url": "https://yourshop.pl/scopio-hook",
"events": ["order.placed","product.updated"]
}Dati utili — order.placed
{
"event": "order.placed",
"order_id": "ORD-2026-...",
"ean": "8721199108286",
"qty": 2,
"buyer_country": "DE",
"created_at": "2026-05-26T12:00:00Z"
}Gestisci le impostazioni di integrazione, sincronizza i prodotti in conformità con la normativa GPSR dell'UE e recupera gli ordini di TikTok Shop.
/api/seller/tiktok/configRestituisce lo stato della connessione, il nome del negozio, la regione e le mappature GPSR e magazzino predefinite.
/api/seller/tiktok/configSalva o aggiorna le impostazioni di connessione di TikTok Shop, i modelli di spedizione e gli ID GPSR.
{
"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/warehousesRecupera l'elenco dei magazzini attivi dal tuo profilo logistico TikTok Shop, necessario per gli aggiornamenti delle scorte.
/api/seller/tiktok/syncAvvia la sincronizzazione immediata delle offerte su TikTok Shop. Controlla lo stato dell'EAN, carica le immagini, imposta i dettagli di sicurezza GPSR dell'UE o aggiorna prezzi/stock.
Elenco degli EAN da sincronizzare (opzionale, un array vuoto sincronizza tutti i prodotti).
{
"eans": ["5901234123457", "5901234123464"]
}Risposta
{
"success": true,
"synced_count": 2,
"created": 1,
"updated": 1,
"message": "TikTok EU Sync: 1 created, 1 updated."
}/api/seller/tiktok/ordersRecupera gli ordini memorizzati nella cache di TikTok Shop. Utilizza il parametro ?refresh=1 per forzare l'aggiornamento in tempo reale dall'API di TikTok.
Quale metodo di autenticazione utilizza l'API Scopio?
Chiave API Bearer. Genera la tua chiave sk_mkt_... nel tuo account B2B. Aggiungi l'intestazione: Authorization: Bearer sk_mkt_...
Quali campi del prodotto sono richiesti per la sincronizzazione?
Minimo: ean (stringa), price (numero), qty (intero). Esempio: [{"ean":"5901234123457","price":29.99,"qty":10}]
L'API Scopio supporta l'UCP (Universal Commerce Protocol)?
Sì. Scopio è la prima piattaforma in Europa a implementare lo standard UCP, consentendo agli agenti IA di recuperare offerte in modo dinamico ed eseguire acquisti.
Come funziona l'integrazione di TikTok Shop?
È completamente automatica. Colleghi il tuo negozio tramite OAuth, imposti i valori predefiniti (spedizione, categoria, magazzino, profils GPSR) e chiami POST /api/seller/tiktok/sync con i codici EAN. Scopio fa il resto.
Gli agenti IA possono prenotare riunioni nel calendario?
Sì. La richiesta GET /api/calendar/slots restituisce gli slot liberi, mentre POST /api/calendar/book conferma la prenotazione.
Come monitorare le richieste dei robot IA?
La richiesta GET /api/seller/analytics restituisce le statistiche a 30 giorni suddivise per modello LLM (Claude, ChatGPT, Gemini, ecc.), visibili anche sul tuo dashboard.
Qual è la differenza tra l'MCP di sincronizzazione prodotti e il server MCP generico?
L'endpoint di sincronizzazione prodotti (POST /api/seller/products/mcp) è progettato in modo specifico per caricare il proprio catalogo su Scopio. Il server MCP generico (POST https://api.scopio.pl/mcp) è un endpoint molto più ampio che copre l'intera piattaforma — ricerca marketplace, immobili, viaggi, farmacia, pubblicazione social, generazione di contenuti IA, generazione lead e altro — utilizzabile da qualsiasi agente IA, non solo dai venditori che sincronizzano l'inventario.
Ho bisogno di una chiave API per usare il server MCP generico?
Non per ogni strumento. Alcuni strumenti, come la generazione di hashtag e didascalie, sono gratuiti e aperti a qualsiasi agente senza autenticazione. Gli strumenti più avanzati richiedono un abbonamento Scopio attivo — chiama prima lo strumento catalogo per vedere i piani disponibili, poi abbonati direttamente dalla conversazione.
Pronto per l'integrazione?
Genera la tua chiave API, scegli il tuo metodo di integrazione e invia il primo prodotto. Risposta istantanea.