Hologrow
resmiHerhangi 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_tableskullanın. - Veri şemalarını denetleyin — Herhangi bir SQL yazmadan önce
get_data_dictionaryile sütunları, türleri ve alan anlamlarını açıklatın. - Veri güncelliğini kontrol edin — Zamana duyarlı kararlar almadan önce
get_freshnessile 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 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.
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ı
| Özellik | Açıklama |
|---|---|
| list_platforms | Hangi kaynakların bağlı olduğunu ve hangi şemaları sorgulayabileceğinizi görün |
| list_tables | Bir platform için sorgulanabilir tabloları listeleyin |
| get_data_dictionary | SQL yazmadan önce sütunlar, türler, anahtarlar ve alan açıklamaları |
| get_freshness | Senkronizasyon kapsamı ve son başarılı yenileme |
| query_db | schema_name.table üzerinde salt okunur bir SELECT |
Daha fazlası
| Özellik | Açıklama |
|---|---|
| Beceriler | Ajanınız için yeniden kullanılabilir Amazon / Google Ads analiz iş akışları |
| İstemciler | ChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes |
Hızlı Başlangıç
- connector.hologrow.ai adresinde bir çalışma alanı oluşturun.
- En az bir veri kaynağı bağlayın ve ilk senkronizasyonu bekleyin.
- 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
- ChatGPT → Ayarlar → Güvenlik ve giriş → Geliştirici modunu açın.
- Kenar çubuğu → Eklentiler → +.
- Ad:
Hologrow - Sunucu URL'si:
https://mcp.hologrow.ai/mcp - Kimlik doğrulama:
OAuth
- Ad:
- Hologrow ile oturum açın seçeneğine tıklayın ve erişime izin verin.
ChatGPT masaüstü / Codex
- Ayarlar → Eklentiler → MCP sunucusu ekle.
- Ad:
Hologrow. Tür: Streamable HTTP. URL:https://mcp.hologrow.ai/mcp. - Kimlik doğrula seçeneğine tıklayın ve yetkilendirmeyi tamamlayın.
Claude web / masaüstü
- Ayarlar → Özelleştir → Bağlayıcılar → Özel bağlayıcı ekle.
- Ad:
Hologrow. Uzak MCP sunucu URL'si:https://mcp.hologrow.ai/mcp. - Oturum açın ve Erişime izin ver seçeneğine tıklayın.
Doubao masaüstü (yalnızca masaüstü uygulaması)
- Beceriler · Bağlayıcılar · Ortaklar → Yeni özel bağlayıcı.
- Ad:
Hologrow. Taşıma: HTTP. URL:https://mcp.hologrow.ai/mcp. Başlıkları boş bırakın. - 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_platforms | Kullanılabilir veri platformlarını, bağlantı durumunu ve şema adlarını keşfedin. Önce bunu çağırın. |
list_tables | list_platforms tarafından döndürülen tam bir platform için sorgulanabilir tabloları listeleyin. |
get_data_dictionary | list_tables kaynağından 1 ila 10 tam tablo adı için sütunları, türleri, anahtarları ve alan anlamlarını inceleyin. |
get_freshness | Senkronizasyon 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_db | schema_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,EXCEPTveyaINTERSECTyok,publicşeması veya sistem katalogları yok SELECT *yerine filtreleri, toplamayı veLIMITkullanmayı tercih edin- Varsayılan
max_rowsdeğ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
| Beceri | Açıklama |
|---|---|
hologrow-data-middleware | Kapsamı, tazeliği, şemayı ve güvenli SQL kapsamını keşfedin |
amazon-ppc-campaign | Amazon Sponsored Products / Brands oluşturun veya optimize edin |
amazon-display-ads | Sponsored Display kitlelerini, yeniden hedeflemeyi ve ölçümü planlayın |
amazon-listing-optimization | Liste metnini arama ve dönüşüm kanıtlarına karşı denetleyin |
google-ads-audit | Google Ads hesap sağlığını temel alın |
google-ads-anomaly-detection | Harcama, CPA, CVR, CTR veya ROAS değişimini açıklayın |
google-ads-utm-generator | Google Ads UTM / ValueTrack kurallarını standartlaştırın |
ads-performance-analytics | Atıf, ROAS ve harmanlanmış CAC'yi mutabakat edin |
21-ads-audit-global | Bağ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
| Belirti | Denenecekler |
|---|---|
| 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 edildi | Yetkilendirmeyi 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ıyor | Doğrulama mesajını list_platforms adını vererek tekrar gönderin. |
list_platforms [] döndürüyor | MCP ç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. |