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

OperationAufruf
Websites auflistenGET /sitesKostenlos
Website erstellenPOST /sitesKostenlos
Website abrufenGET /sites/{siteId}Kostenlos
Website analysierenPOST /sites/{siteId}/analyzeKostenpflichtig
Konnektoren einer Website auflistenGET /sites/{siteId}/connectorsKostenlos
Website ändernPATCH /sites/{siteId}Kostenlos
Website löschenDELETE /sites/{siteId}Kostenlos
Website als Favorit markierenPATCH /sites/{siteId}/favoriteKostenlos
Zustand einer Website abrufenGET /sites/{siteId}/healthKostenlos
Barrierefreiheit einer Website abrufenGET /sites/{siteId}/accessibilityKostenlos
Barrierefreiheitsregel abrufenGET /sites/{siteId}/accessibility/{ruleId}Kostenlos

Websites auflisten

GET/sitesKostenlos

Alle Websites des Workspaces.

MCP-Tool list_sites

Anfrage
curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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"
    }
  ]
}

Website erstellen

POST/sitesKostenlos

Eine Website erstellen und auf Wunsch ihre Analyse starten.

MCP-Tool create_site

ArgumentTypBeschreibung
nameerforderlichstringDer Name der Website.1–255 Zeichen
site_urloptionalstringIhre Adresse. Für eine Analyse nötig.bis zu 500 Zeichen
descriptionoptionalstringbis zu 2000 Zeichen
auto_analyzeoptionalbooleanDie Analyse sofort starten (kostenpflichtig). Ohne Credits übersprungen: needs_credits ist dann true.
Anfrage
curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'
Antwort · 201
{
  "data": {
    "id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
    "analysis_status": "idle",
    "needs_credits": false
  }
}

Website abrufen

GET/sites/{siteId}Kostenlos

Eine Website mit allem, was ihre letzte Analyse gespeichert hat (Überblick, Zustand, Barrierefreiheit, Keywords…).

MCP-Tool get_site

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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"
  }
}

Website analysieren

POST/sites/{siteId}/analyzeKostenpflichtig

Die 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
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

GET/sites/{siteId}/connectorsKostenlos

Die mit dieser Website verbundenen Tools.

MCP-Tool list_site_connectors

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Website ändern

PATCH/sites/{siteId}Kostenlos

Die 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
nameoptionalstringDer Name der Website (darf nicht leer sein).1–255 Zeichen
site_urloptionalstring | nullIhre Adresse. Leer oder null löscht sie.
descriptionoptionalstring | nullLeer oder null löscht sie.
instructionsoptionalstring | nullWas der Assistent für diese Website beachtet. Leer oder null löscht sie.
writing_styleoptionalstring | nullDer Ton der Artikel, die für die Website geschrieben werden; null löscht ihn.
technologiesoptionalarrayDie Technologien, auf denen die Website läuft (ihre Schlüssel); [] löscht sie.
Anfrage
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

DELETE/sites/{siteId}Kostenlos

Die 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Website als Favorit markieren

PATCH/sites/{siteId}/favoriteKostenlos

Die 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
favoriteerforderlichbooleantrue markiert die Website mit einem Stern, false entfernt ihn.
Anfrage
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

GET/sites/{siteId}/healthKostenlos

Der 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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
      }
    ]
  }
}

Barrierefreiheit einer Website abrufen

GET/sites/{siteId}/accessibilityKostenlos

Die 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
  -H "Authorization: Bearer sk_live_…"

Antwortet 200 mit { "data": … }.

Barrierefreiheitsregel abrufen

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

Alle 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

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
ruleIdim PfadstringDie ID.
Anfrage
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.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden