hubble_mcp

⚠️ Внимание!

В настоящее время доступно только в локальных VPN-средах.

Поскольку API иногда может давать сбои, необходимо проверить, был ли получен ответ с данными нормально.
(Если вы нажмете на сообщение, которое Клод использовал в качестве инструмента, вы сможете проверить ответное сообщение API.)

настройте-вашу-среду

• Установить Клод Десктоп

  • https://claude.ai/download

• Установите uv (сервер Hubble MCP написан на Python) - https://modelcontextprotocol.io/quickstart/server#set-up-your-environment

  • Окна

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

    Если команда uv заблокирована при мониторинге в реальном времени некоторыми программами безопасности, остановите мониторинг в реальном времени или исключите рассматриваемый файл.

  • MacOS/Linux

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

• Загрузить сервер Hubble MCP

  • https://github.com/ascentkorea/hubble\_mcp/releases

    • После загрузки zip-файла распакуйте его (требуется указать соответствующий путь в файле настроек ниже)

    • Используйте последнюю версию

• Выпуск HUBBLE_API_KEY

Related MCP server: PostHog MCP Server

Настройка файла claude_desktop_config.json

• Claude Desktop > Файл > Настройки (Ctrl + ,) > Разработчик > Изменить настройки

  • После изменения файла json необходимо перезапустить Claude Desktop > Файл > Выход!

• Если вы работаете на Mac, вам нужен абсолютный путь к исполняемому файлу UV, см. пример для Mac ниже.

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

Образец файла настроек Windows

{
  "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"
      }
    }
  }
}

Пример файла конфигурации MacOS/Linux

{
  "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"
      }
    }
  }
}

Описание предоставляемых инструментов (функций) ( https://hubble-data-api.ascentlab.io/ )

• get_search_path: API пути поиска

• get_keyword_info: Объем поиска по ключевому слову (ежемесячный объем поиска), сводка типов функций, появляющихся в результатах поиска Google, намерение поиска (INCT), соотношение пола и возраста для Кореи

• get_graph_info: Информация о взаимосвязи между ключевыми словами

• crawl_google_serp: API поисковой выдачи Google

• crawl_web_page: API общего сбора веб-страниц

• crawl_google_suggest_extension: API Google Suggest

• crawl_google_trends: API Google Trends