DocumentazioneRiferimento API
Siti
I siti, la loro analisi, la salute e l'accessibilità.
Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).
| Operazione | Chiamata | |
|---|---|---|
| Elenca i siti | GET /sites | Gratis |
| Crea un sito | POST /sites | Gratis |
| Leggi un sito | GET /sites/{siteId} | Gratis |
| Analizza un sito | POST /sites/{siteId}/analyze | A pagamento |
| Elenca i connettori del sito | GET /sites/{siteId}/connectors | Gratis |
| Modifica un sito | PATCH /sites/{siteId} | Gratis |
| Elimina un sito | DELETE /sites/{siteId} | Gratis |
| Metti un sito tra i preferiti | PATCH /sites/{siteId}/favorite | Gratis |
| Leggi la salute del sito | GET /sites/{siteId}/health | Gratis |
| Leggi l'accessibilità del sito | GET /sites/{siteId}/accessibility | Gratis |
| Leggi una regola di accessibilità | GET /sites/{siteId}/accessibility/{ruleId} | Gratis |
Elenca i siti
/sitesGratisTutti i siti dello spazio di lavoro.
Strumento MCP list_sites
curl https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
"name": "Alpha Conseil",
"site_url": "https://alpha.example.com",
"analysis_status": "ready",
"created_at": "2026-09-08T13:26:58.000Z"
},
{
"id": "01a0ce72-b1e0-738d-9205-34630681ef77",
"name": "Beta Shop",
"site_url": "https://beta.example.com",
"analysis_status": "idle",
"created_at": "2026-09-23T13:26:58.000Z"
}
]
}Crea un sito
/sitesGratisCrea un sito e, se vuoi, avvia la sua analisi.
Strumento MCP create_site
| Argomento | Tipo | Descrizione |
|---|---|---|
nameobbligatorio | string | Il nome del sito.1–255 caratteri |
site_urlfacoltativo | string | Il suo indirizzo. Serve per un'analisi.fino a 500 caratteri |
descriptionfacoltativo | string | fino a 2000 caratteri |
auto_analyzefacoltativo | boolean | Avvia subito l'analisi (a pagamento). Saltata se non ci sono crediti: in quel caso needs_credits è true. |
curl -X POST https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'{
"data": {
"id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
"analysis_status": "idle",
"needs_credits": false
}
}Leggi un sito
/sites/{siteId}GratisUn sito, con tutto quello che la sua ultima analisi ha salvato (panoramica, salute, accessibilità, parole chiave…).
Strumento MCP get_site
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
"name": "Alpha Conseil",
"site_url": "https://alpha.example.com",
"description": null,
"analysis_status": "ready",
"analysis_stage": null,
"last_analyzed_at": "2026-10-21T13:26:58.000Z",
"site_context": {
"description": "Alpha Conseil, agence de référencement naturel pour les PME lyonnaises.",
"platform": "inconnu",
"language": "fr",
"country": "FR",
"positioning": "Le SEO durable et expliqué sans jargon pour les PME.",
"primaryTopics": [
"audit SEO",
"contenus"
],
"targetKeywords": [
"…",
"…"
],
"kpis": {
"organic_traffic_estimate": 1840,
"keywords_count": 312,
"authority_score": null
},
"suggestedInstructions": "Parle simplement à des dirigeants de PME non techniques.",
"analyzedAt": "2026-10-21T13:26:58.272Z",
"contentLang": "fr",
"health": {
"score": 72,
"label": "good",
"pagesChecked": 6,
"items": [
"…",
"…"
],
"checkedAt": "2026-10-21T13:26:58.272Z"
},
"accessibility": {
"score": 78,
"totalIssues": 4,
"byLevel": "…",
"findings": [
"…",
"…"
],
"checkedAt": "2026-10-21T13:26:58.272Z"
},
"pageVisibility": {
"checkedPages": 6,
"indexable": 6,
"noindex": 0,
"visibleButShouldnt": "…",
"hiddenButShould": "…",
"checkedAt": "2026-10-21T13:26:58.272Z"
},
"actionPlan": {
"scorecard": "…",
"focus": "…",
"priorityOrder": [
"content",
"backlinks"
],
"summary": "Un site sain qui manque de contenus et de liens.",
"generatedAt": "2026-10-21T13:26:58.272Z"
}
},
"instructions": null,
"writing_style": null,
"technologies": [],
"favorite": false,
"created_at": "2026-09-08T13:26:58.000Z"
}
}Analizza un sito
/sites/{siteId}/analyzeA pagamentoAvvia (o riavvia) l'analisi completa del sito: scansione, salute tecnica, concorrenti, parole chiave, piano d'azione.
- Viene eseguita in background (qualche minuto): leggi get_site finché analysis_status non è ready o error.
- Addebitata esattamente come un'analisi avviata nell'app. 402 INSUFFICIENT_TOKENS se non ci sono crediti.
- Una nuova analisi mantiene il piano d'azione esistente e aggiunge le novità.
Strumento MCP analyze_site
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/analyze \
-H "Authorization: Bearer sk_live_…"Risponde 202 con { "data": … }.
Elenca i connettori del sito
/sites/{siteId}/connectorsGratisGli strumenti collegati a questo sito.
Strumento MCP list_site_connectors
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Modifica un sito
/sites/{siteId}GratisModifica le impostazioni del sito: nome, indirizzo, descrizione, istruzioni, stile di scrittura, tecnologie.
- Cambiano solo i campi indicati. Risponde con il sito e le sue impostazioni.
- Cambiare l'indirizzo non rilancia l'analisi: per quello chiama analyze_site.
Strumento MCP update_site
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
namefacoltativo | string | Il nome del sito (non può essere vuoto).1–255 caratteri |
site_urlfacoltativo | string | null | Il suo indirizzo. Vuoto o null lo cancella. |
descriptionfacoltativo | string | null | Vuota o null la cancella. |
instructionsfacoltativo | string | null | Ciò che l'assistente tiene a mente per questo sito. Vuoto o null le cancella. |
writing_stylefacoltativo | string | null | La voce degli articoli scritti per il sito; null la cancella. |
technologiesfacoltativo | array | Le tecnologie su cui gira il sito (le loro chiavi); [] le cancella. |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Risponde 200 con { "data": … }.
Elimina un sito
/sites/{siteId}GratisElimina il sito.
- Eliminazione logica, come nell'app: il sito esce dagli elenchi e i suoi endpoint rispondono 404. Nient'altro cambia: le sue conversazioni, i suoi documenti e i dati salvati vengono conservati.
Strumento MCP delete_site
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Metti un sito tra i preferiti
/sites/{siteId}/favoriteGratisAggiungi il sito ai preferiti o toglilo.
- Mettere un sito tra i preferiti non conta come attività: il sito resta al suo posto nell'ordinamento «Attività».
Strumento MCP set_site_favorite
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
favoriteobbligatorio | boolean | true mette il sito tra i preferiti, false lo toglie. |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/favorite \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"favorite": true}'Risponde 200 con { "data": … }.
Leggi la salute del sito
/sites/{siteId}/healthGratisLa salute tecnica del sito: il punteggio e i problemi dell'ultima analisi, la cronologia del punteggio e quali conteggi dei problemi sono cambiati rispetto all'analisi precedente.
Strumento MCP get_site_health
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
-H "Authorization: Bearer sk_live_…"{
"data": {
"health": {
"score": 72,
"label": "good",
"pages_checked": 6,
"items": [
"…",
"…"
],
"checked_at": "2026-10-21T13:26:58.272Z"
},
"history": [
{
"score": 61,
"label": "fair",
"pages_checked": 6,
"analyzed_at": "2026-09-23T13:26:58.000Z"
},
{
"score": 72,
"label": "good",
"pages_checked": 6,
"analyzed_at": "2026-10-21T13:26:58.000Z"
}
],
"changes": [
{
"key": "noDescription",
"before": 3,
"after": 1
},
{
"key": "thin",
"before": 3,
"after": 2
}
]
}
}Leggi l'accessibilità del sito
/sites/{siteId}/accessibilityGratisL'accessibilità del sito (WCAG 2.1 A e AA): il punteggio e i risultati per regola dell'ultima analisi, e la cronologia del punteggio.
Strumento MCP get_site_accessibility
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Leggi una regola di accessibilità
/sites/{siteId}/accessibility/{ruleId}GratisTutte le pagine su cui una regola di accessibilità non è rispettata (il rule_id di un risultato), con gli elementi in errore.
- pages è limitato; page_count è il numero esatto di pagine interessate.
Strumento MCP get_accessibility_rule
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
ruleIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility/{ruleId} \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

