API-Referenz
MCP-Server
RedReplier stellt einen gehosteten MCP-Server bereit, der dieselbe öffentliche REST-API kapselt. Nutze ihn, wenn ein KI-Client Websites, Keywords, Mentions, Abrechnungsvorschauen und Alert-Einstellungen direkt verwalten soll.
MCP-URL: https://mcp.redreplier.com/mcp
Authentifizierung
Übergib dasselbe RedReplier-API-Token im Authorization-Header. Der Server ermittelt das Konto aus diesem Token.
Client-Konfiguration
{
"mcpServers": {
"redreplier": {
"type": "http",
"url": "https://mcp.redreplier.com/mcp",
"headers": {
"Authorization": "Bearer redreplier_test_1234567890"
}
}
}
}Tools
| Tool | Argumente | Gibt zurück |
|---|---|---|
list_websites | Keine Argumente | { websites: Website[] } |
get_website | websiteId | Website |
create_website | url, optional name, keywords, description | Website |
update_website | websiteId, optional name, description | Website |
delete_website | websiteId | { deleted: true } |
analyze_website | url | { description: string } |
add_keywords | websiteId, keywords | Website |
edit_keyword | keywordId, value | Keyword |
disable_keyword | keywordId | Keyword |
enable_keyword | keywordId | Keyword |
delete_keyword | keywordId | { deleted: true } |
activate_pending_keywords | Keine Argumente | { websites: Website[] } |
preview_activate_pending | Keine Argumente | Keyword-Abrechnungsvorschau |
preview_keyword_billing | desiredKeywordCount | Keyword-Abrechnungsvorschau |
keyword_change_usage | Keine Argumente | Keyword-Edit-Nutzung |
list_mentions | optional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to, limit, offset | paginierte Mention[] |
count_mentions | optional websiteId, statuses, scoreBuckets, includeLowRelevance, keywords, sources, sort, from, to | { total: number } |
update_mention_status | mentionId, status | Mention |
explain_mention | mentionId | Mention | null |
get_alert_settings | Keine Argumente | Alert-Einstellungen |
update_alert_settings | enabled, optional cadenceMinutes | Alert-Einstellungen |
Hinweise
Beginne mit list_websites, damit der Client die verfügbaren websiteId- und keywordId-Werte kennt. Rufe preview_activate_pending vor activate_pending_keywords auf, da die Aktivierung ein kostenpflichtiges Tarif-Upgrade auslösen kann.
Fehlerbehebung
- 401-Fehler bedeuten, dass das Bearer-Token fehlt, falsch formatiert ist, abgelaufen ist oder nicht mit
redreplier_beginnt. - 404-Fehler bedeuten meist, dass die ID zu einer anderen Account-Gruppe gehört oder gelöscht wurde.
- Bei kostenpflichtigen Aktionen zuerst vorab prüfen und vor der Aktivierung ausstehender Keywords die Kosten bestätigen lassen.