Обход ограничений API: добавление основной категории Yoast SEO в REST API WordPress (с полным кодом)

все SEO В конечном итоге, исход игры сводится к тому, понятны ли «сигналы» или нет.
Если сигналы категоризации вводят в заблуждение, то «хлебные крошки» могут сбить с толку поисковые системы, подобно лабиринту.
Функция «Основная категория» в Yoast SEO — это именно то, что нужно для решения этой проблемы.
问题 在于 ：WordPress Встроенный REST API не предоставляет доступ к этому полю.
Следовательно, мы должны взять дело в свои руки, преодолеть ограничения API и добавить основную категорию в REST API.

Зачем добавлять основную категорию Yoast в REST API?

Многие считают, что REST API — это всего лишь инструменты для разработчиков, но в сфере автоматизации контента и... AI В условиях активного написания текстов это основной канал.
Если основную категорию невозможно задать через API, иерархия статей потеряет свою уникальность.
这意味着:

• Путь, проложенный по хлебным крошкам, может иметь несколько ветвей.
• Анализ структурированных данных, используемый Google, может приводить к неоднозначности.
• Вес страницы распределяется между различными категориями.

Согласно официальной документации Google, навигационная цепочка должна содержать единый, четкий путь; в противном случае она повлияет на эффективность индексирования.
Это не преувеличение; это сигнал, напрямую связанный с качеством страницы.

Регистрация метаполей: стандартное решение, которое раз и навсегда решает проблему.

Решение на самом деле довольно элегантное: достаточно зарегистрировать основное метаполе категории в Yoast и сделать его доступным для REST API.
Таким образом, любой вызов API может напрямую считывать и записывать данные в это поле.

Код выглядит следующим образом:

<?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');
        },
    ]);
});

Цель данного кода:

• Зарегистрировать метаполя _yoast_wpseo_primary_category.
• Открытый REST APIЭто позволяет осуществлять чтение и запись через интерфейс.
• Контроль разрешенийИспользовать эту функцию могут только пользователи, имеющие права на редактирование статей.

Как мне развернуть mu-плагин?

Вставьте этот код mu-plugin Это гарантирует его бесперебойную работу.

путь:

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

Почему стоит выбрать mu-plugin?
Поскольку это решение не зависит от темы оформления и не может быть отключено, оно является универсальным вариантом.
WordPress автоматически загрузит файл, если он существует.

Проверка: протестируйте напрямую с помощью команды curl.

После развертывания перезапуск или дополнительная настройка не требуются.
Она появится в метаполе REST API. _yoast_wpseo_primary_category.

Команда проверки:

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}"

Среди них:

• 33 Это идентификатор категории.
• {post_id} Это идентификатор статьи.
• 用户名:应用密码 Это система аутентификации по паролю для приложений WordPress.

После выполнения основной категории статьи будет обновлена ​​до указанной категории.

Фактический эффект: Объединение SEO-сигналов

Как только основную категорию можно будет задать через API, вся цепочка SEO-сигналов станет понятной:

• Путь, проложенный по хлебным крошкам, уникален.
• Структурированные данные однозначны.
• Поисковый робот Google может быстро определить иерархию страниц.

Это не только технологическая оптимизация, но и стабилизатор для контентной экосистемы.
В сценариях крупномасштабного производства контента объединение основных категорий может значительно снизить количество ошибок индексирования.

В статье Search Engine Land, посвященной 2025 году, отмечается:

«Хлебные крошки — это не просто средства навигации; это сигналы иерархии, на которые полагаются поисковые системы».

В официальной документации Yoast также четко указано:

«Основная категория гарантирует, что ваш контент будет иметь единый, понятный путь в навигационной цепочке».

Все эти точки зрения подчеркивают важность основной категории.
Расширяя REST API, мы полностью интегрируем эту функциональность в автоматизированный процесс.

эпилог

Суть SEO заключается в том, чтобы дать машинам возможность понимать контент, созданный человеком.
Главной категорией в данном контексте является якорь порядка.
Если ключевые слова — это символы языка, то хлебные крошки — это карты структуры.
Без карты поисковая система может лишь блуждать в лабиринте.

Таким образом, преодоление ограничений API и добавление основной категории Yoast в REST API — это не просто метод разработки, но и стратегическое решение.
Это обеспечивает вашему контенту большую видимость и более высокую стабильность сигнала в эпоху генеративных поисковых систем.

Только овладев порядком, можно контролировать власть.
Это и есть истинное пересечение технологий и SEO.