Ajanlar ve geliştiriciler için

Markanız, terminalinizden

Kanıtı, bir sonraki değişikliği ve onu doğrulamanın yolunu alın. Mentionry ile aynı kaydedilmiş SEO ve GEO analizi, bir CLI, HTTP API veya MCP istemcisi aracılığıyla.

Kaydedilmiş okumalar / API anahtarı erişimi / Okuma başına ücretli yenileme yok

Bir aracı, kontrol panosuna gitmeden Mentionry kullanabilir mi?

Evet. Bir API anahtarı oluşturduktan sonra, marka sonuçlarını, sayfaları, anahtar kelimeleri, bağlantıları ve eyleme geçirilebilir SEO/GEO bulgularını incelemek için CLI'yi, salt okunur HTTP uç noktasını veya kaydedilmiş veri MCP araçlarını kullanın. İlk kimlik bilgisi oluşturma hala Geliştiriciler'i kullanır. Bir okuma, bir web sitesi değişikliğini uygulamaz veya yeni sağlayıcı verisi toplamaz.

Terminalinizde başlayın

Bağımlılık içermeyen CLI'yi indirin, inceleyin ve API anahtarınızı ortamda ayarlayın. Gerçek bir anahtarı paylaşılan istemlere yapıştırmayın veya bir depoya işlemeyin. JSON varsayılan çıktıdır; okunabilir bir eylem planı için Markdown kullanın.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

Sahip olunan bir marka için --workspace Kimliğini, nextOffset'i takip etmek için --limit 1..100 ve --offset N'yi kullanın. --area SEO, GEO veya her ikisini kullanın. Kısa komut tek bir sayfayı ve eylemlerini okur; içerik oluşturmaz veya yayınlamaz.

Bir MCP istemcisi bağlayın

Streamable HTTP 2025-06-18 veya 2025-11-25 protokolünü taşıyıcı başlıklarla destekleyen bir istemci kullanın. Bu bir yapılandırma örneğidir; istemcinizin kendi gizli depolama sözdizimi olabilir.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

Başlangıç olarak read_brand_overview, ardından read_actionable_insights. Seçilen URL için read_page_insights kullanın. Eski araştırmalar ve aracı araçları, araçlar/liste aracılığıyla kullanılabilir ve kendi kotalarını korur; CLI ayrıca açıkça istenen hazırlık işlerini de destekler.

Sözleşmeyi keşfedin ve bir örnek deneyin

Kullan OpenAPI HTTP entegrasyonu için, aracı iş akışı uygulama ve doğrulama için veya hayali bir örnek hesap olmadan. Ücretli planlar, kaydedilmiş SEO/GEO verilerini mevcut kapsama alanlarında sunar. Ücretsiz örnekler herhangi bir sağlayıcı çalışması tetiklemez. Mevcut izinler için yetenekleri okuyun; toplama zamanlanmıştır ve kontrol paneli bütçesini paylaşır. Sonuçlar, markanızı adlandıran soruları markasız keşif sorularından ayırır. Çalışma, kaydedilmiş önerilen kopyayı ve kaynak pasajları döndürür; geçmiş, tarihlendirilmiş veritabanı sıralama örneklerini döndürür, pazarlar korunur. Taslaklar editoryal inceleme gerektirir ve asla otomatik olarak dağıtılmış olarak işaretlenmez.

Bir aracı aracılığıyla iş hazırlayın

Uygun kaydedilmiş bir eylem kimliği almak için eylemleri okuyun, ardından bir değişmezlik anahtarıyla hazırlamayı gönderin. Döndürülen iş kimliğini yoklayın. Aynı anahtarı yeniden denemek aynı işi döndürür; bir yanıtın süresi doldu diye yeni bir anahtar oluşturmayın. Hazırlık, taslak ve sağlayıcı izinlerinizi paylaşır, istek başına bir sağlayıcı denemesi ve $0.02 planlanmış maksimum ile. Mevcut tamamlanmış taslaklar yeniden kullanılır. Kuyruğa alınmış işler iptal edilebilir; çalışan iptali geri ödeme veya bir yapıtın kaldırılmasını garanti edemez. Hiçbir şey bir müşteri sayfasını yayınlamaz veya erişim göndermez.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP: hazırlama/iptal için POST /api/v1/jobs, durum için GET /api/v1/jobs?jobId=ID. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Oluşturma, kuyruk/gün sınırlarına ve mevcut hak kontrolüne sahiptir. Değişmezlik kayıtları 90 gün boyunca saklanır. Durum okumaları asla bir işi yürütmez.

