Xüsusi hazırlanmış saytı SEOAsist Site API ilə qoşun

Əgər saytınız WordPress və ya Shopify üzərində deyilsə (Next.js, Laravel, .NET, sadə PHP…), ona kiçik bir API əlavə edərək SEO işlərini SEOAsist-ə həvalə edə bilərsiniz. Qoşulduqdan sonra başlıq (title), təsvir (description), kanonik (canonical), robots, strukturlaşdırılmış məlumat (structured-data) və yönləndirmə (redirect) düzəlişləri server tərəfində tətbiq olunur, bloq yazıları dərc edilir və llms.txt yenilənir. Heç bir plagin və ya pull request tələb olunmur.

#Ön şərtlər

• Saytın kodunu dəyişmək imkanınız var (özünüz, tərtibatçınız və ya Claude / Cursor kimi AI kodlaşdırma köməkçisi vasitəsilə).
• Sayt üçün mühit dəyişənlərini (environment variables) təyin edə bilirsiniz (.env və ya hostinq panelinizdə).
• Paneldə redaktə hüquqlarınız var; əks halda “You need edit rights for this” xəbərdarlığını görəcəksiniz.

#1. API-ni saytınızda quraşdırın

1. Saytı Sites bölməsindən açın və Fix channels tabına keçin.
2. Yuxarıdakı SEOAsist Site API (custom-built sites) kartında Setup prompt düyməsini sıxın.
3. Dialoq pəncərəsində Copy düyməsini sıxın və mətni proyektiniz üzərində işləyən Claude, Cursor və ya tərtibatçıya təqdim edin. Prompt tam spesifikasiyanı və bu sayt üçün təfərrüatları (saytın URL-i, API-nin əsas URL-i və qoşulubsa, GitHub repozitoriyası) ehtiva edir.
4. Kodu özünüz yazmağa üstünlük verirsiniz? Developer guide düyməsini sıxın. Burada başlamaq üçün kopyalayıb yapışdıra biləcəyiniz kodları ehtiva edən Steps, Spec, Next.js, PHP və Test tabları var.

Saytınız bir əsas yol altında dörd endpoint təqdim edir: GET /manifest, PUT /rules, POST /content və PUT /files. Ətraflı məlumat üçün Site API reference sənədinə baxın.

#2. URL-i saxlayın və tokeni əlavə edin

1. API ünvanını kartın aşağı hissəsindəki API base URL sahəsinə daxil edin. Defolt təklif https://<doveriniz>/api/seoasist şəklindədir.
2. Connect düyməsini sıxın. Token — shown only now başlıqlı sarı qutu görünəcək və burada SEOASIST_SITE_TOKEN=sa_… sətri əks olunacaq.
3. Copy düyməsini sıxın və bu sətri saytın mühit dəyişənlərinə əlavə edin. İkincisi, saytı yenidən başladın və ya yenidən dərc (redeploy) edin.

#3. Bağlantını sınaqdan keçirin

1. İsteğe bağlı olaraq, əvvəlcə Developer guide → Test bölməsindəki curl əmri ilə /manifest endpoint-ini yoxlayın.
2. Kartdakı Test connection düyməsini sıxın. SEOAsist /manifest endpoint-ini çağırır və saytınızın bəyan etdiyi imkanları yadda saxlayır.
3. Uğurlu olduqda “Connected · capabilities: … · N rules sent” mesajını görəcəksiniz. Gözləmədə olan bütün aktiv qaydalar dərhal sayta göndərilir.

#Qoşulduqdan sonra avtomatik nə baş verir

Status sətri saytınızın bəyan etdiyi imkanları göstərir: SEO rules, Content publishing və llms.txt / robots. Onların hər biri müstəqil işləyir və SEOAsist yalnız saytınızın siyahıya aldığı imkanlardan istifadə edir.

Kartda həmçinin iki əl ilə idarəetmə düyməsi var: Send rules now (N) və Send llms.txt. llms.txt düyməsi üçün əvvəlcə AI access tabında bir llms.txt yaradılmalıdır.

#Health səhifəsində avtomatik düzəliş (Auto-fix)

Site API “SEO rules” imkanı ilə qoşulduqda, Health səhifəsində dəstəklənən problemlərin yanında Auto-fix düyməsi görünür. Dəstəklənən problemlər: əskik, çox uzun, çox qısa və ya təkrarlanan başlıqlar (title); əskik, çox uzun və ya təkrarlanan meta təsvirlər (meta description); əskik kanonikləri (canonical) və ya başqa səhifəyə yönələn kanoniklər; əskik html lang; noindex kimi işarələnmiş səhifələr. Qəsdən təyin edilmiş noindex (məsələn, sitemap-də olmayan teq və ya zəif kontentli səhifələr) avtomatik düzəlişlə heç vaxt index-ə dəyişdirilmir.

