Hologrow

Hologrow MCP

面向 AI 的商业数据层。 一次性连接 Amazon、Google Ads、GA4 和其他销售系统。Hologrow 会持续同步数据，然后 MCP 让 Claude、Cursor、Codex、ChatGPT 和其他 Agent 查询数据，无需导出 CSV 或编写一次性 API 脚本。

托管于 mcp.hologrow.ai。控制台位于 connector.hologrow.ai。文档位于 docs.hologrow.ai。

为什么选择 Hologrow？

• 适配你已在使用的工具：连接一次，即可在 Claude、Cursor、Codex、ChatGPT、豆包或 Hermes 中提问
• 适用于大模型的商业数据：为 Amazon SP、Amazon Ads、Google Ads、GA4、Search Console、Shoplazza 和 Lingxing ERP 提供稳定的表
• 复杂工作交给我们处理：平台 OAuth、同步、数据新鲜度和架构均由我们负责，Agent 只需读取
• 默认只读：MCP 不会写回广告账户或网店
• 为 Agent 做好准备：提供五种发现工具和分析技能，可通过一条命令安装

功能概览

MCP 工具

更多

快速开始

1. 在 connector.hologrow.ai 创建工作区。
2. 至少连接一个数据源，并等待首次同步完成。
3. 将 Hologrow MCP 添加到你的 Agent。OAuth 客户端可在界面中授权。Cursor / Claude Code / Hermes 使用 AI Platforms → Advanced settings 中的 API 密钥。

创建 API 密钥还不够。Agent 能够调用 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 已安装——只是工作区尚未连接任何数据源。

为你的 Agent 提供强大支持

只需几分钟，即可将 Hologrow 连接到任何 AI Agent。

技能

为你的 Agent 提供查询工作流以及 Amazon / Google Ads 使用手册。

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

安装后重启 Agent。适用于 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

Agent 入门指引

你是 AI Agent 吗？获取此技能，然后调用 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

发现用户可用的数据平台、连接状态和架构名称。在入门设置时，以及相关平台或架构未知时使用。返回平台信息以及供后续工具和 SQL 使用的 schemas[].schema_name。

list_platforms()

list_tables

列出 list_platforms 返回的指定平台中可查询的表。在检查字段或编写 SQL 之前，使用此工具查找与用户问题相关的表。返回供 get_data_dictionary、get_freshness 和 query_db 使用的精确表名；切勿臆造表名。

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

输出：

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

get_data_dictionary

检查 list_tables 返回的 1 到 10 个指定表的列、类型、键和字段含义。编写 SQL 前请先使用此工具。这些名称可能与源平台 API 或报表字段不同；请仅使用返回的名称。

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

get_freshness

在得出时效性结论前，检查同步覆盖范围和数据新鲜度。schema_name 必须来自 list_platforms 的 schemas[].schema_name；提供 1 到 50 个来自 list_tables 的精确表名。可选的 scope 用于按资源标识进行筛选，例如 {"marketplace_id": "ATVPDKIKX0DER"}。

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

query_db

在发现相关架构、表和列后，使用一条只读 SQL SELECT 回答具体的数据问题。每个表都必须使用 schema_name.table 完整限定，并且只能使用 list_platforms、list_tables 和 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 架构或系统目录
• 优先使用筛选、聚合和 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 的技能。

集成

Agent 和 AI 工具

• ChatGPT 网页版、ChatGPT 桌面版、Codex
• Claude 网页版、Claude 桌面版、Claude Code
• Cursor
• 豆包（桌面版）
• Hermes

数据源

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

资源

• 文档
• 产品
• 控制台
• MCP 端点
• 技能目录

安全

Hologrow MCP 采用租户范围限制，且为只读。仅使用工作区已授权的数据源。在将某个数字视为当前数据前，先检查数据新鲜度。每项重要结论都应说明指标定义、归因窗口和比较周期。切勿将 API 密钥放入 git、技能文件或模型回复中。

将广告系列、商品详情和预算变更视为提案，直到获得人工批准。

故障排查

↑ 返回顶部 ↑