SEO-nuz barədə Claude, Cursor və digər Sİ assistentlərindən soruşun

1. API açarı yaradın

serp.ac-da Parametrlər → API bölməsini açın və açar yaradın (bunu yalnız hesab sahibi və adminlər edə bilər). Onu kopyalayın — yalnız bir dəfə göstərilir. MCP serveri REST API ilə eyni açarlardan, sorğu limitindən (hər açar üçün dəqiqədə 120 sorğu) və limitlərdən istifadə edir. Hər açar onu yaradan hesaba tam giriş verir, ona görə onu gizli saxlayın və sızarsa, eyni səhifədə ləğv edin.

2. Claude-u qoşun

Claude (claude.ai və Claude tətbiqləri) — fərdi konnektor

Settings → Connectors → Add custom connector bölməsinə keçin, onu serp.ac adlandırın və https://serp.ac/api/mcp server URL-indən istifadə edin. Server hər sorğunu Authorization: Bearer sk_live_… kimi göndərilən API açarınızla autentifikasiya edir; planınızdakı konnektor pəncərəsində bu başlığı göndərmək imkanı yoxdursa, əvəzində aşağıdakı Claude Desktop konfiqurasiyasından istifadə edin.

Claude Desktop — konfiqurasiya faylı

Settings → Developer → Edit config bölməsini açın və serveri claude_desktop_config.json faylına əlavə edin. O, açarınızı başlıq kimi ötürən mcp-remote körpüsünü işə salır (Node.js tələb olunur). Sonra Claude Desktop-u yenidən başladın.

{
  "mcpServers": {
    "serp-ac": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://serp.ac/api/mcp", "--header", "Authorization:${SERP_AC_AUTH}"],
      "env": { "SERP_AC_AUTH": "Bearer sk_live_..." }
    }
  }
}

Claude Code

claude mcp add --transport http serp-ac https://serp.ac/api/mcp \
  --header "Authorization: Bearer sk_live_..."

3. Cursor və digər klientləri qoşun

Cursor: serveri ~/.cursor/mcp.json faylına (bütün layihələr üçün) və ya layihədəki .cursor/mcp.json faylına əlavə edin, sonra onu Settings → MCP bölməsində aktivləşdirin.

