Geliştirici dokümantasyonu

REST API v1 ve MCP sunucusu

Panelde yaptığın her şeyi API’den de yap: siteleri listele, tarama başlat, sorunları çek, AI düzeltmesi aç, Pixel kuralı ekle, anahtar kelime ve içerik yönet. MCP sunucusuyla aynı uç noktaları Claude, Cursor ya da herhangi bir MCP istemcisinden araç olarak kullan.

Başlangıç

API anahtarı ve kimlik doğrulama

Anahtarlar organizasyon bazlıdır ve yalnızca oluşturulurken bir kez gösterilir. read ya da read+write kapsamıyla üretilir.

1Panelde Ayarlar → API anahtarları’na git (yönetici ya da sahip).
2Ad ver, gerekiyorsa “yazma” kapsamını seç ve anahtarı oluştur; sa_live_… ile başlayan anahtarı hemen kopyala.
3Her isteğe Authorization: Bearer başlığıyla gönder. Anahtar sızarsa aynı sayfadan iptal et ve yenisini oluştur.

Temel URL

https://seoasist.com/api/v1

Başlık

Authorization: Bearer sa_live_…

Alternatif: ?api_key=sa_live_… sorgu parametresi (yalnızca test için önerilir).

curl -H "Authorization: Bearer sa_live_..." \
  https://seoasist.com/api/v1/sites

Kapsamlar: read → tüm GET uç noktaları; write → POST/DELETE (tarama, düzeltme, kural, anahtar kelime, içerik). Salt okunur anahtarla yazma isteği 403 döner.

Yanıt zarfı: her başarılı istek ok: true, data ve ms (süre) alanlarıyla JSON döner; hatalarda ok: false, error (kod) ve message bulunur.

{ "ok": true, "data": [ … ], "ms": 42 }
{ "ok": false, "error": "unauthorized", "message": "Invalid or missing API key" }

Referans

Uç noktalar

Tüm yollar temel URL’ye göredir. {id} site kimliğidir (GET /sites ile listelenir).

Yöntem	Yol	Kapsam	Açıklama
GET	/me	read	Anahtarın organizasyonu ve kapsamları
GET	/sites	read	Siteleri listele
GET	/sites/{id}	read	Site özeti: sağlık skoru, sayılar, son tarama
POST	/sites/{id}/crawl	write	Tarama başlat
GET	/sites/{id}/issues?code=&limit=	read	Gruplanmış sorunlar (+ code verilince örnek URL’ler)
POST	/sites/{id}/fixes	write	AI düzeltmesi (PR işi) oluştur: { issueCode, model? }
GET	/sites/{id}/fixes	read	Düzeltme işlerini listele
GET	/sites/{id}/pixel/rules	read	Pixel kurallarını listele
POST	/sites/{id}/pixel/rules	write	Pixel kuralı ekle: { kind, matchType, matchPath, payload, note? }
DELETE	/sites/{id}/pixel/rules/{ruleId}	write	Pixel kuralını sil
GET	/sites/{id}/keywords	read	Takip edilen kelimeler + son pozisyonlar
POST	/sites/{id}/keywords	write	Kelime ekle: { keywords: string[] }
GET	/sites/{id}/content?status=	read	İçerik ögeleri (status filtresi)
POST	/sites/{id}/content	write	İçerik fikri/yazı oluştur: { title, targetKeywords?, angle?, generate? }
GET	/sites/{id}/content/{itemId}	read	Tek içerik ögesi (HTML dahil)
GET	/sites/{id}/geo	read	AI görünürlük özeti
GET	/sites/{id}/monitors	read	Uptime + indeks + değişiklik özeti
GET	/sites/{id}/ai-access	read	Son AI bot erişim kontrolü
GET	/sites/{id}/llms.txt	read	Üretilen llms.txt (text/plain)
GET	/reports?siteId=	read	Raporlar ve herkese açık URL’leri

Örnek: AI düzeltmesi başlat

curl -X POST https://seoasist.com/api/v1/sites/SITE_ID/fixes \
  -H "Authorization: Bearer sa_live_…" \
  -H "Content-Type: application/json" \
  -d '{"issueCode":"missing_meta_description"}'

Örnek: Pixel kuralı ekle

curl -X POST https://seoasist.com/api/v1/sites/SITE_ID/pixel/rules \
  -H "Authorization: Bearer sa_live_…" \
  -H "Content-Type: application/json" \
  -d '{"kind":"title","matchType":"exact","matchPath":"/","payload":{"value":"…"}}'

Model Context Protocol

MCP sunucusu: @seoasist/mcp

Claude Desktop, Claude Code, Cursor ve diğer MCP istemcileri aynı API’yi araç olarak kullanır; ayrı kurulum yok, sadece API anahtarı.

İstemci yapılandırması

Aşağıdaki JSON’u istemcinin MCP ayarlarına ekle (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; Claude Code: claude mcp add). npx paketi otomatik indirir.

Araçlar

list_sites, get_site, start_crawl, get_issues, create_fix, list_fixes, list_pixel_rules, add_pixel_rule, delete_pixel_rule, get_keywords, add_keywords, list_content, get_content, create_blog_idea, get_geo, get_monitors, get_ai_access, list_reports

{
  "mcpServers": {
    "seoasist": {
      "command": "npx",
      "args": [
        "-y",
        "@seoasist/mcp"
      ],
      "env": {
        "SEOASIST_API_KEY": "sa_live_..."
      }
    }
  }
}

Yazma araçları (start_crawl, create_fix, add_pixel_rule, delete_pixel_rule, add_keywords, create_blog_idea) write kapsamlı anahtar ister. Tüm çağrılar https://seoasist.com/api/v1 adresine gider.

Sorun giderme

Hata kodları

Hatalar HTTP durum kodu ve JSON gövdesindeki error alanıyla döner.

401 unauthorizedAnahtar yok, geçersiz ya da iptal edilmiş.
403 forbiddenSalt okunur anahtarla yazma isteği.
404 not_foundSite/kayıt bu organizasyona ait değil ya da yok.
400 bad_requestEksik ya da geçersiz gövde alanı (ör. issueCode, kind, matchPath).
500 internalBeklenmeyen hata; message alanı ayrıntıyı verir.

Adil kullanım: dakikada 120 istek önerilir; tarama ve düzeltme gibi işler kuyruğa alınır, sonuçlarını GET uç noktalarından takip et. API erişimi Pro ve Ajans planlarında dahildir.

Özellik sayfası: API ve MCP

İlk taramayı 5 dakikada al

Ücretsiz planla başla, sitelerini ekle, Search Console'u bağla. Beğenirsen ekibini ve müşterilerini getir.

Ücretsiz başla Fiyatları gör

Kredi kartı gerekmez · İstediğin an iptal