hubble_mcp

⚠️ Vorsicht

Derzeit nur in lokalen VPN-Umgebungen verfügbar.

Da es gelegentlich zu API-Fehlern kommen kann, müssen Sie prüfen, ob die Datenantwort normal empfangen wurde.
(Wenn Sie auf die Nachricht klicken, die Claude als Tool verwendet hat, können Sie die API-Antwortnachricht überprüfen.)

Richten Sie Ihre Umgebung ein

• Installieren Sie Claude Desktop

  • https://claude.ai/download

• Installieren Sie uv (Hubble MCP Server ist in Python geschrieben) – https://modelcontextprotocol.io/quickstart/server#set-up-your-environment

  • Windows

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    Wenn der uv -Befehl bei der Echtzeitüberwachung einiger Sicherheitsprogramme blockiert wird, beenden Sie bitte die Echtzeitüberwachung oder schließen Sie die betreffende Datei aus.

  • MacOS/Linux

    curl -LsSf https://astral.sh/uv/install.sh | sh

• Hubble MCP Server herunterladen

  • https://github.com/ascentkorea/hubble_mcp/releases

    • Nach dem Download der Zip-Datei diese entpacken (benötigt den entsprechenden Pfad in der Einstellungsdatei weiter unten)

    • Verwenden Sie die neueste Version

• Problem HUBBLE_API_KEY

Related MCP server: PostHog MCP Server

Einrichten der Datei claude_desktop_config.json

• Claude Desktop > Datei > Einstellungen (Strg + ,) > Entwickler > Einstellungen bearbeiten

  • Nach dem Ändern der JSON-Datei müssen Sie Claude Desktop > Datei > Beenden neu starten!

• Wenn Sie einen Mac verwenden, benötigen Sie den absoluten Pfad zur ausführbaren UV-Datei (siehe Mac-Beispiel unten).

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "<Hubble MCP Server 다운로드후 zip 파일 압축 해제후 data_api.py 파일 있는 경로>",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "<HUBBLE_API_KEY>"
      }
    }
  }
}

Beispiel einer Windows-Einstellungsdatei

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "C:\\Users\\XXXX\\Documents\\hubble\\hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

Beispiel einer MacOS/Linux-Konfigurationsdatei

{
  "mcpServers": {
    "hubble": {
      "command": "/Users/XXX/.local/bin/uv",
      "args": [
          "--directory",
          "/Users/XXX/workspace/hubble/hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

Beschreibung der bereitgestellten Tools (Funktionen) ( https://hubble-data-api.ascentlab.io/ )

• get_search_path: Suchpfad-API

• get_keyword_info: Suchvolumen für das Keyword (monatliches Suchvolumen), Zusammenfassung der in Google SERP angezeigten Featuretypen, Suchabsicht (INCT), Geschlechter-/Altersverhältnis für Korea

• get_graph_info: Beziehungsinformationen zwischen Schlüsselwörtern

• crawl_google_serp: Google SERP API

• crawl_web_page: Allgemeine API zur Webseitensammlung

• crawl_google_suggest_extension: Google Suggest-API

• crawl_google_trends: Google Trends API