Hologrow

Hologrow MCP

Lớp dữ liệu thương mại cho AI. Kết nối Amazon, Google Ads, GA4 và các hệ thống bán hàng khác một lần. Hologrow giữ dữ liệu đồng bộ, sau đó MCP cho phép Claude, Cursor, Codex, ChatGPT và các agent khác truy vấn — không cần xuất CSV hay viết script API riêng lẻ.

Được lưu trữ tại mcp.hologrow.ai. Bảng điều khiển tại connector.hologrow.ai. Tài liệu tại docs.hologrow.ai.

Tại sao chọn Hologrow?

• Được xây dựng cho các công cụ bạn đang dùng: Kết nối một lần, sau đó đặt câu hỏi trong Claude, Cursor, Codex, ChatGPT, Doubao hoặc Hermes
• Dữ liệu thương mại sẵn sàng cho LLM: Các bảng ổn định cho Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza và Lingxing ERP
• Chúng tôi xử lý phần khó: OAuth nền tảng, đồng bộ, độ tươi và schema — agent chỉ đọc
• Chỉ đọc theo mặc định: MCP không bao giờ ghi ngược về tài khoản quảng cáo hoặc cửa hàng
• Sẵn sàng cho agent: Năm công cụ khám phá cùng các kỹ năng phân tích bạn có thể cài đặt bằng một lệnh

Tổng quan tính năng

Công cụ MCP

Thêm

Bắt đầu nhanh

1. Tạo workspace tại connector.hologrow.ai.
2. Kết nối ít nhất một nguồn dữ liệu và chờ lần đồng bộ đầu tiên.
3. Thêm Hologrow MCP vào agent của bạn. OAuth clients xác thực trong giao diện. Cursor / Claude Code / Hermes dùng API key từ AI Platforms → Advanced settings.

Chỉ tạo API key là chưa đủ. Cài đặt thành công khi agent có thể gọi list_platforms.

MCP

Kết nối bất kỳ client tương thích MCP nào. Giao thức truyền tải là 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.

Xác minh

Bắt đầu một cuộc trò chuyện mới và gửi:

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

Kết quả:

{
  "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": []
    }
  ]
}

Danh sách trống vẫn có nghĩa là MCP đã được cài đặt — workspace chỉ chưa có nguồn nào được kết nối.

Trao quyền cho Agent của bạn

Kết nối Hologrow với bất kỳ agent AI nào trong vài phút.

Skill

Cung cấp cho agent quy trình truy vấn và các playbook Amazon / Google Ads.

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

Khởi động lại agent sau khi cài đặt. Hoạt động với Claude Code, Cursor, Codex và các client tương thích skills khác.

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

Onboarding agent

Bạn là agent AI? Tải skill này, sau đó gọi list_platforms.

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

Công cụ

Luôn khám phá tên từ các công cụ. Không bao giờ tự đặt tên nền tảng, schema, bảng hoặc cột. Tên trường middleware thường khác với nhãn giao diện Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Nếu một công cụ thất bại hoặc bị hủy, hãy nói rõ. Không bao giờ suy luận số không, không có dữ liệu hoặc một chỉ số từ kết quả bị thiếu.

list_platforms

Gọi công cụ này trước tiên. Trả về tên nền tảng, connected và schemas[].schema_name.

list_platforms()

list_tables

Liệt kê các bảng có thể truy vấn cho một nền tảng từ list_platforms.

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

Kết quả:

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

get_data_dictionary

Lấy cột, kiểu dữ liệu, khóa và mô tả. Truyền 1–10 tên bảng chính xác từ list_tables.

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

get_freshness

Kiểm tra phạm vi đồng bộ trước khi coi một con số là hiện tại. schema_name đến từ list_platforms. scope tùy chọn lọc theo danh tính tài nguyên.

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

query_db

Chạy một SELECT chỉ đọc. Định dạng mọi bảng là schema_name.table. Chỉ dùng các cột từ 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
})

Thay thế <schema> bằng schema_name từ list_platforms. item_price là tổng dòng đơn hàng; chia cho NULLIF(quantity, 0) chỉ khi bạn cần giá mỗi đơn vị. Không dùng _synced_at làm ngày bán hàng.

Quy tắc

• Chỉ một câu lệnh. Không INSERT / UPDATE / DELETE / DDL, không EXCEPT hoặc INTERSECT, không schema public hoặc system catalogs
• Ưu tiên bộ lọc, tổng hợp và LIMIT hơn SELECT *
• max_rows mặc định là 1000

Skills

Quy trình tư vấn, chỉ đọc trên dữ liệu Hologrow đã kết nối. Cài đặt hologrow-data-middleware trước để các skill khác kiểm tra phạm vi và độ tươi trước khi diễn giải hiệu suất.

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

Ví dụ lời nhắc sau khi cài đặt:

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.

Một danh mục lớn hơn (SEO, research connectors và nhiều hơn) nằm tại hologrow/hologrow-ai-skills. Kho này giữ các skill phụ thuộc vào Hologrow MCP.

Tích hợp

Agent & công cụ AI

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

Nguồn dữ liệu

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

Tài nguyên

• Tài liệu
• Sản phẩm
• Bảng điều khiển
• MCP endpoint
• Danh mục skills

An toàn

Hologrow MCP được giới hạn theo tenant và chỉ đọc. Chỉ dùng các nguồn mà workspace đã ủy quyền. Kiểm tra độ tươi trước khi coi một con số là hiện tại. Nêu định nghĩa chỉ số, cửa sổ attribution và khoảng thời gian so sánh với mọi kết luận quan trọng. Không bao giờ đưa API key vào git, tệp skill hoặc phản hồi của mô hình.

Coi các thay đổi về chiến dịch, listing và ngân sách là đề xuất cho đến khi con người phê duyệt.

Khắc phục sự cố

↑ Lên đầu trang ↑