Hologrow

resmi

Herhangi bir yapay zeka için e-ticaret veri katmanı

Hologrow MCP ile neler yapabilirsiniz?

  • Bağlı platformları keşfedin — Asistanınızdan list_platforms çağırmasını isteyerek hangi veri kaynaklarının bağlı olduğunu ve şema adlarını görün.
  • Mevcut tabloları inceleyin — Amazon veya Google Ads gibi belirli bir platform için sorgulanabilir tabloları bulmak üzere list_tables kullanın.
  • Veri şemalarını denetleyin — Herhangi bir SQL yazmadan önce get_data_dictionary ile sütunları, türleri ve alan anlamlarını açıklatın.
  • Veri güncelliğini kontrol edin — Zamana duyarlı kararlar almadan önce get_freshness ile senkronizasyon kapsamını ve son yenilemeyi doğrulayın.
  • Salt okunur sorgular çalıştırın — Senkronize edilmiş ticaret verilerinize karşı güvenli, salt okunur SQL ile iş sorularını yanıtlamak için query_db'ye sorun.

Dokümantasyon

Hologrow


Hologrow MCP

Yapay zeka için ticaret veri katmanı. Amazon, Google Ads, GA4 ve diğer satış sistemlerini bir kez bağlayın. Hologrow verileri senkronize tutar, ardından MCP, Claude, Cursor, Codex, ChatGPT ve diğer ajanların CSV dışa aktarımları veya tek seferlik API betikleri olmadan sorgulamasına olanak tanır.

mcp.hologrow.ai adresinde barındırılır. Konsol: connector.hologrow.ai. Dokümanlar: docs.hologrow.ai.

Hologrow connects commerce data sources to AI agents


Neden Hologrow?

  • Zaten kullandığınız araçlar için tasarlandı: Bir kez bağlanın, ardından Claude, Cursor, Codex, ChatGPT, Doubao veya Hermes'te sorular sorun
  • LLM uyumlu ticaret verileri: Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza ve Lingxing ERP için kararlı tablolar
  • Zor kısımları biz hallederiz: Platform OAuth, senkronizasyon, tazelik ve şema — ajanlar yalnızca okur
  • Varsayılan olarak salt okunur: MCP, reklam hesaplarına veya mağaza vitrinlerine asla geri yazmaz
  • Ajana hazır: Beş keşif aracı ve tek komutla yükleyebileceğiniz analiz becerileri

Özellik Genel Bakışı

MCP araçları

ÖzellikAçıklama
list_platformsHangi kaynakların bağlı olduğunu ve hangi şemaları sorgulayabileceğinizi görün
list_tablesBir platform için sorgulanabilir tabloları listeleyin
get_data_dictionarySQL yazmadan önce sütunlar, türler, anahtarlar ve alan açıklamaları
get_freshnessSenkronizasyon kapsamı ve son başarılı yenileme
query_dbschema_name.table üzerinde salt okunur bir SELECT

Daha fazlası

ÖzellikAçıklama
BecerilerAjanınız için yeniden kullanılabilir Amazon / Google Ads analiz iş akışları
İstemcilerChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes

Hızlı Başlangıç

  1. connector.hologrow.ai adresinde bir çalışma alanı oluşturun.
  2. En az bir veri kaynağı bağlayın ve ilk senkronizasyonu bekleyin.
  3. Ajanınıza Hologrow MCP ekleyin. OAuth istemcileri arayüzde yetki verir. Cursor / Claude Code / Hermes, AI Platformları → Gelişmiş ayarlar bölümünden bir API anahtarı kullanır.

API anahtarı oluşturmak yeterli değildir. Kurulum, ajan list_platforms çağırabildiğinde başarılı olur.

MCP

MCP uyumlu herhangi bir istemciyi bağlayın. Taşıma protokolü Streamable HTTP'dir.

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

ChatGPT web

  1. ChatGPT → Ayarlar → Güvenlik ve giriş → Geliştirici modunu açın.
  2. Kenar çubuğu → Eklentiler → +.
    • Ad: Hologrow
    • Sunucu URL'si: https://mcp.hologrow.ai/mcp
    • Kimlik doğrulama: OAuth
  3. Hologrow ile oturum açın seçeneğine tıklayın ve erişime izin verin.

ChatGPT masaüstü / Codex

  1. Ayarlar → Eklentiler → MCP sunucusu ekle.
  2. Ad: Hologrow. Tür: Streamable HTTP. URL: https://mcp.hologrow.ai/mcp.
  3. Kimlik doğrula seçeneğine tıklayın ve yetkilendirmeyi tamamlayın.

