DokumentationAPI-Referenz
Websites
Websites, ihre Analyse, ihr Zustand und ihre Barrierefreiheit.
Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).
| Operation | Aufruf | |
|---|---|---|
| Websites auflisten | GET /sites | Kostenlos |
| Website erstellen | POST /sites | Kostenlos |
| Website abrufen | GET /sites/{siteId} | Kostenlos |
| Website analysieren | POST /sites/{siteId}/analyze | Kostenpflichtig |
| Konnektoren einer Website auflisten | GET /sites/{siteId}/connectors | Kostenlos |
| Website ändern | PATCH /sites/{siteId} | Kostenlos |
| Website löschen | DELETE /sites/{siteId} | Kostenlos |
| Website als Favorit markieren | PATCH /sites/{siteId}/favorite | Kostenlos |
| Zustand einer Website abrufen | GET /sites/{siteId}/health | Kostenlos |
| Barrierefreiheit einer Website abrufen | GET /sites/{siteId}/accessibility | Kostenlos |
| Barrierefreiheitsregel abrufen | GET /sites/{siteId}/accessibility/{ruleId} | Kostenlos |
Websites auflisten
/sitesKostenlosAlle Websites des Workspaces.
MCP-Tool 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"
}
]
}Website erstellen
/sitesKostenlosEine Website erstellen und auf Wunsch ihre Analyse starten.
MCP-Tool create_site
| Argument | Typ | Beschreibung |
|---|---|---|
nameerforderlich | string | Der Name der Website.1–255 Zeichen |
site_urloptional | string | Ihre Adresse. Für eine Analyse nötig.bis zu 500 Zeichen |
descriptionoptional | string | bis zu 2000 Zeichen |
auto_analyzeoptional | boolean | Die Analyse sofort starten (kostenpflichtig). Ohne Credits übersprungen: needs_credits ist dann 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
}
}Website abrufen
/sites/{siteId}KostenlosEine Website mit allem, was ihre letzte Analyse gespeichert hat (Überblick, Zustand, Barrierefreiheit, Keywords…).
MCP-Tool get_site
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die 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"
}
}Website analysieren
/sites/{siteId}/analyzeKostenpflichtigDie vollständige Analyse der Website starten (oder neu starten): Crawl, technischer Zustand, Wettbewerber, Keywords, Aktionsplan.
- Läuft im Hintergrund (einige Minuten): Lesen Sie get_site, bis analysis_status ready oder error ist.
- Genau wie eine in der App gestartete Analyse abgerechnet. 402 INSUFFICIENT_TOKENS ohne Credits.
- Eine neue Analyse behält den bestehenden Aktionsplan und fügt Neues hinzu.
MCP-Tool analyze_site
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/analyze \
-H "Authorization: Bearer sk_live_…"Antwortet 202 mit { "data": … }.
Konnektoren einer Website auflisten
/sites/{siteId}/connectorsKostenlosDie mit dieser Website verbundenen Tools.
MCP-Tool list_site_connectors
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Website ändern
/sites/{siteId}KostenlosDie Einstellungen der Website ändern: Name, Adresse, Beschreibung, Anweisungen, Schreibstil, Technologien.
- Nur die angegebenen Felder werden geändert. Antwortet mit der Website und ihren Einstellungen.
- Eine geänderte Adresse startet die Analyse nicht neu: Rufen Sie dafür analyze_site auf.
MCP-Tool update_site
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
nameoptional | string | Der Name der Website (darf nicht leer sein).1–255 Zeichen |
site_urloptional | string | null | Ihre Adresse. Leer oder null löscht sie. |
descriptionoptional | string | null | Leer oder null löscht sie. |
instructionsoptional | string | null | Was der Assistent für diese Website beachtet. Leer oder null löscht sie. |
writing_styleoptional | string | null | Der Ton der Artikel, die für die Website geschrieben werden; null löscht ihn. |
technologiesoptional | array | Die Technologien, auf denen die Website läuft (ihre Schlüssel); [] löscht sie. |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Antwortet 200 mit { "data": … }.
Website löschen
/sites/{siteId}KostenlosDie Website löschen.
- Weiches Löschen, wie in der App: Die Website verschwindet aus den Listen, und ihre Endpunkte antworten 404. Sonst ändert sich nichts: Ihre Unterhaltungen, Dokumente und gespeicherten Daten bleiben erhalten.
MCP-Tool delete_site
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Website als Favorit markieren
/sites/{siteId}/favoriteKostenlosDie Website mit einem Stern markieren oder den Stern entfernen.
- Der Stern zählt nicht als Aktivität: Die Website behält ihren Platz in der Sortierung „Aktivität“.
MCP-Tool set_site_favorite
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
favoriteerforderlich | boolean | true markiert die Website mit einem Stern, false entfernt ihn. |
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}'Antwortet 200 mit { "data": … }.
Zustand einer Website abrufen
/sites/{siteId}/healthKostenlosDer technische Zustand der Website: Score und Probleme der letzten Analyse, der Verlauf des Scores und welche Problemzahlen sich seit der vorherigen Analyse geändert haben.
MCP-Tool get_site_health
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die 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
}
]
}
}Barrierefreiheit einer Website abrufen
/sites/{siteId}/accessibilityKostenlosDie Barrierefreiheit der Website (WCAG 2.1 A und AA): Score und Befunde der letzten Analyse nach Regel sowie der Verlauf des Scores.
MCP-Tool get_site_accessibility
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Barrierefreiheitsregel abrufen
/sites/{siteId}/accessibility/{ruleId}KostenlosAlle Seiten, auf denen eine Barrierefreiheitsregel verletzt wird (die rule_id eines Befunds), mit den betroffenen Elementen.
- pages ist begrenzt; page_count ist die genaue Zahl der betroffenen Seiten.
MCP-Tool get_accessibility_rule
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
ruleIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility/{ruleId} \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

