Hologrow

официальный

Уровень данных электронной коммерции для любого ИИ

Что можно делать с Hologrow MCP?

  • Discover connected platforms — Попросите вашего ассистента вызвать list_platforms, чтобы увидеть, какие источники данных подключены и как называются их схемы.
  • Explore queryable tables — Используйте list_tables, чтобы просмотреть доступные таблицы для такой платформы, как Amazon SP Seller или Google Ads.
  • Inspect table schemas — Вызовите get_data_dictionary с точными именами таблиц, чтобы получить столбцы, типы, ключи и описания полей перед написанием SQL.
  • Check data freshness — Используйте get_freshness, чтобы проверить покрытие синхронизации и время последнего успешного обновления, прежде чем доверять любым числам.
  • Run read-only SQL queries — Запросите оператор query_db SELECT для schema_name.table, чтобы анализировать данные коммерции без записи обратно.
  • Install analysis skills — Добавляйте рабочие процессы, такие как amazon-ppc-campaign или google-ads-audit, через npx skills@latest для управляемого анализа только для чтения.

Документация

Hologrow


Hologrow MCP

Уровень данных для коммерции, созданный для ИИ. Подключите Amazon, Google Ads, GA4 и другие системы продаж один раз. Hologrow поддерживает синхронизацию данных, а MCP позволяет Claude, Cursor, Codex, ChatGPT и другим агентам выполнять запросы к ним — без экспорта в CSV или разовых API-скриптов.

Размещено на mcp.hologrow.ai. Консоль на connector.hologrow.ai. Документация на docs.hologrow.ai.


Зачем нужен Hologrow?

  • Создан для инструментов, которые вы уже используете: Подключитесь один раз, затем задавайте вопросы в Claude, Cursor, Codex, ChatGPT, Doubao или Hermes
  • Данные коммерции, готовые для LLM: Стабильные таблицы для Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza и Lingxing ERP
  • Мы берём на себя сложные задачи: OAuth платформ, синхронизация, актуальность и схема — агенты только читают
  • Только чтение по умолчанию: MCP никогда не записывает данные обратно в рекламные аккаунты или витрины
  • Готовность для агентов: Пять инструментов обнаружения плюс навыки анализа, которые можно установить одной командой

Обзор функций

Инструменты MCP

ФункцияОписание
list_platformsПосмотрите, какие источники подключены и какие схемы доступны для запросов
list_tablesСписок таблиц, доступных для запросов, для одной платформы
get_data_dictionaryКолонки, типы, ключи и описания полей перед написанием SQL
get_freshnessПокрытие синхронизации и время последнего успешного обновления
query_dbОдин запрос только для чтения SELECT к schema_name.table

Дополнительно

ФункцияОписание
НавыкиМногоразовые рабочие процессы анализа Amazon / Google Ads для вашего агента
КлиентыChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes

Быстрый старт

  1. Создайте рабочее пространство на connector.hologrow.ai.
  2. Подключите хотя бы один источник данных и дождитесь первой синхронизации.
  3. Добавьте Hologrow MCP в вашего агента. OAuth-клиенты авторизуются в интерфейсе. Cursor / Claude Code / Hermes используют API-ключ из AI Platforms → Advanced settings.

Создания API-ключа недостаточно. Установка считается успешной, когда агент может вызвать list_platforms.

MCP

Подключите любой MCP-совместимый клиент. Транспорт — Streamable HTTP.