{
  "mcpServers": {
    "serp-ac": {
      "url": "https://serp.ac/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

İstənilən digər MCP klienti (ChatGPT, VS Code, Windsurf, öz agentiniz) Streamable HTTP nəqliyyatını dəstəklədikdə və Authorization başlığını göndərə bildikdə eyni şəkildə işləyir. Yalnız stdio dəstəkləyən klientlər yuxarıda göstərilən mcp-remote körpüsündən istifadə edə bilər.

Terminaldan sürətli yoxlama:

curl https://serp.ac/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Yalnız oxuma rejimi

Məlumatları dəyişir kimi qeyd olunan alətlər hesabınıza nəsə əlavə edir, Limitdən istifadə edir kimi qeyd olunanlar isə aylıq limitlərinizi xərcləyir; assistentlərə əvvəlcə sizdən soruşmaları bildirilir. Yalnız oxuma alətlərini açmaq üçün https://serp.ac/api/mcp?readonly=1 ilə qoşulun. Yalnız oxuma rejimi açarın deyil, qoşulmanın parametridir — açar həmişə hesabın tam hüquqlarını daşıyır.

Alətlər

Hər alət qısa xülasə və eyni məlumatları strukturlaşdırılmış JSON şəklində qaytarır. Siyahılar məhduddur (200 sətirədək) və yalnız öz hesabınızın məlumatlarını ehtiva edir. Layihələrə id və ya domen ilə müraciət etmək olar.

• list_projectsOxuma

  Bu hesabdakı serp.ac layihələrini (saytlarını) id-ləri, domenləri və hər birinin neçə açar söz, Sİ promptu və alınmış link izlədiyi ilə birlikdə siyahılayır. Layihə id-lərini almaq üçün əvvəlcə bunu çağırın.

• get_rankingsOxuma

  Layihənin izlənən açar sözlərinin Google mövqeləri: cari mövqe, əvvəlki yoxlamadan bəri dəyişiklik (müsbət = yuxarı qalxıb), mövqe tutan URL, Google AI Overview-un göstərilib-göstərilmədiyi və sayta istinad edib-etmədiyi, son yoxlama vaxtı. Əlavə olaraq açar söz mətni və cihaz filtri.

• get_ai_visibilityOxuma

  Layihənin ChatGPT, Perplexity, Gemini, Claude və Google AI Mode-da Sİ görünürlüyü: brendin adı çəkilən cavabların payı, istinad dərəcəsi, orta mövqe, hər mühərrik üzrə rəqəmlər, prompt × mühərrik matrisi, ən çox istinad edilən mənbə domenləri, görünürlük payı və Sİ assistentlərinin tövsiyə etdiyi digər brendlər.

• get_backlinks_summaryOxuma

  Layihənin backlink icmalı: ümumi backlinklər və istinad edən domenlər, domen reytinqi, dofollow payı, son 30 gündə yeni linklər, itirilmiş linklər və ən güclü istinad edən domenlər.

• list_purchased_linksOxuma

  Link idarəetməsində izlənən alınmış (ödənişli) linklər: status (pending, active, issue, lost, expired, cancelled = dayandırılıb), aşkarlanan problemlər, qiymət, ödəniş dövrü, növbəti ödəniş / yeniləmə tarixi və satıcı, üstəlik növbəti 30 gündə ödənilməli olan ödənişlər. Layihə göstərilməyibsə, bütün layihələr.

• get_index_jobOxuma

  check_index ilə başladılmış indeks yoxlaması tapşırığının statusu, hər URL-in indeks statusu ilə (indexed, not_indexed, queued, error).

• get_usageOxuma

  Hesabın planı və abunəlik statusu, cari istifadə ilə plan limitləri (layihələr, açar sözlər, Sİ promptları, linklər) və qalan aylıq limitlər (indeksə göndərmələr, indeks yoxlamaları, açar söz məlumatı sorğuları).

• get_maps_rankingsOxuma

  Layihənin Google Maps mövqe izləməsi (lokal geo-şəbəkə): kampaniya göstərilmədikdə — hər Maps kampaniyası son lokal mövcudluq balı (0–100), top-10 əhatəsi və orta mövqe ilə; kampaniya göstərildikdə (id və ya açar söz mətni) — son skanın hər şəbəkə nöqtəsindəki mövqeyi, skan tarixçəsi, sizi qabaqlayan rəqiblər və local pack.

• track_keywordsMəlumatları dəyişir

  layihədə yeni açar sözlərin Google mövqelərinin izlənməsinə başlayır. Hər yeni açar söz planın SERP açar söz limitindən sayılır; artıq izlənən açar sözlər dəyişmir. Çoxlu açar söz əlavə etməzdən əvvəl istifadəçidən soruşun.

• add_ai_promptsMəlumatları dəyişir

  layihənin Sİ görünürlüyü izləməsinə promptlar (insanların Sİ assistentlərinə verdiyi suallar) əlavə edir; sonra onlar cədvəl üzrə işləyir. Hər yeni prompt planın Sİ prompt limitindən sayılır; artıq izlənən promptlar dəyişmir.

• add_purchased_linkMəlumatları dəyişir

  layihənin Link idarəetməsinə alınmış (ödənişli) link əlavə edir ki, serp.ac onu gündəlik yoxlasın və ödənişləri xatırlatsın. Planın izlənən link limitindən sayılır. Eyni mənbə → hədəf linki artıq mövcuddursa, already_tracked xətası ilə uğursuz olur.

• check_indexLimitdən istifadə edir

  URL-lərin Google tərəfindən indeksləşdirilib-indeksləşdirilmədiyini yoxlayan tapşırıq başladır. Hər URL aylıq limitdən (sonra alınmış paketlərdən) 1 indeks yoxlaması istifadə edir; kifayət qədər limit yoxdursa, heç nə tutulmur. Tapşırıq id-si qaytarır — nəticələr üçün get_index_job çağırın.

• get_keyword_dataLimitdən istifadə edir

  hər açar söz üçün axtarış həcmi, CPC, rəqabət, açar söz çətinliyi, axtarış niyyəti və 12 aylıq trend. Keşdə olmayan hər açar söz hesabın ödənişli aylıq açar söz sorğusu limitindən sayılır (keşdəki açar sözlər pulsuzdur); böyük siyahılar üçün əvvəlcə get_usage yoxlayın.

Limitlər və xətalar

• Yazma alətləri planınıza panel və REST API ilə tam eyni şəkildə tabedir: açar söz, prompt və link limitləri, plana daxil olan Sİ mühərrikləri və aktiv plan və ya sınaq.
• check_index hər URL üçün əvvəlcə aylıq limitdən, sonra paketlərdən 1 indeks yoxlaması istifadə edir; get_keyword_data keşdə olmayan açar sözlər üçün aylıq açar söz sorğusu limitindən istifadə edir. Limit çatmadıqda heç nə tutulmur.
• Çağırışla bağlı problemlər (naməlum layihə, yanlış arqumentlər, limitə çatılıb) assistentin oxuya biləcəyi alət xətası kimi qaytarılır. Olmayan və ya ləğv edilmiş açar HTTP 401, dayandırılmış hesab 403, həddindən çox sorğu isə 429 qaytarır.

Sİ assistenti olmadan avtomatlaşdırırsınız? Parametrlər → API bölməsində REST API sənədlərinə baxın.