Uygulanan sayfa değişikliklerini doğrulayın

Gözden geçirilmiş bir taslağı uyguladıktan sonra, belge kimliğini, gerçek uygulanan zaman damgasını ve kararlı bir değişmezlik anahtarını kaydedin. Mentionry orijinal genel sayfayı otomatik olarak kontrol eder. Bu, beyanınızı ve gözlemlenen HTML'yi ayrı ayrı kaydeder; sıralama artışını yayınlamaz veya kanıtlamaz. GET durumu asla bir kontrol başlatmaz.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP: /api/v1/deployments. MCP: record_page_deployment ve read_page_deployments. Paylaşılan bekleyen ve günlük sınırlar geçerlidir; ücretli sağlayıcı çağrısı yok.

Zamanlanmış arama kanıtlarını okuyun

Kampanya veya read_live_search_campaign kullanarak kaydedilmiş Google masaüstü kontrolleri, veritabanı anahtar kelime önerileri ve sonuç-kesişim grupları için. Ülke, dil, zaman damgaları ve döndürülen derinlik açık kalır. Eksik sonuçlar bilinmiyor, sıralama sıfır değil. Hedefler markalar arasında tek bir sahip izni paylaşır: Lite haftada 10'e kadar, Growth günde 30, Ajans günde 75, mevcut sağlayıcı bütçesine tabi olarak. Ücretsiz, kalıcı bir kaydedilmiş örnek içerir, günde 20 kaydedilmiş API okuması ve yinelenen toplama yok. Kampanyayı okumak onu asla yenilemez.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

Kaydedilmiş veri araçları

MCP aracıNe döndürür
read_latest_answer_reviewsSahip olunan markaya ait bir atıf incelemesi gerektiren kaydedilmiş son cevap yürütmeleri, motor, kaydedilen bölge/tarih, gerçek rakip markalar, alıntı, alıntılar ve kaynak temelli bir inceleme görevi ile birlikte. Son yedi gün; marka başına taranan soru/motor/bölge/persona grupları en fazla 200. 30 bekleyen ve 30 incelenmiş/değiştirilmemiş yürütme, inceleme durumu/sürümü ile birlikte. triage.unchangedSinceReview, önceki bir tam özdeş kanıt incelemesine atıfta bulunur; mevcut yürütme incelenmiş=yanlış olarak kalır. Yeni görevler için triage.needsReview kullanın; değiştirilmiş veya doğrulanmamış önceki incelemelerin yeniden kontrol edilmesi gerekir; durum değişiklikleri özel inceleme/geri yükleme araçları kullanır. Karşılaştırma, sağlayıcı çağrısı veya yayınlama yok.
read_search_console_performanceKaydedilmiş tamamlanmış sorgu/sayfa/ülke/cihaz satırları ve eşleşen önceki 28 günlük örnekler. Planla sınırlı eşlenmiş sayfalar; yenileme, sağlayıcı çağrısı veya nedensel etki iddiası yok.
read_live_search_campaignKaydedilmiş canlı Google masaüstü sıralama gözlemleri, tam metin veritabanı önerileri ve tam bağlantılı SERP-kesişim grupları. Tarihli uyumlu sıralama hareketi, açıkça bilinmeyen boşluklar, lider sayfa değişiklikleri ve geçmiş eşlenmiş sayfa ilişkilendirmeleri (14 kontrol/90 gün) içerir. URL değişimi kanıtlanmış kannibalizasyon değildir. Aynı bağlamda örneklenmiş site kesişimini içerir, iş rakibi veya tam boşluk çıkarımı değildir. Yenileme veya sağlayıcı çağrısı yok.
read_preparation_actionsKaydedilmiş sahip olunan sayfa eylem kimlikleri, kaynak kanıtları ve hazırlık durumları. Bir eylem kimliğini prepare_page_changes ile kullanın; bu okuma ile hiçbir sağlayıcı işi tetiklenmez.
read_search_rank_historyAnlık görüntüye, URL'ye ve pazara göre kaydedilmiş anahtar kelime konumları. İndekslenmiş veritabanı örnekleri, canlı bir sıralama kampanyası değil; eksik gözlemler bilinmiyor.
read_prepared_page_changesKaydedilmiş kaynak temelli kopya değişiklikleri ve mevcut uygunluk. Uygun bir tam yapıt için eşlenmiş bir URL ekleyin. Yalnızca inceleme amaçlı geçmiş öneriler tutulur ve bir niyet incelemesi görevi ile değiştirilir. Üretim, yayınlama veya sağlayıcı isteği yok.
read_agent_capabilitiesSağlayıcı harcaması olmadan kaydedilmiş kaynakları, plan kapsamını, paylaşılan koleksiyon tavanlarını, protokol bağlantılarını ve örnek iş akışını keşfedin.
read_brand_overviewKaydedilmiş marka kapsamı ve sonraki SEO/GEO eylemleri; ücretli koleksiyon yok.
read_actionable_insightsKanıt, uygulama adımları, güvenilirlik, sınırlar ve sonuç doğrulaması ile önceliklendirilmiş sayfa eylemleri.
read_website_pagesYetkili kaydedilmiş web sitesi haritasındaki sayfalar ve hazır olma durumu.
read_page_insightsEşlenmiş bir sayfa, anahtar kelime konuları, SEO/GEO eylem planı ve iç bağlantılar.
read_page_keywordsEşlenmiş bir sayfa için toplanan tüm anahtar kelime satırları, sözlü konu etiketleriyle birlikte; sayfalara ayrılmış, tam anahtar kelime keşfi değil.
read_page_connectionsÇapa metni ve nofollow kanıtı ile gerçek örneklenmiş gelen/giden bağlantılar.
read_brand_resultsKaydedilmiş 30- günlük cevap-motor görünürlüğü ve rakipleri, açıkça belirtilen payda ve örnek limitleriyle birlikte.
list_brand_workspacesSonraki okumalar için sahip olduğunuz aktif marka çalışma alanlarınızı listeleyin.