O, son skanın təsirlənmiş səhifələri üçün (40-a qədər) dəyərlər formalaşdırır. AI başlıqları və təsvirləri yazır: hər səhifəninki həmin səhifənin öz dilində, öz başlıq, H1 və təsvirindən götürülür; çoxdilli saytlarda başqa səhifənin və ya dilin başlığı heç vaxt yazılmır. Kanonik, lang və robots dəyərləri hesablanır. Onlar saytınıza qaydalar şəklində göndərilir və təsdiqləmə skanı başlayır. Eyni problem üçün onu yenidən işlətmək əvvəlki qaydaları əvəz edir. Ətraflı məlumat Intentional issues and auto-fix sənədində.

#Dərc etmə qaydaları və dillər

• Eyni məqalənin yenidən dərc edilməsi: əgər məqalə artıq eyni ünvanda (eyni slug və dildə) dərc olunubsa, SEOAsist yeni -2 nüsxəsi açmır; saytdakı mövcud məqaləni yeniləyir.
• Dillər: məqalə öz mətni hansı dildədirsə, o dildə göndərilir. Site API saytın hər bir dilində dərc edə bilər: təyin etmisinizsə Site languages siyahısı, əks halda əsas dil və saytınızın /manifest-də locales kimi bildirdiyi dillər. Əgər məqalənin dili bunlardan kənardırsa, o dərc olunmur, baxışa qaytarılır və sizə “Not published, language mismatch: …” bildirişi gəlir. Bundan əvvəl SEOAsist manifesti bir dəfə yenidən oxuyur, beləliklə, saytınız yeni dil əlavə edibsə, yenidən sınaqdan keçirməyə ehtiyac qalmır.
• Səhifə yeniləmələri: dil yoxlaması yalnız göndərilən səhifə mətninə baxır və onu səhifənin öz dili ilə müqayisə edir; mətndəki xüsusi adlar (şirkət və ya məhsul adları) dili müəyyən edərkən nəzərə alınmır. Səhifə yeniləmələri heç vaxt avtomatik dərc olunmur; onları redaktordan dərc edirsiniz.
• Avtomatik dərc etmə: planlaşdırılmış və Autopilot canlı dərc etmələri əvvəlcə avto-dərc yoxlamasından keçir; uğursuz olan məqalə səbəbləri ilə birlikdə təsdiqə göndərilir. Əl ilə dərc etmə bu yoxlamadan keçmir.
• Müştəri təsdiqi: təşkilat üçün “Require client approval before publishing” aktiv olduqda, müştəri təsdiq edənə qədər məqalələr və səhifə yeniləmələri bu kanal vasitəsilə canlı dərc olunmur; baxın Client approval.

#Təsdiqləmə

• Kartın status sətrində yaşıl Connected, imkan teqləri və “last push N rules” görünür.
• Səhifələrinizdən birinin mənbə kodunu açın (brauzerdə “View page source”). Tətbiq olunmuş başlıq və ya meta təsvir HTML-də olmalıdır. Qaydalar klient tərəfli JavaScript ilə deyil, server tərəfində tətbiq olunmaq üçün nəzərdə tutulub.
• Nəsə uğursuz olarsa, status qırmızıya dəyişir (Error) və son xəta mesajı kartda göstərilir. Baxın Site API connection problems.

#Tez-tez verilən suallar (FAQ)

#Qoşulmanı kəsdikdə saytımdakı qaydalar silinirmi?

Xeyr. Disconnect yalnız SEOAsist-in göndərişini dayandırır; saytınızda saxlanılan qaydalar olduğu kimi qalır.

#API URL-ini dəyişsəm nə baş verər?

Yeni URL-i daxil edin və Save URL düyməsini sıxın. Status Awaiting test olaraq dəyişəcək; Test connection əməliyyatını yenidən icra edin. Token eyni qalır.

#Qayda olmadıqda saytım dəyişirmi?

Dəyişməməlidir. Spesifikasiya qaydalar olmadıqda hər bir səhifənin dəqiq bu gün olduğu kimi render olunmasını tələb edir və quraşdırma promptu mövcud SEO davranışını pozmamağı aydın şəkildə xahiş edir.

#Bu, Pixel-dən nə ilə fərqlənir?

Onlar eyni qaydaları bölüşürlər. Pixel onları brauzerdə JavaScript ilə tətbiq edir; Site API isə onları serverinizdə tətbiq edir, beləliklə axtarış sistemləri dəyişikliyi birbaşa HTML-də görür. Site API həmçinin məqalələr dərc edə və llms.txt yaza bilər.

#Lokal tərtibat URL-ini (localhost) qoşa bilərəmmi?

Xeyr. SEOAsist yalnız ictimaiyyət üçün əlçatan olan ünvanları çağırır; localhost və şəxsi şəbəkə ünvanları rədd edilir. API-ni canlı saytınızda quraşdırın.