Just-Magic MCP Server

MCP-Server für die Arbeit mit der API des Dienstes Just-Magic.org — einer Plattform für SEO-Automatisierung und die Arbeit mit Semantik.

Funktionen

Der Server stellt die folgenden Tools bereit:

📊 Informationen und Aufgabenverwaltung

• justmagic_info — Informationen zum Konto (Tarif, Guthaben, Gültigkeitsdauer)

• justmagic_list_tasks — Liste der Benutzeraufgaben

• justmagic_get_task — Ergebnisse einer Aufgabe abrufen

🔍 Clustering und Analyse

• justmagic_cluster — Clusterung des semantischen Kerns nach den Top-Ergebnissen von Яндекс/Google

• justmagic_text_analyzer — Analyse der Textoptimierung von Seiten

• justmagic_thematic_classifier — thematische Klassifizierung von Suchanfragen

📝 LSI und Texte

• justmagic_aquarelle — LSI-Analyse des Textes auf the thematische Relevanz zur Suchanfrage

• justmagic_aquarelle_generator — Generierung einer Liste von LSI-Wörtern zum Verfassen von Texten

📈 Häufigkeit und Vorschläge

• justmagic_wordstat_frequency — Erfassung der Häufigkeit aus Яндекс.Wordstat

• justmagic_wordstat_suggestions — Erfassung von Wordstat-Vorschlägen

• justmagic_suggestions_parser — Parser für Such suchvorschläge mit Iterationen

🔗 Verteilung und Erweiterung

• justmagic_markers_online — Verteilung von Suchanfragen auf User-Seiten der Website

• justmagic_expand_semantics — Erweiterung des semantikischen Kerns

• justmagic_regex_search — Suche in der Keyword-Datenbank nach regulärem Ausdruck

Voraussetzungen

• Python 3.10+

• Ein Just-Magic.org-Konto mit dem Tarif „Эцилопп“ oder höher (für den API-Zugriff)

Installation

Entpacken Sie das archiv-repo (or Klonen Sie das repository) an einen beliebigen Ort, z. B. ~/code/just-magic-mcp, und erstellen Sie eine virtuelle Umgebung with den Abhängigkeiten:

cd ~/code/just-magic-mcp
python3 -m venv venv
./venv/bin/pip install "mcp>=1.0.0,<2" "httpx>=0.27.0"

Die folgende Wichtig: Es wird die Bibliothek mcp in der Version 1.x benötigt — with mcp 2.0 lässt sich der Server nicht start. Der obige Befehl installiert die richtige Version.

Überprüfen Sie, wenn alles korrekt eingerichtet ist:

./venv/bin/python -c "import server; print('OK')"

Konfiguration

1. API-Key anfordern

Melde Sie sich im persönlichen Bereich von Just-Magic an und kopieren Sie Ihren API-Key.

Der Key wird dem Server über die Umgebungsvariable JUSTMAGIC_API_KEY übergeben. Er muss nicht global in der Shell exportiert werden — er wird in der Konfiguration des jeweiligen Clients festgelegt, der den Server startet (Claude Desktop oder Hermes), siehe unten.

2а. Verbinden mit Claude Desktop

Fügen Sie dies in die Configuringdatei von Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "just-magic": {
      "command": "/ПОЛНЫЙ/ПУТЬ/К/just-magic-mcp/venv/bin/python",
      "args": ["/ПОЛНЫЙ/ПУТЬ/К/just-magic-mcp/server.py"],
      "env": {
        "JUSTMAGIC_API_KEY": "ваш_api_ключ"
      }
    }
  }
}

Erstellen Sie /ПОЛНЫЙ/ПУТЬ/К/ durch den resting-effective path (ist z. B. /Users/ivan/code/) ersetzen und setzen Sie Ihren API-Key anstelle von ваш_api_ключ ein. Starten Sie danach Claude Desktop neu.

2б. Verbinden mit Hermes

Methode 1 — interaktiv über CLI:

hermes mcp add

Beantworten Sie die Fragen des Assistenten: transport — stdio, command — vollständiger Pfad zu venv/bin/python, args — vollständiger Pfad zu server.py, variable Umgebung — JUSTMAGIC_API_KEY mit dem Wert Ihres Schlüssels.

Methode 2 — manuell. Fügen Sie in ~/.hermes/config.yaml einen Block auf oberer Ebene:

mcp_servers:
  just-magic:
    command: /ПОЛНЫЙ/ПУТЬ/К/just-magic-mcp/venv/bin/python
    args:
      - /ПОЛНЫЙ/ПУТЬ/К/just-magic-mcp/server.py
    env:
      JUSTMAGIC_API_KEY: ${JUSTMAGIC_API_KEY}

Den Schlüssel selbst legen Sie in der Datei ~/.hermes/.env (create it, if it doesn't exist):

JUSTMAGIC_API_KEY=ваш_api_ключ

Die Referenz ${JUSTMAGIC_API_KEY} in der Konfiguration wird automatisch aus .env eingefügt — so wird der Schlüssel nicht in der config.yaml gespeichert. Man kann den Schlüssel auch, direkt in env: in der config.yaml, but die Variante with .env is aufgeräumter.

Nach der Änderung der eingredshermes new session, damit die Tools geladen werden. Verbindung prüfen: hermes mcp list und hermes mcp test just-magic.

Zusammenhang Werkzeuge variable (optional)

• JUST_MAGIC_DB_PATH — Pfad zur lokalen SQLite-Datenbank zur Speicherung von Ergebnissen (Standard: ~/justmagic_style_results.db).

Anwendungsbeispiele

Clustering von Suchanfragen

Кластеризуй эти запросы для Москвы:
- купить ноутбук
- ноутбук цена
- ноутбук для работы
- ноутбук игровой

Analyse eines Seitentextes

Проанализируй текстовую оптимизацию страницы https://example.com/notebook 
по запросам: купить ноутбук, ноутбук недорого

LSI-Wörter erstellen

Сгенерируй список LSI-слов для написания текста про "ремонт квартир"

Kosten einer Aufgabe prüfen

Alle Tools unterstützen den Parameter just_ask: true — wenn er gesetzt wird, wird die Aufgabe nicht ausgeführt, sondern nur Ihre Kosten berechnet.

Сколько будет стоить кластеризация 1000 запросов?

Asynchrone Aufgabenabwicklung

Just-Magic.org verwendet ein asynchrones Modell zur Ausführung von Aufgaben:

1. Sie stellen eine Aufgabe → erhalten tid (Task-ID)

2. Prüfen Sie den Status über justmagic_get_task

3. Wenn die Aufgabe fertig ist, erhalten Sie das Ergebnis

Empfohlener Prüfintervall: 30+ Sekunden.

Яндекс-Regionscodes

Einige beliebte Regionen:

Vollständige Liste: Яндекс.Помощь

Lizenz

MIT

Links

• Just-Magic.org

• [API-Dokumentation](https://just-m Magic/info/api.php)

• Telegram-Kanal