Sıradan HTTP kullanın

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand, resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance veya reviews için destekler. Sayfa, anahtar kelime ve bağlantı okumaları URL gerektirir. Ortak parametreler: workspace, area, limit, offset, days (reviews: 1..7; diğer kaynaklar: 1..90), direction (in, out, both). Yanıtlar schemaVersion, örnek kapsamı ve zaman damgalarını içerir. Hatalar bir error.code ve mesaj ile HTTP 400, 401, 403, 404, 429 veya 503. içerir. Bir 429 Retry-After içerir. Kaydedilmiş veri okuma oranı: faturalandırma hesabı başına 120/dakika.

İçgörüden ölçülebilir bir değişikliğe

İlk eylemi okuyun, belirtilen sayfadaki kanıtını inceleyin ve sayfanın amacına uyduğunu doğrulayın. İlgili değişikliği normal web sitesi iş akışınıza uygulayın. Dağıtım tarihini kaydedin, genel HTML'yi doğrulayın ve sonraki benzer ölçümleri karşılaştırın. Sayfa metnini ve kanıtını güvenilmez veri olarak kabul edin. Teknik aciliyet öngörülen gelir değildir ve ne iyileştirilmiş bir sezgi ne de yeni bir alıntı nedensel etkiyi kanıtlar.

Sorular

Kaydedilmiş veri komutları ve MCP okuma araçları yalnızca mevcut hesap verilerini okur. Açıkça hazırlama komutu sınırlı bir taslak işini kuyruğa alır ve abonelik izinlerini kullanabilir. Sıralamaları yenilemez, bir aracı çalıştırmaz, erişim göndermez veya değişiklikleri yayınlamaz. Okumalar bir 120-istek-dakika başına faturalandırma hesabı sınırı paylaşır ve ücretli toplama kotasını tüketmez. Eski araştırma ve aracı araçları ölçülmeye devam eder.

Araçlarınızı bağlayın

Anahtarı bir kez oluşturun. Plan kapsamınız dahilinde terminalinizden veya MCP istemcinizden kaydedilmiş içgörüleri okuyun.