Hologrow

Hologrow MCP

AI 的商業資料層。 一次連接 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、同步、新鮮度和 schema——代理程式只需讀取
• 預設唯讀：MCP 絕不寫回廣告帳戶或商店前台
• 代理程式就緒：五個探索工具，加上可用單一指令安裝的分析技能

功能總覽

MCP 工具

更多

快速開始

1. 在 connector.hologrow.ai 建立工作區。
2. 連接至少一個資料來源，並等待首次同步。
3. 將 Hologrow MCP 新增至你的代理程式。OAuth 用戶端在 UI 中授權。Cursor / Claude Code / Hermes 使用 AI 平台 → 進階設定 中的 API 金鑰。

僅建立 API 金鑰是不夠的。當代理程式能呼叫 list_platforms 時，安裝才算成功。

MCP

連接任何相容 MCP 的用戶端。傳輸方式為 Streamable HTTP。

{
  "mcpServers": {
    "Hologrow": {
      "url": "https://mcp.hologrow.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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 連接到任何 AI 代理程式。

技能

為你的代理程式提供查詢工作流程及 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

代理程式入門

你是 AI 代理程式嗎？取得此技能，然後呼叫 list_platforms。

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

工具

務必從工具中探索名稱。絕不自行臆造平台、schema、資料表或欄位名稱。中介軟體欄位名稱通常與 Amazon / Google UI 標籤不同。

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

取得欄位、型別、鍵和說明。從 list_tables 傳入 1–10 個精確的資料表名稱。

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> 替換為 list_platforms 中的 schema_name。item_price 是訂單明細總額；僅在需要單價時除以 NULLIF(quantity, 0)。不要使用 _synced_at 作為銷售日期。

規則

• 僅限單一陳述式。不允許 INSERT / UPDATE / DELETE / DDL，不允許 EXCEPT 或 INTERSECT，不允許 public schema 或系統目錄
• 優先使用篩選、聚合和 LIMIT，而非 SELECT *
• 預設 max_rows 為 1000

技能

基於已連接 Hologrow 資料的建議性、唯讀工作流程。先安裝 hologrow-data-middleware，讓其他技能在解讀成效前先檢查涵蓋範圍和資料新鮮度。

npx skills@latest add hologrow/hologrow-mcp --skill SKILL_NAME

安裝後的範例提示：

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 的技能。

整合

代理程式與 AI 工具

• ChatGPT 網頁版、ChatGPT 桌面版、Codex
• Claude 網頁版、Claude 桌面版、Claude Code
• Cursor
• Doubao（桌面版）
• Hermes

資料來源

Amazon SP Seller、Amazon SP Vendor、Amazon Ads、Google Ads、GA4、Google Search Console、Shoplazza、Lingxing ERP。

缺少你喜愛的用戶端或來源？寄信至 contact@hologrow.ai。

資源

• 文件
• 產品
• 控制台
• MCP 端點
• 技能目錄

安全

Hologrow MCP 為租戶隔離且唯讀。僅使用工作區已授權的來源。在將數字視為最新資料前，先檢查新鮮度。每個重要結論都必須說明指標定義、歸因窗口和比較期間。絕不將 API 金鑰放入 git、技能檔案或模型回覆中。

將廣告活動、商品文案和預算變更視為提案，直到人類核准為止。

疑難排解

↑ 回到頂端 ↑