DokumentationAPI-Referenz
Keywords
Die Keywords einer Website: auflisten, hinzufügen, ändern und löschen.
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 | |
|---|---|---|
| Keywords auflisten | GET /sites/{siteId}/keywords | Kostenlos |
| Keyword hinzufügen | POST /sites/{siteId}/keywords | Kostenlos |
| Keyword ändern | PATCH /sites/{siteId}/keywords/{keywordId} | Kostenlos |
| Keyword löschen | DELETE /sites/{siteId}/keywords/{keywordId} | Kostenlos |
Keywords auflisten
/sites/{siteId}/keywordsKostenlosDie Ziel-Keywords der Website, aus ihrer Analyse oder von Hand hinzugefügt, mit Suchvolumen, Schwierigkeit und aktueller Position.
- Text wird so zurückgegeben, wie er gespeichert ist, in der Sprache, in der er geschrieben wurde (source_lang; null = die Inhaltssprache der Website). Die App übersetzt ihn bei der Anzeige, die API nicht.
MCP-Tool list_keywords
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7957-b667-9b025ed3641e",
"keyword": "agence seo lyon",
"volume": 1900,
"difficulty": 45,
"cpc": 1.8,
"competition": 40,
"current_position": 4,
"traffic": 475,
"url": "https://alpha.example.com/services",
"intent": "commercial",
"priority": "high",
"rationale": "Opportunité sur « agence seo lyon ».",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
},
{
"id": "01a15ea4-c1e0-7e93-9a50-38742b693311",
"keyword": "audit seo",
"volume": 2400,
"difficulty": 60,
"cpc": 1.8,
"competition": 40,
"current_position": 12,
"traffic": 200,
"url": "https://alpha.example.com/services",
"intent": "commercial",
"priority": "high",
"rationale": "Opportunité sur « audit seo ».",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
}
]
}Keyword hinzufügen
/sites/{siteId}/keywordsKostenlosEin Ziel-Keyword zur Website hinzufügen.
- So gespeichert, wie angegeben, als manuelles Keyword: Es werden keine Keyword-Daten abgerufen (nichts wird abgerechnet). Antwortet mit dem Keyword.
MCP-Tool add_keyword
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
keyworderforderlich | string | Das Keyword.1–255 Zeichen |
volumeoptional | string | null | Sein monatliches Suchvolumen, falls bekannt. |
difficultyoptional | string | null | Seine Schwierigkeit, 0–100, falls bekannt. |
intentoptional | string | null | informational, commercial, transactional oder navigational. |
priorityoptional | string | high, medium (Standard) oder low.high | medium | low |
rationaleoptional | string | null | Warum es sich lohnt. |
source_langoptional | string | Die Sprache, in der der Text geschrieben ist (z. B. "fr", "en"). Ohne Angabe: die Inhaltssprache der Website.2–5 Zeichen |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/keywords \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"keyword": "…"}'Antwortet 201 mit { "data": … }.
Keyword ändern
/sites/{siteId}/keywords/{keywordId}KostenlosEin Ziel-Keyword ändern: das Keyword, seine Kennzahlen, Suchintention, Priorität oder Begründung.
- Antwortet mit dem Keyword in seinem neuen Stand.
MCP-Tool update_keyword
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
keywordIdim Pfad | string | Die ID. |
keywordoptional | string | 1–255 Zeichen |
volumeoptional | string | null | |
difficultyoptional | string | null | |
intentoptional | string | null | |
priorityoptional | string | high | medium | low |
rationaleoptional | string | null | |
source_langoptional | string | Die Sprache des neuen Keywords bzw. der neuen Begründung. Wird ignoriert, wenn sich keins von beiden ändert.2–5 Zeichen |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"keyword": "…"}'Antwortet 200 mit { "data": … }.
Keyword löschen
/sites/{siteId}/keywords/{keywordId}KostenlosEin Ziel-Keyword von der Website entfernen.
MCP-Tool delete_keyword
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
keywordIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
-H "Authorization: Bearer sk_live_…"Antwortet 204 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

