DocumentazioneAPI e MCP

Primi passi

Crea una chiave, fai la tua prima chiamata e leggi le risposte.

Tutto quello che fai in semchat, dal tuo codice (l'API) o dal tuo assistente IA (MCP): i tuoi siti, la loro analisi, i piani d'azione, le parole chiave, i concorrenti, i backlink, i documenti, le attività pianificate e la chat di semchat. Le stesse azioni dell'app, agli stessi prezzi.

Ottenere una chiave

  1. 1Apri Impostazioni → API e MCPNel tuo spazio di lavoro, in semchat. Solo il proprietario e gli amministratori creano e revocano le chiavi.
  2. 2Crea una chiaveDalle un nome, poi copiala: viene mostrata una sola volta.
  3. 3Revocala se finisce in mani sbagliateRevoca, nella stessa scheda: la chiave smette subito di funzionare.
Una chiave agisce su tutto lo spazio di lavoro. Tienila su un server, mai in un sito o in un'app pubblici.
Impostazioni › API e MCP: le chiavi, il server MCP e la configurazione per ogni assistente

Autenticazione

Ogni richiesta porta la chiave nell'header Authorization: Bearer (oppure X-API-Key). L'URL di base è https://app.semchat.io/api/v1. I corpi delle richieste e le risposte sono in JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Senza una chiave valida, la risposta è un 401: vedi Errori e limiti.

Un primo sito

Crea un sito e avvia la sua analisi con la stessa chiamata. L'analisi è a pagamento; needs_credits ti dice quando i crediti non sono bastati a pagarla.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Poi leggi il suo piano d'azione con Elenca le attività, oppure fai domande alla chat con Invia un messaggio nel sito.

Le risposte

  • Una risposta è { "data": … }: un oggetto, oppure un elenco con tutti gli elementi.
  • Le date sono in ISO 8601 in UTC, e gli id sono UUID.
  • I crediti non compaiono mai come numeri grezzi, solo come quota del periodo: Leggi lo spazio di lavoro, Leggi l'utilizzo.

Cosa vede una chiave

Una chiave appartiene a un solo spazio di lavoro: vede i siti e le conversazioni di quello spazio e nient'altro, e agisce con i diritti del membro che l'ha creata.

Il documento OpenAPI

Tutto il riferimento in OpenAPI 3.1, da importare in Postman, Insomnia o in un generatore di client: openapi.json.

Hai una domanda a cui qui non trovi risposta? Scrivici.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi