obsidian-vault/concepts/Eurostela-SEO-Endpoint.md
2026-10-22 18:30:02 +00:00

177 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: concept-eurostela-seo-endpoint
pageType: concept
updatedAt: 2026-10-22 18:18:55+00:00
sourceIds:
- source.memory
tags:
- seo
- wordpress
- api
- eurostela
- rank-math
claims:
- text: 'Плагин MCP SEO Endpoint v1.8 на хостинге eurostela.ru: endpoint POST /wp-json/openclaw/v1/seo-optimize;
ключ EUROSTELA_SEO_API_KEY (из /etc/environment Pi); лимиты title 70 / desc 160'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); раздел «Eurostela SEO endpoint
(с 2026-08-30)»
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.85
id: eurostela-seo-endpoint-v1.8
- text: 'v1.8: параметр object_type (auto|post|term, default auto); категории ставить ТОЛЬКО с object_type="term"
— коллизия wp_posts.ID = term_id (227/240/258)'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); источник истины = projects/eurostela.ru/PROJECT.md
(секция «Перенесённые знания из MEMORY.md», статус active)
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.9
id: eurostela-seo-object-type-term
- text: '2026-08-30: 9/9 категорий eurostela.ru (30, 67, 227, 37, 240, 618, 619, 258, 68) получили согласованные
title+desc, live с cache-buster; задача «SEO-тексты категорий» закрыта'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); источник истины = projects/eurostela.ru/PROJECT.md
(секция «Перенесённые знания из MEMORY.md», статус active)
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.9
id: eurostela-seo-9of9-live
- text: 'Live-проверка SEO-меты eurostela.ru — только с cache-buster (edge-кэш ~1ч): ?t=<ts>, UA Chrome'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); источник истины = projects/eurostela.ru/PROJECT.md
(секция «Перенесённые знания из MEMORY.md», статус active)
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.85
id: eurostela-seo-cache-buster
- text: 'Инцидент 2026-08-30: rank_math-мета скрытых постов 227/240/258 перезаписана (v1.7 auto-ветка);
старые значения только из дампа БД хостинга; backup''ы плагина BU_1..BU_3 не удалять, посты не трогать
до закрытия вопроса'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); источник истины = projects/eurostela.ru/PROJECT.md
(секция «Перенесённые знания из MEMORY.md», статус active)
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.9
id: eurostela-seo-incident-hidden-posts
- text: 'Runbook обязателен перед любой SEO-задачей eurostela.ru: projects/eurostela.ru/seo-endpoint-runbook.md
(+ копия в Nextcloud eurostela.ru/)'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: Перенесено из MEMORY.md 2026-09-08 (Hermes Protocol step 2); источник истины = projects/eurostela.ru/PROJECT.md
(секция «Перенесённые знания из MEMORY.md», статус active)
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.9
id: eurostela-seo-runbook
- text: 'С 2026-09-08 (Hermes Protocol step 2): источник истины по SEO endpoint eurostela.ru (ключ x-openclaw-key,
headers, runbook, инцидент BU_1..BU_3) = projects/eurostela.ru/PROJECT.md, раздел «Перенесённые знания
из MEMORY.md», статус active; e-com-секции удалены из MEMORY.md; значения ключей/токенов в wiki не
дублируются'
status: verified
evidence:
- kind: source-file
sourceId: source.memory
path: projects/eurostela.ru/PROJECT.md
note: 'Вход в силу: Hermes Protocol step 2 (2026-09-08); факт зафиксирован в CHANGELOG.md и projects/eurostela.ru/PROJECT.md
(frontmatter status=active)'
updatedAt: 2026-09-08 04:15:00+00:00
confidence: 0.95
id: eurostela-seo-sot-project-md
- text: 'desc-pipeline (eurostela.ru, final state 2026-10-22 21:00 MSK): 33/308 товаров с уникальными meta description — пилот 3 (В-096 id=12360, В-043 id=11947, А-003 id=12845) + батч-2: 10 из группы 1 (АР-035/036/039/042/044/045 = ids 11091/11092/11125/11128/11130/11131, Г-002/005/007/008 = ids 12850/12853/12855/12886) + батч-3: 20 из группы 1 (Г-011/012/018/020/021/027/028/030/033/036/040/043/063/065/072/074/075/078/081/083 = ids 12889/12890/12926/12928/12929/12935/12966/12968/12974/13007/13011/13014/13121/13123/13159/13161/13162/13165/13168/13199); 33/33 stored+live точное совпадение, независимые аудиты: desc-pilot-audit и audit-batch2-rank-math PASS WITH LIMITATIONS, audit-batch3-rank-math PASS; осталось 275 товаров / 28 дубль-групп (группа 1: 62, остальные 27: 213) — решение о полном прогоне за пользователем; рабочий путь записи meta = PUT /wc/v3/products/{id} с meta_data upsert (строка rank_math_description) — POST /rankmath/v1/updateMeta отвечает 200, но НЕ сохраняет; артефакты: projects/eurostela.ru/desc-pipeline/ (batch2-*.json, batch3-*.json, vision-batch2/ 14/14 ok, vision-batch3/ 40/40 ok); источник: MEMORY.md §3 + CHANGELOG [OPS] 2026-10-22 21:00 MSK (batch3) + 14:32 MSK (batch2)'
status: supported
evidence:
- kind: source-file
sourceId: source.memory
path: sources/memory.md
note: 'Буллет «desc-pipeline / SEO (eurostela.ru, final state 2026-10-22 21:00 MSK)» в MEMORY.md §3 (вход 2026-10-22); детали: CHANGELOG [OPS] 2026-10-22 21:00 MSK (батч-3) + 14:32 MSK (батч-2) + 11:50 MSK (пилот)'
updatedAt: 2026-10-22 18:18:55+00:00
confidence: 0.9
id: eurostela-seo-desc-pilot-final
---
# Concept: Eurostela SEO Endpoint (MCP SEO Endpoint)
## Summary
SEO endpoint eurostela.ru: плагин MCP SEO Endpoint (openclaw-seo.php, v1.8 на хостинге) предоставляет `POST /wp-json/openclaw/v1/seo-optimize` для записи rank_math-меты (title/description) товаров и категорий WooCommerce. С 2026-08-30 категории пишутся только с `object_type: "term"` (коллизия wp_posts.ID = term_id для 227/240/258). 30.08 все 9 категорий получили согласованные title+desc, live с cache-buster.
## Description
### Endpoint
- **URL:** `https://eurostela.ru/wp-json/openclaw/v1/seo-optimize`, метод POST.
- **Авторизация:** ключ `EUROSTELA_SEO_API_KEY` (из `/etc/environment` Pi; совпадает с WP-константой).
- **Параметры v1.8:** `object_type` (auto|post|term, default auto = поведение v1.7; whitelist-validate_callback).
- **Лимиты:** title 70 / desc 160 символов.
- **Цель:** запись `rank_math_title` / `rank_math_description` через WordPress PHP hooks.
### object_type и коллизия ID
- `auto` находит объект по ID: сначала пост, потом терм → при совпадении wp_posts.ID и term_id (227/240/258) запись уходила в post meta скрытых постов.
- Правило: **категории — только `object_type: "term"`**; посты/товары — `post` (или auto, если ID уникален).
- Замечание Сергея (не блокирующее, для v2 API): переименовать `post_id` → `id`, т.к. при object_type=term это term_id. Сейчас не менять (совместимость).
### Версии и артефакты
- v1.6 (оригинал Сергея, только посты) → v1.7 (auto-ветка, исходник коллизии) → v1.8 (опциональный `object_type`, деплой Сергеем ~17:38 30.08, подтверждён smoke-test'ом: 227 → type:category).
- Бэкапы на хостинге `BU_1..BU_3` — **не удалять**; архивы локально `projects/eurostela.ru/assets/archive/openclaw-seo-2026-08-30-BU_*.php`.
- Результат 30.08: 9/9 категорий (30 Горизонтальные, 67 Мраморные, 227 Корки-скалы, 37 Комплексы, 240 Колумбарии, 618 Родителям, 619 Женщине, 258 Мужчине, 68 Комбинированные) — title+desc live (проверка с cache-buster).
### Инцидент 2026-08-30
- v1.7 auto-ветка перезаписала rank_math-мета скрытых постов 227/240/258 (draft/private: REST 404, `?p=` редирект на home/404).
- Восстановление старых значений — только из дампа БД хостинга; до закрытия вопроса посты не трогать.
### Правила работы
- Перед любой SEO-задачей eurostela.ru — читать runbook: `projects/eurostela.ru/seo-endpoint-runbook.md` (+ копия в Nextcloud `eurostela.ru/`).
- Live-проверка — только с cache-buster (edge-кэш ~1ч): `?t=<ts>`, UA Chrome.
## Claims
- Плагин MCP SEO Endpoint v1.8 на хостинге eurostela.ru: endpoint POST /wp-json/openclaw/v1/seo-optimize; ключ EUROSTELA_SEO_API_KEY (из /etc/environment Pi); лимиты title 70 / desc 160
- v1.8: параметр object_type (auto|post|term, default auto); категории ставить ТОЛЬКО с object_type="term" — коллизия wp_posts.ID = term_id (227/240/258)
- 2026-08-30: 9/9 категорий eurostela.ru (30, 67, 227, 37, 240, 618, 619, 258, 68) получили согласованные title+desc, live с cache-buster; задача «SEO-тексты категорий» закрыта
- Live-проверка SEO-меты eurostela.ru — только с cache-buster (edge-кэш ~1ч): ?t=<ts>, UA Chrome
- Инцидент 2026-08-30: rank_math-мета скрытых постов 227/240/258 перезаписана (v1.7 auto-ветка); старые значения только из дампа БД хостинга; backup'ы плагина BU_1..BU_3 не удалять, посты не трогать до закрытия вопроса
- Runbook обязателен перед любой SEO-задачей eurostela.ru: projects/eurostela.ru/seo-endpoint-runbook.md (+ копия в Nextcloud eurostela.ru/)
- 2026-09-08 (Hermes Protocol step 2): источник истины по SEO endpoint eurostela.ru (ключ x-openclaw-key, headers, runbook, инцидент BU_1..BU_3) = projects/eurostela.ru/PROJECT.md, раздел «Перенесённые знания из MEMORY.md», статус active; e-com-секции удалены из MEMORY.md; значения ключей/токенов в wiki не дублируются
- desc-pipeline (2026-10-22 21:00 MSK, final state): 33/308 товаров с уникальными meta description — пилот 3 (В-096 id=12360, В-043 id=11947, А-003 id=12845) + батч-2: 10 из группы 1 (АР-035/036/039/042/044/045 = ids 11091/11092/11125/11128/11130/11131, Г-002/005/007/008 = ids 12850/12853/12855/12886) + батч-3: 20 из группы 1 (Г-011/012/018/020/021/027/028/030/033/036/040/043/063/065/072/074/075/078/081/083 = ids 12889/12890/12926/12928/12929/12935/12966/12968/12974/13007/13011/13014/13121/13123/13159/13161/13162/13165/13168/13199); 33/33 stored+live совпадение, 3 аудита (desc-pilot-audit, audit-batch2-rank-math — PASS WITH LIMITATIONS; audit-batch3-rank-math — PASS); осталось 275 товаров / 28 дубль-групп — полный прогон за пользователем; рабочий путь = PUT /wc/v3/products/{id} + meta_data upsert (rank_math_description); POST /rankmath/v1/updateMeta — 200 без сохранения; артефакты: projects/eurostela.ru/desc-pipeline/ (batch2-*.json, batch3-*.json, vision-batch2/ 14/14 ok, vision-batch3/ 40/40 ok)
## Tags
- seo
- wordpress
- api
- eurostela
- rank-math
## Sources
- [[MEMORY.md]] (исторический источник, до 2026-09-08)
- projects/eurostela.ru/PROJECT.md — source of truth по SEO endpoint eurostela.ru (с 2026-09-08, Hermes Protocol step 2)
## Related
<!-- openclaw:wiki:related:start -->
### Sources
- [MEMORY](../sources/memory.md)
### Related Pages
- [Concept: Git Backup & Recovery Protocol (AGENTS.md §20)](Git-Backup-Recovery-Protocol.md)
- [Entity: Eurostela (евростела.ru)](../entities/eurostela.md)
- [Entity: Infrastructure](../entities/Infrastructure.md)
- [Pg-Boss Queue & AI Inference Worker](../syntheses/pg-boss-queue-ai-inference-worker.md)
<!-- openclaw:wiki:related:end -->