Claude web / masaüstü

  1. Ayarlar → Özelleştir → Bağlayıcılar → Özel bağlayıcı ekle.
  2. Ad: Hologrow. Uzak MCP sunucu URL'si: https://mcp.hologrow.ai/mcp.
  3. Oturum açın ve Erişime izin ver seçeneğine tıklayın.

Doubao masaüstü (yalnızca masaüstü uygulaması)

  1. Beceriler · Bağlayıcılar · Ortaklar → Yeni özel bağlayıcı.
  2. Ad: Hologrow. Taşıma: HTTP. URL: https://mcp.hologrow.ai/mcp. Başlıkları boş bırakın.
  3. Yetki ver seçeneğine tıklayın ve erişime izin verin.
Cursor / Claude Code / Hermes (API anahtarı)

Konsoldan bir API anahtarı kopyalayın, ardından bu istemi yeni bir Ajan sohbetine gönderin. {apiKey} değerini değiştirin. Ajandan anahtarı yankılamasını istemeyin.

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.

Doğrulama

Yeni bir sohbet başlatın ve şunu gönderin:

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

Çıktı:

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

Boş bir liste yine de MCP'nin kurulu olduğu anlamına gelir — çalışma alanında henüz bağlı bir kaynak yoktur.


Ajanınızı Güçlendirin

Hologrow'u dakikalar içinde herhangi bir AI ajanına bağlayın.

Beceri

Ajanınıza sorgu iş akışını ve Amazon / Google Ads oyun kitaplarını verin.

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

Kurulumdan sonra ajanı yeniden başlatın. Claude Code, Cursor, Codex ve beceri uyumlu diğer istemcilerle çalışır.

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

Ajan katılımı

Bir AI ajanı mısınız? Bu beceriyi getirin, ardından list_platforms çağırın.

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

Araçlar

AraçAçıklama
list_platformsKullanılabilir veri platformlarını, bağlantı durumunu ve şema adlarını keşfedin. Önce bunu çağırın.
list_tableslist_platforms tarafından döndürülen tam bir platform için sorgulanabilir tabloları listeleyin.
get_data_dictionarylist_tables kaynağından 1 ila 10 tam tablo adı için sütunları, türleri, anahtarları ve alan anlamlarını inceleyin.
get_freshnessSenkronizasyon kapsamını ve tazeliğini kontrol edin. schema_name, list_platforms kaynağından gelir; list_tables kaynağından 1 ila 50 tablo adı iletin.
query_dbschema_name.table üzerinde salt okunur bir SQL SELECT ile bir veri sorusunu yanıtlayın.

Adları her zaman araçlardan keşfedin. Platform, şema, tablo veya sütun adlarını asla uydurmayın. Aracı yazılım alan adları genellikle Amazon / Google arayüz etiketlerinden farklıdır.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Bir araç başarısız olursa veya iptal edilirse, bunu belirtin. Eksik bir sonuçtan asla sıfır, veri yok veya bir metrik çıkarımı yapmayın.

list_platforms

Kullanıcının kullanılabilir veri platformlarını, bağlantı durumunu ve şema adlarını keşfedin. Katılım sırasında ve ilgili platform veya şema bilinmediğinde kullanın. Platformu ve sonraki araçlar ve SQL için schemas[].schema_name değerini döndürür.

list_platforms()

list_tables

list_platforms tarafından döndürülen tam bir platform için sorgulanabilir tabloları listeleyin. Alanları incelemeden veya SQL yazmadan önce kullanıcının sorusuyla ilgili tabloları bulmak için kullanın. get_data_dictionary, get_freshness ve query_db için tam tablo adlarını döndürür; tablo adlarını asla uydurmayın.

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

Çıktı:

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

get_data_dictionary

list_tables tarafından döndürülen 1 ila 10 tam tablo adı için sütunları, türleri, anahtarları ve alan anlamlarını inceleyin. SQL yazmadan önce kullanın. Bu adlar kaynak platform API veya rapor alanlarından farklı olabilir; yalnızca döndürülen adları kullanın.

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

get_freshness

Zamana duyarlı sonuçlar çıkarmadan önce senkronizasyon kapsamını ve tazeliğini kontrol edin. schema_name, list_platforms schemas[].schema_name kaynağından gelmelidir; list_tables kaynağından 1 ila 50 tam tablo adı sağlayın. İsteğe bağlı scope, kaynak kimliğine göre filtreler, örneğin {"marketplace_id": "ATVPDKIKX0DER"}.

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

query_db

