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).

OperazioneChiamata
Elenca i sitiGET /sitesGratis
Crea un sitoPOST /sitesGratis
Leggi un sitoGET /sites/{siteId}Gratis
Analizza un sitoPOST /sites/{siteId}/analyzeA pagamento
Elenca i connettori del sitoGET /sites/{siteId}/connectorsGratis
Modifica un sitoPATCH /sites/{siteId}Gratis
Elimina un sitoDELETE /sites/{siteId}Gratis
Metti un sito tra i preferitiPATCH /sites/{siteId}/favoriteGratis
Leggi la salute del sitoGET /sites/{siteId}/healthGratis
Leggi l'accessibilità del sitoGET /sites/{siteId}/accessibilityGratis
Leggi una regola di accessibilitàGET /sites/{siteId}/accessibility/{ruleId}Gratis

Elenca i siti

GET/sitesGratis

Tutti i siti dello spazio di lavoro.

Strumento MCP list_sites

Richiesta
curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"
Risposta · 200
{
  "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

POST/sitesGratis

Crea un sito e, se vuoi, avvia la sua analisi.

Strumento MCP create_site

ArgomentoTipoDescrizione
nameobbligatoriostringIl nome del sito.1–255 caratteri
site_urlfacoltativostringIl suo indirizzo. Serve per un'analisi.fino a 500 caratteri
descriptionfacoltativostringfino a 2000 caratteri
auto_analyzefacoltativobooleanAvvia subito l'analisi (a pagamento). Saltata se non ci sono crediti: in quel caso needs_credits è true.
Richiesta
curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'
Risposta · 201
{
  "data": {
    "id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
    "analysis_status": "idle",
    "needs_credits": false
  }
}

Leggi un sito

GET/sites/{siteId}Gratis

Un sito, con tutto quello che la sua ultima analisi ha salvato (panoramica, salute, accessibilità, parole chiave…).

Strumento MCP get_site

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"
Risposta · 200
{
  "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

POST/sites/{siteId}/analyzeA pagamento

Avvia (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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
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

GET/sites/{siteId}/connectorsGratis

Gli strumenti collegati a questo sito.

Strumento MCP list_site_connectors

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Modifica un sito

PATCH/sites/{siteId}Gratis

Modifica 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
namefacoltativostringIl nome del sito (non può essere vuoto).1–255 caratteri
site_urlfacoltativostring | nullIl suo indirizzo. Vuoto o null lo cancella.
descriptionfacoltativostring | nullVuota o null la cancella.
instructionsfacoltativostring | nullCiò che l'assistente tiene a mente per questo sito. Vuoto o null le cancella.
writing_stylefacoltativostring | nullLa voce degli articoli scritti per il sito; null la cancella.
technologiesfacoltativoarrayLe tecnologie su cui gira il sito (le loro chiavi); [] le cancella.
Richiesta
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

DELETE/sites/{siteId}Gratis

Elimina 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
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

PATCH/sites/{siteId}/favoriteGratis

Aggiungi 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
favoriteobbligatoriobooleantrue mette il sito tra i preferiti, false lo toglie.
Richiesta
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

GET/sites/{siteId}/healthGratis

La 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
  -H "Authorization: Bearer sk_live_…"
Risposta · 200
{
  "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

GET/sites/{siteId}/accessibilityGratis

L'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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
  -H "Authorization: Bearer sk_live_…"

Risponde 200 con { "data": … }.

Leggi una regola di accessibilità

GET/sites/{siteId}/accessibility/{ruleId}Gratis

Tutte 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
ruleIdnel percorsostringIl suo id.
Richiesta
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.

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