DocumentationRéférence de l'API
Sites
Les sites, leur analyse, leur santé et leur accessibilité.
Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).
| Opération | Appel | |
|---|---|---|
| Lister les sites | GET /sites | Gratuit |
| Créer un site | POST /sites | Gratuit |
| Récupérer un site | GET /sites/{siteId} | Gratuit |
| Analyser un site | POST /sites/{siteId}/analyze | Facturé |
| Lister les connecteurs du site | GET /sites/{siteId}/connectors | Gratuit |
| Modifier un site | PATCH /sites/{siteId} | Gratuit |
| Supprimer un site | DELETE /sites/{siteId} | Gratuit |
| Mettre un site en favori | PATCH /sites/{siteId}/favorite | Gratuit |
| Récupérer la santé du site | GET /sites/{siteId}/health | Gratuit |
| Récupérer l'accessibilité du site | GET /sites/{siteId}/accessibility | Gratuit |
| Récupérer une règle d'accessibilité | GET /sites/{siteId}/accessibility/{ruleId} | Gratuit |
Lister les sites
/sitesGratuitTous les sites de l'espace.
Outil 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"
}
]
}Créer un site
/sitesGratuitCréer un site, et lancer son analyse si vous le souhaitez.
Outil MCP create_site
| Argument | Type | Description |
|---|---|---|
nameobligatoire | string | Le nom du site.1–255 caractères |
site_urlfacultatif | string | Son adresse. Nécessaire pour une analyse.jusqu'à 500 caractères |
descriptionfacultatif | string | jusqu'à 2000 caractères |
auto_analyzefacultatif | boolean | Lancer l'analyse tout de suite (facturée). Ignoré sans crédits : needs_credits vaut alors 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
}
}Récupérer un site
/sites/{siteId}GratuitUn site, avec tout ce que sa dernière analyse a enregistré (vue d'ensemble, santé, accessibilité, mots-clés…).
Outil MCP get_site
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
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"
}
}Analyser un site
/sites/{siteId}/analyzeFacturéLancer (ou relancer) l'analyse complète du site : exploration, santé technique, concurrents, mots-clés, plan d'action.
- S'exécute en arrière-plan (quelques minutes) : lisez get_site jusqu'à ce que analysis_status vaille ready ou error.
- Facturée exactement comme une analyse lancée dans l'app. 402 INSUFFICIENT_TOKENS sans crédits.
- Une nouvelle analyse garde le plan d'action existant et y ajoute ce qui est nouveau.
Outil MCP analyze_site
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/analyze \
-H "Authorization: Bearer sk_live_…"Répond 202 avec { "data": … }.
Lister les connecteurs du site
/sites/{siteId}/connectorsGratuitLes outils connectés à ce site.
Outil MCP list_site_connectors
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Modifier un site
/sites/{siteId}GratuitModifier les réglages du site : nom, adresse, description, instructions, style de rédaction, technologies.
- Seuls les champs fournis changent. Renvoie le site avec ses réglages.
- Changer l'adresse ne relance pas l'analyse : appelez analyze_site pour cela.
Outil MCP update_site
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
namefacultatif | string | Le nom du site (ne peut pas être vide).1–255 caractères |
site_urlfacultatif | string | null | Son adresse. Vide ou null l'efface. |
descriptionfacultatif | string | null | Vide ou null l'efface. |
instructionsfacultatif | string | null | Ce que l'assistant garde en tête pour ce site. Vide ou null les efface. |
writing_stylefacultatif | string | null | La voix des articles écrits pour le site ; null l'efface. |
technologiesfacultatif | array | Les technologies sur lesquelles tourne le site (leurs clés) ; [] les efface. |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Répond 200 avec { "data": … }.
Supprimer un site
/sites/{siteId}GratuitSupprimer le site.
- Suppression douce, comme dans l'app : le site quitte les listes et ses routes répondent 404. Rien d'autre ne change : ses conversations, ses documents et ses données enregistrées sont conservés.
Outil MCP delete_site
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Mettre un site en favori
/sites/{siteId}/favoriteGratuitAjouter le site aux favoris, ou l'en retirer.
- Mettre en favori ne compte pas comme une activité : le site garde sa place dans le tri « Activité ».
Outil MCP set_site_favorite
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
favoriteobligatoire | boolean | true ajoute le site aux favoris, false l'en retire. |
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}'Répond 200 avec { "data": … }.
Récupérer la santé du site
/sites/{siteId}/healthGratuitLa santé technique du site : le score et les problèmes de la dernière analyse, l'historique du score, et les nombres de problèmes qui ont changé depuis l'analyse précédente.
Outil MCP get_site_health
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
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
}
]
}
}Récupérer l'accessibilité du site
/sites/{siteId}/accessibilityGratuitL'accessibilité du site (WCAG 2.1 A et AA) : le score et les constats par règle de la dernière analyse, et l'historique du score.
Outil MCP get_site_accessibility
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Récupérer une règle d'accessibilité
/sites/{siteId}/accessibility/{ruleId}GratuitToutes les pages où une règle d'accessibilité échoue (le rule_id d'un constat), avec les éléments en défaut.
- pages est plafonné ; page_count est le nombre exact de pages concernées.
Outil MCP get_accessibility_rule
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
ruleIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility/{ruleId} \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