İlgili şemayı, tabloları ve sütunları keşfettikten sonra somut bir veri sorusunu salt okunur bir SQL SELECT ile yanıtlayın. Her tabloyu schema_name.table olarak tam nitelendirin ve yalnızca list_platforms, list_tables ve get_data_dictionary tarafından döndürülen tanımlayıcıları kullanın.

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> değerini list_platforms kaynağından schema_name ile değiştirin. item_price sipariş satırı toplamıdır; yalnızca birim fiyat gerektiğinde NULLIF(quantity, 0) ile bölün. _synced_at değerini satış tarihi olarak kullanmayın.

Kurallar

  • Yalnızca tek bir ifade. INSERT / UPDATE / DELETE / DDL yok, EXCEPT veya INTERSECT yok, public şeması veya sistem katalogları yok
  • SELECT * yerine filtreleri, toplamayı ve LIMIT kullanmayı tercih edin
  • Varsayılan max_rows değeri 1000'dir

Beceriler

Bağlı Hologrow verileri üzerinde danışmanlık, salt okunur iş akışları. Diğer becerilerin performansı yorumlamadan önce kapsamı ve tazeliği kontrol etmesi için önce hologrow-data-middleware yükleyin.

npx skills@latest add hologrow/hologrow-mcp --skill SKILL_NAME
BeceriAçıklama
hologrow-data-middlewareKapsamı, tazeliği, şemayı ve güvenli SQL kapsamını keşfedin
amazon-ppc-campaignAmazon Sponsored Products / Brands oluşturun veya optimize edin
amazon-display-adsSponsored Display kitlelerini, yeniden hedeflemeyi ve ölçümü planlayın
amazon-listing-optimizationListe metnini arama ve dönüşüm kanıtlarına karşı denetleyin
google-ads-auditGoogle Ads hesap sağlığını temel alın
google-ads-anomaly-detectionHarcama, CPA, CVR, CTR veya ROAS değişimini açıklayın
google-ads-utm-generatorGoogle Ads UTM / ValueTrack kurallarını standartlaştırın
ads-performance-analyticsAtıf, ROAS ve harmanlanmış CAC'yi mutabakat edin
21-ads-audit-globalBağlı ücretli medya hesaplarını puanlayın ve düzeltmeleri önceliklendirin

Kurulumdan sonra örnek istem:

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.

Daha büyük bir katalog (SEO, araştırma bağlayıcıları ve daha fazlası) hologrow/hologrow-ai-skills deposunda bulunur. Bu depo, Hologrow MCP'ye bağlı becerileri tutar.


Entegrasyonlar

Ajanlar ve AI araçları

  • ChatGPT web, ChatGPT masaüstü, Codex
  • Claude web, Claude masaüstü, Claude Code
  • Cursor
  • Doubao (masaüstü)
  • Hermes

Veri kaynakları

Amazon SP Satıcı, Amazon SP Satıcı, Amazon Ads, Google Ads, GA4, Google Search Console, Shoplazza, Lingxing ERP.


Kaynaklar


Güvenlik

Hologrow MCP, kiracı kapsamlı ve salt okunurdur. Yalnızca çalışma alanının yetki verdiği kaynakları kullanın. Bir sayıyı güncel olarak ele almadan önce tazeliği kontrol edin. Her önemli sonuçla birlikte metrik tanımını, atıf penceresini ve karşılaştırma dönemini belirtin. API anahtarlarını asla git, beceri dosyaları veya model yanıtlarına koymayın.

Kampanya, liste ve bütçe değişikliklerini bir insan onaylayana kadar öneri olarak ele alın.


Sorun Giderme

BelirtiDenenecekler
Eklenti / bağlayıcı arayüzü bulunamıyorİstemci sürümünü ve izinleri doğrulayın. ChatGPT Geliştirici modu gerektirir. Doubao masaüstü uygulaması gerektirir.
OAuth iptal edildiYetkilendirmeyi yeniden başlatın. Sessizce bir API anahtarına geçmeyin.
Yeni sohbet Hologrow'u görmüyorİstemciyi yenileyin veya yeniden başlatın, ardından list_platforms tekrar deneyin.
Ajan Hologrow'u asla çağırmıyorDoğrulama mesajını list_platforms adını vererek tekrar gönderin.
list_platforms [] döndürüyorMCP çalışıyor; bir veri kaynağı bağlayın ve ilk senkronizasyonu bekleyin.
Bilinmeyen sütunlarda SQL hatalarıget_data_dictionary yeniden çalıştırın. Kaynak platform alan adlarını yeniden kullanmayın.

↑ Başa dön ↑