{
  "mcpServers": {
    "Hologrow": {
      "url": "https://mcp.hologrow.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
ChatGPT / Claude / Doubao (OAuth)

ChatGPT web

  1. ChatGPTSettingsSecurity and login → включите Developer mode.
  2. Боковая панель → Plugins+.
    • Имя: Hologrow
    • URL сервера: https://mcp.hologrow.ai/mcp
    • Аутентификация: OAuth
  3. Нажмите Sign in with Hologrow и разрешите доступ.

ChatGPT desktop / Codex

  1. SettingsPluginsAdd MCP server.
  2. Имя: Hologrow. Тип: Streamable HTTP. URL: https://mcp.hologrow.ai/mcp.
  3. Нажмите Authenticate и завершите авторизацию.

Claude web / desktop

  1. SettingsCustomizeConnectorsAdd custom connector.
  2. Имя: Hologrow. URL удалённого MCP-сервера: https://mcp.hologrow.ai/mcp.
  3. Войдите и нажмите Allow access.

Doubao desktop (только настольное приложение)

  1. Skills · Connectors · PartnersNew custom connector.
  2. Имя: Hologrow. Транспорт: HTTP. URL: https://mcp.hologrow.ai/mcp. Оставьте заголовки пустыми.
  3. Нажмите Authorize и разрешите доступ.
Cursor / Claude Code / Hermes (API-ключ)

Скопируйте API-ключ из консоли, затем отправьте этот запрос в новый разговор с агентом. Замените {apiKey}. Не просите агента повторять ключ.

Install the Hologrow MCP server and test the connection.

Connection details:
- Name: Hologrow
- URL: https://mcp.hologrow.ai/mcp
- Transport: Streamable HTTP
- Authentication: API Key
- Header: Authorization: Bearer {apiKey}

Requirements:
1. Add Hologrow using this client's native MCP configuration. Use API Key authentication only; do not use OAuth.
2. Make only the changes required for installation. Keep the API key secret and do not repeat, log, or include it in your response.
3. After installation, call Hologrow's list_platforms tool once. Do not call any other tools.
4. If successful, list the connected data platforms exactly as returned. If installation, authentication, connection, or the tool call fails, stop and explain the error.

Проверка

Начните новый разговор и отправьте:

Use Hologrow’s list_platforms tool to list my connected data platforms. Do not call any other tools.

Результат:

{
  "items": [
    {
      "platform": "amazon_sp_seller",
      "connected": true,
      "table_count": 30,
      "schemas": [
        {
          "schema_name": "amazon_sp_seller_xxxxxxxx",
          "display_name": "US Seller",
          "connection_status": "healthy"
        }
      ]
    },
    {
      "platform": "google_ads",
      "connected": false,
      "table_count": 15,
      "schemas": []
    }
  ]
}

Пустой список всё равно означает, что MCP установлен — просто в рабочем пространстве ещё нет подключённого источника.


Расширьте возможности вашего агента

Подключите Hologrow к любому ИИ-агенту за считанные минуты.

Навык

Дайте вашему агенту рабочий процесс запросов и руководства по Amazon / Google Ads.

npx skills@latest add hologrow/hologrow-mcp --skill hologrow-data-middleware --global --yes

Перезапустите агента после установки. Работает с Claude Code, Cursor, Codex и другими клиентами, поддерживающими навыки.

npx skills@latest add hologrow/hologrow-mcp --skill amazon-ppc-campaign --agent cursor --global --yes
npx skills@latest add hologrow/hologrow-mcp --skill google-ads-audit --agent claude-code --global --yes

Онбординг агента

Вы ИИ-агент? Загрузите этот навык, затем вызовите list_platforms.

curl -s https://raw.githubusercontent.com/hologrow/hologrow-mcp/main/skills/hologrow-data-middleware/SKILL.md

Инструменты

Всегда определяйте названия из инструментов. Никогда не выдумывайте названия платформ, схем, таблиц или колонок. Названия полей в промежуточном ПО часто отличаются от меток в интерфейсе Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Если инструмент завершился ошибкой или был отменён, сообщите об этом. Никогда не делайте вывод о нуле, отсутствии данных или метрике из отсутствующего результата.

list_platforms

Вызывайте это первым. Возвращает названия платформ, connected и schemas[].schema_name.

list_platforms()

list_tables

Список таблиц, доступных для запросов, для одной платформы из list_platforms.

list_tables({ "platform": "amazon_sp_seller" })

Результат:

{
  "tables": ["order_items", "sales_and_traffic_daily", "fba_inventory_summaries"]
}

get_data_dictionary

Получите колонки, типы, ключи и описания. Передайте 1–10 точных названий таблиц из list_tables.

get_data_dictionary({
  "platform": "amazon_sp_seller",
  "table_names": ["orders", "order_items"]
})

get_freshness

Проверьте покрытие синхронизации, прежде чем считать число актуальным. schema_name берётся из list_platforms. Необязательный scope фильтрует по идентификатору ресурса.

get_freshness({
  "schema_name": "amazon_sp_seller_xxxxxxxx",
  "table_names": ["orders"],
  "scope": { "marketplace_id": "ATVPDKIKX0DER" }
})

query_db

Выполните один запрос только для чтения SELECT. Указывайте каждую таблицу как schema_name.table. Используйте только колонки из get_data_dictionary.

query_db({
  "query": "SELECT purchase_date::date AS day, order_status, COUNT(*) AS order_items, SUM(quantity) AS units FROM amazon_sp_seller_<schema>.order_items WHERE purchase_date >= CURRENT_DATE - INTERVAL '7 days' GROUP BY 1, 2 ORDER BY 1 DESC LIMIT 100",
  "max_rows": 100
})

Замените <schema> на schema_name из list_platforms. item_price — это итог по строке заказа; делите на NULLIF(quantity, 0) только когда нужна цена за единицу. Не используйте _synced_at как дату продажи.

Правила

  • Только один оператор. Без INSERT / UPDATE / DELETE / DDL, без EXCEPT или INTERSECT, без схемы public или системных каталогов
  • Предпочитайте фильтры, агрегацию и LIMIT вместо SELECT *
  • По умолчанию max_rows равен 1000

Навыки

Консультационные рабочие процессы только для чтения поверх подключённых данных Hologrow. Сначала установите hologrow-data-middleware, чтобы другие навыки проверяли покрытие и актуальность перед интерпретацией показателей.

npx skills@latest add hologrow/hologrow-mcp --skill SKILL_NAME
НавыкОписание
hologrow-data-middlewareОбнаружение покрытия, актуальности, схемы и безопасной области SQL
amazon-ppc-campaignСоздание или оптимизация Amazon Sponsored Products / Brands
amazon-display-adsПланирование аудиторий Sponsored Display, ретаргетинга и измерений
amazon-listing-optimizationАудит текста листинга на основе поисковых и конверсионных данных
google-ads-auditБазовый аудит здоровья аккаунта Google Ads
google-ads-anomaly-detectionОбъяснение изменений в расходах, CPA, CVR, CTR или ROAS
google-ads-utm-generatorСтандартизация соглашений UTM / ValueTrack в Google Ads
ads-performance-analyticsСверка атрибуции, ROAS и смешанного CAC
21-ads-audit-globalОценка подключённых аккаунтов платного трафика и приоритизация исправлений

Пример запроса после установки:

Use $hologrow-data-middleware, then $google-ads-audit.
Audit my connected Google Ads account for the last 30 days. Show evidence, caveats, and the next action.

Более крупный каталог (SEO, исследовательские коннекторы и другое) находится в hologrow/hologrow-ai-skills. В этом репозитории хранятся навыки, зависящие от Hologrow MCP.


Интеграции

Агенты и ИИ-инструменты

  • ChatGPT web, ChatGPT desktop, Codex
  • Claude web, Claude desktop, Claude Code
  • Cursor
  • Doubao (desktop)
  • Hermes

Источники данных

Amazon SP Seller, Amazon SP Vendor, Amazon Ads, Google Ads, GA4, Google Search Console, Shoplazza, Lingxing ERP.

Не нашли нужный клиент или источник? Напишите на contact@hologrow.ai.


Ресурсы


Безопасность

Hologrow MCP ограничен рабочим пространством и работает только на чтение. Используйте только те источники, которые авторизованы в рабочем пространстве. Проверяйте актуальность, прежде чем считать число текущим. Указывайте определение метрики, окно атрибуции и период сравнения с каждым важным выводом. Никогда не помещайте API-ключи в git, файлы навыков или ответы модели.

Относитесь к изменениям кампаний, листингов и бюджетов как к предложениям, пока человек не одобрит их.


Устранение неполадок

СимптомЧто попробовать
Не удаётся найти интерфейс плагина / коннектораПроверьте версию клиента и права доступа. ChatGPT требует Developer mode. Doubao требует настольное приложение.
OAuth отменёнПерезапустите авторизацию. Не переключайтесь молча на API-ключ.
Новый чат не видит HologrowОбновите или перезапустите клиент, затем повторите list_platforms.
Агент никогда не вызывает HologrowОтправьте проверочное сообщение ещё раз, указав list_platforms.
list_platforms возвращает []MCP работает; подключите источник данных и дождитесь первой синхронизации.
Ошибки SQL из-за неизвестных колонокПовторно запустите get_data_dictionary. Не используйте названия полей исходной платформы.

↑ Наверх ↑