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. - Sorgulanabilir tabloları inceleyin — Amazon SP Seller veya Google Ads gibi bir platform için mevcut tabloları görmek üzere
list_tableskullanın. - Tablo şemalarını denetleyin — SQL yazmadan önce sütunları, türleri, anahtarları ve alan açıklamalarını almak için tam tablo adlarıyla
get_data_dictionaryçağırın. - Veri güncelliğini kontrol edin — Herhangi bir sayıya güvenmeden önce senkronizasyon kapsamını ve son başarılı yenilemeyi doğrulamak için
get_freshnesskullanın. - Salt okunur SQL sorguları çalıştırın — Ticaret verilerini geri yazmadan analiz etmek için
schema_name.tableüzerinde birquery_dbSELECT ifadesi isteyin. - Analiz becerilerini yükleyin — Rehberli, salt okunur analiz için
npx skills@latestaracılığıylaamazon-ppc-campaignveyagoogle-ads-auditgibi iş akışlarını ekleyin.
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 bu verileri sorgulamasına olanak tanır.
mcp.hologrow.ai adresinde barındırılır. Konsol: connector.hologrow.ai. Dokümantasyon: 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 asla reklam hesaplarına veya mağazalara 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 | Tek 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 tek bir SELECT çalıştırın |
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 kaydı
Bir AI ajanı mısınız? Bu beceriyi alın, 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
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 çıkarmayın.
list_platforms
Önce bunu çağırın. Platform adlarını, connected ve schemas[].schema_name döndürür.
list_platforms()
list_tables
list_platforms bölümünden tek bir platform için sorgulanabilir tabloları listeleyin.
list_tables({ "platform": "amazon_sp_seller" })
Çıktı:
{
"tables": ["order_items", "sales_and_traffic_daily", "fba_inventory_summaries"]
}
get_data_dictionary
Sütunları, türleri, anahtarları ve açıklamaları alın. list_tables bölümünden 1–10 tam tablo adı iletin.
get_data_dictionary({
"platform": "amazon_sp_seller",
"table_names": ["orders", "order_items"]
})
get_freshness
Bir sayıyı güncel kabul etmeden önce senkronizasyon kapsamını kontrol edin. schema_name, list_platforms bölümünden gelir. İsteğe bağlı scope, kaynak kimliğine göre filtreler.
get_freshness({
"schema_name": "amazon_sp_seller_xxxxxxxx",
"table_names": ["orders"],
"scope": { "marketplace_id": "ATVPDKIKX0DER" }
})
query_db
Salt okunur tek bir SELECT çalıştırın. Her tabloyu schema_name.table olarak niteleyin. Yalnızca get_data_dictionary bölümündeki sütunları 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 bölümündeki 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 ifade.
INSERT/UPDATE/DELETE/ DDL yok,EXCEPTveyaINTERSECTyok,publicşeması veya sistem katalogları yok SELECT *yerine filtreleri, toplamayı veLIMITtercih edin- Varsayılan
max_rows1000'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 pazarlamayı 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ı) hologram/hologrow-ai-skills içinde yaşar. 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 Tedarikçi, Amazon Ads, Google Ads, GA4, Google Search Console, Shoplazza, Lingxing ERP.
En sevdiğiniz istemci veya kaynak eksik mi? contact@hologrow.ai adresine e-posta gönderin.
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 kabul etmeden ö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'e, beceri dosyalarına veya model yanıtlarına koymayın.
Kampanya, liste ve bütçe değişikliklerini bir insan onaylayana kadar öneri olarak değerlendirin.
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 API anahtarına geçmeyin. |
| Yeni sohbet Hologrow'u görmüyor | İstemciyi yenileyin veya yeniden başlatın, ardından list_platforms yeniden 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. |