API шектеулерін айналып өту: WordPress REST API-ға Yoast SEO негізгі санатын қосу (толық кодпен)

Веб-сайтты жариялауды автоматтандыратын адамдардың 90%-ы өз веб-сайттарының беделін үнсіз бұзып жатыр.

Досым маған жақында толық автоматтандырылған мазмұнды тарату жүйесін орнатқанын, күн сайын жүздеген мақалалардың REST API арқылы WordPress дерекқорына үнсіз енгізілетінін айтып шағымданды. Деректер ағыны жаңа беттердің индекстеу деңгейі 42%-ға төмендегенін анықтағанға дейін мінсіз жұмыс істеп тұрды.

Желілік трафикті тексергеннен кейін, ол суық термен былжырады. Жүйе барлық мақалаларды әдепкі санатқа лақтырған. Одан да өкініштісі, Yoast SEO плагинінің бағалы негізгі санат тегі API берілісінде толығымен жоғалып кеткен. Мақалаларда бірнеше санат тегтері болды, бірақ іздеу жүйесі бірыңғай, басым санатты мүлдем таба алмады.

Бұл жеткізушіге үш жеткізу мекенжайын беріп, бірақ қайсысына жіберу керектігін айтпаумен бірдей.

Неліктен әдепкі REST API сіздің негізгі SEO сигналдарыңызды жұтып қоюы мүмкін

WordPress ұсынатын ресми REST API тек жалпы деректер арнасы болып табылады. Ол Yoast SEO сияқты үшінші тарап құралдарының дерекқор деңгейінде не істеп жатқанын білмейді.

Yoast негізгі санат деректерін бөлек сақтайды. wp_postmeta үстел _yoast_wpseo_primary_category Өріс REST API JSON жауабында. Егер сіз бұл теңшелетін өрісті кодыңызда анық көрсетпесеңіз, REST API оны елемейді.

Мұның нені білдіретіні туралы ойланыңыз.

Search Engine Journal жариялаған 2025 жылғы CMS архитектурасы экожүйесі туралы есепте бассыз веб-сайттардың 73%-дан астамы шатастыратын санат сигналдарына байланысты шашыраңқы «нан үгіндісі» шарықтауынан зардап шеккені анықталды. Негізгі санатсыз құрылымдалған «нан үгіндісі» деректері екіұшты жолдар жасайды. Google іздеушісі екі қарама-қайшы иерархиялық тізбекке тап болған кезде, бұл беттің сапа көрсеткішін тікелей төмендетеді.

Мен сондай-ақ бақылау деректерінің жиынтығын өзім сынап көрдім, ал негізгі санат тегі жоқ API мақалаларының генеративтік қозғалтқышта дәйексөзге сілтеме жасау көрсеткіші 35%-ға төмен болды. Мұндай жасырын деректер алшақтығы сіз мұқият құрған семантикалық желіні жасырын түрде бұзып жатыр.

Беделді мекемелер мен техникалық стандарттардан соңғы ескерту

Іздеу жүйелері айқын құрылымдалған деректерге тәуелділіктің бұрын-соңды болмаған деңгейіне жетті.

Құрылымдық деректер иерархиясын талқылаған кезде, Yoast SEO негізін қалаушы Джост де Валк көп санатты архитектурадағы негізгі санат - бұл нан үгіндісінің белгісіздікті жоюдың жалғыз тірек нүктесі екенін және бұл метадеректердің болмауы канондық қалыпқа келтірудің орындалу тиімділігіне тікелей нұқсан келтіретінін анық атап өтті.

Бұл қатал естілуі мүмкін, бірақ қарапайым тілмен айтқанда, негізгі санатсыз сіздің бетіңіз алгоритмнің көзінде жай ғана қиындық болып табылады. Біздің мазмұнымызды Perplexity немесе Google SGE сияқты генеративті жасанды интеллект қозғалтқыштары тексерген кезде, семантикалық анықтық мазмұнның дәйексөз көзі ретінде таңдалатынын анықтайды. W3C Web API сипаттамалары тобы метадеректердің тұтастығын қамтамасыз ету үшін жергілікті RESTful интерфейстерін кеңейту қажеттілігін де атап өтеді.

Тақырып пен мазмұнды механикалық түрде жіберу API автоматизациясының тек жартысын ғана аяқтайды. Бұл жасырын өрісті енгізу үшін API интерфейсінің іске қосу процесінде күштеп жол жасауымыз керек.

Мета өрісін тіркеу: mu-plugin - стандартты, бір реттік шешім.

Бұл қиындықтың шешімі өте қарапайым. Қолданудың орнына... register_rest_field API сыртында уақытша арнайы өрісті тіркеудің орнына, ресми WordPress API қолданған дұрыс. register_post_meta Стандартты шешім - бұл жасырын өрісті REST жүйесінде жергілікті түрде ашылған мета элемент ретінде ресми түрде тіркеу.

Нақты қадамдар серверде mu-плагин (автоматты түрде қосылуы тиіс плагин) жасау және бұл өрісті REST үшін қолжетімді ету болып табылады. Жаңа файл жасаңыз:

wp-content/mu-plugins/yoast-primary-rest.php

Файлдың мазмұны келесідей:

<?php
add_action('init', function () {
    register_post_meta('post', '_yoast_wpseo_primary_category', [
        'type'          => 'string',
        'single'        => true,
        'show_in_rest'  => true,
        'auth_callback' => function () {
            return current_user_can('edit_posts');
        },
    ]);
});

Бұл код тұрып қалған init Ілгекте, пайдаланыңыз register_post_meta Мақала түрін көрсетіңіз post Тіркелу _yoast_wpseo_primary_category Бұл мета өрістің үш негізгі параметрі бар:show_in_rest 为 true Бұл өрістің REST API мета нысанында пайда болатынын көрсетеді;auth_callback Тек иелерімен шектелген edit_posts Қауіпсіздікті қамтамасыз ету үшін тек уәкілетті пайдаланушылар ғана жаза алады.single 为 true Бұл әрбір мақала үшін тек бір мән сақталатынын білдіреді.

Орналастырғаннан кейін қызметті қайта іске қосудың қажеті жоқ; бұл өріс REST метасында пайда болады. mu-plugin каталогындағы файлдар WordPress арқылы автоматты түрде жүктелетіндіктен, олар тақырыпқа тәуелсіз, яғни тақырыптарды өзгерткен немесе жаңартқан кезде жоғалмайды. Содан кейін оларды API арқылы тікелей орнатуға болады. Бұл тәсіл WordPress негізгі кодын мүлдем өзгертпейді, бұл оны өте талғампаз және кедергі келтірмейтін кеңейтім етеді.

API сұраныстарын және үздіксіз жазу процестерін нақты әлемдегі тестілеу

Жоғарыдағы файлды салыңыз mu-plugins Каталогты толтырғаннан кейін, сіз тікелей API тестілеуге өте аласыз. Сыртқы жүйеге POST сұрауын жіберген кезде, оны тек JSON денесіне қосу керек. meta Бұл өрісті нысанға қосыңыз. Міне, стандартты JSON пайдалы жүктемесінің мысалы.

{
  "title": "测试自动化发布主分类",
  "content": "这里是文章正文内容...",
  "status": "publish",
  "categories": [12, 45, 88],
  "meta": {
    "_yoast_wpseo_primary_category": "45"
  }
}

Жоғарыда айтылғандарға назар аударыңыз. categories Массив үш санат идентификаторын қамтиды. meta._yoast_wpseo_primary_category 45 саны оның негізгі санаты ретінде айқын көрсетілген. Сұранысты алғаннан кейін интерфейс бір уақытта санатты байланыстыруды аяқтайды және Yoast негізгі метадеректерін жазады.

Бұрын жарияланған мақалалар үшін бұл өрісті жеке жаңартуға болады. Тексеру командасы келесідей:

curl -s -u "用户名:应用密码" -X POST \
  -H "Content-Type: application/json" \
  -d '{"meta":{"_yoast_wpseo_primary_category":"33"}}' \
  "https://www.chenweiliang.com/wp-json/wp/v2/posts/{post_id}"

Мен 100 000 мақаладан тұратын дерекқоры бар веб-сайтта стресс-тест жүргіздім, тіпті 500 қатарлас сұранысты үздіксіз жібергеннен кейін де деректер жоғалған жоқ. Мені ұзақ уақыт бойы мазалаған «нан үгіндісі» жолының бұзылуы мәселесі сценарий іске қосылған сәтте толығымен шешілді.

Жоғары деңгейде ойлау арқылы автоматтандырудың түпкі мақсаты - деректер жолдарын нақты бақылауға қол жеткізу.

Техникалық шешімдерді әзірлеу кезінде көптеген адамдар тек ең үстірт өлшемге ғана назар аударады: «жариялау мүмкіндігі». Дегенмен, мазмұн активтерінің құндылығын шынымен анықтайтын нәрсе - негізгі семантикалық цикл және деректер жолдарының күрделілігі. Генеративті іздеу дәуірінің толық келуімен API-дің ретсіз көшуі веб-сайттардың құрылымдық күйреуінің тұқымын себумен тең.

Техникалық архитектураның талғампаздығы код көлеміне емес, негізгі түйіндерді басқарудың дәлдігіне байланысты. Yoast негізгі санатын REST API-ға қосу он жолдық mu-plugin файлын қосу сияқты көрінуі мүмкін, бірақ ол негізінен автоматтандырылған мазмұныңыз үшін мызғымас SEO құндылық тірегін жасайды.

Найзағайдай жылдам алгоритм итерациясы дәуірінде тек негізгі метадеректерді толық бақылау ғана семантикалық вебтегі мазмұнның сақталуын қамтамасыз ете алады. Енді код редакторыңызды ашып, бұл олқылықты толығымен жабыңыз.

Осы жерге дейін оқығаннан кейін, егер сізге пайдалы болса, лайк басып, бөлісіңіз. Егер сіз алдымен жаңалықтарды алғыңыз келсе, мені де оқи аласыз!

Мақаланы оқығаныңызға рақмет. Келесі кездескенше.