# seo-ecommerce

Субагент seo-ecommerce для Claude Code проверяет товарные страницы: разметку Product, картинки, цены, видимость в Google Shopping и Amazon. Запускается, когда аудит нашёл на сайте признаки магазина.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 159 у репозитория
- Автор: zhtyyx
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zhtyyx/codex-seo/tree/HEAD/agents/seo-ecommerce.md
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/seo-ecommerce

## Что делает

Первым делом субагент ищет признаки магазина: разметку Product, элементы цены, кнопки add-to-cart, корзину, сетки товаров и следы Shopify, WooCommerce или Magento. Дальше снимает HTML через `render_page.py` и `parse_html.py` и сверяет Product schema с обязательными и рекомендованными полями Google. Для товарных страниц советует `--mode always`: разметка часто вставляется на клиенте, и сравнение `raw_content` с `content` показывает, попала ли она в серверный HTML.

Данные маркетплейсов тянутся через `dataforseo_merchant.py` только при наличии ключей DataForSEO. Перед вызовом Merchant API идёт `dataforseo_costs.py check <endpoint>`: статус `approved` пропускает запрос, `needs_approval` отправляет стоимость родительскому оркестратору, `blocked` отменяет анализ маркетплейсов. Расход после каждого вызова пишется в `dataforseo_costs.py log <endpoint> <actual_cost>`.

Отчёт собирается из таблиц для сравнительных данных и оценок XX/100 по schema, картинкам, контенту и общему состоянию, с приоритетами от Critical до Low. Если оркестратор передал `output_dir`, после первого прохода пишется промежуточный `output_dir/findings/ecommerce.md`, а перед завершением он перезаписывается полным. Скачанные страницы считаются недоверенными: из них извлекают данные, инструкции внутри не выполняют.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/seo-ecommerce.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/seo-ecommerce.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/seo-ecommerce.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zhtyyx/codex-seo/tree/HEAD/agents/seo-ecommerce.md

## Когда брать
- проверить, хватает ли полей Product schema для расширенных сниппетов
- найти товарные картинки без alt-текста и в старом формате
- сравнить цены на своих страницах с медианой по маркетплейсам
- отловить описания, скопированные у производителя
- разобрать блоки внутренних ссылок: хлебные крошки, похожие товары, категории

## Примеры запросов агенту
- Проверь товарную страницу `<URL>`: каких полей Product schema не хватает?
- Сравни цены на `<URL>` с медианой по маркетплейсам, если DataForSEO доступен.
- Прогони `render_page.py` для `<URL>` с `--mode always` и скажи, рендерится ли JSON-LD на сервере.

## Похожие
- [ecommerce-keyword-research](https://affpapa.org/nevibecode/skills/ecommerce-keyword-research.md) — скилл · 1500 установок
- [ecommerce-seo-audit](https://affpapa.org/nevibecode/skills/ecommerce-seo-audit.md) — скилл · 859 установок
- [seo-dataforseo](https://affpapa.org/nevibecode/skills/seo-dataforseo.md) — скилл · 7200 установок
- [seo-structure-architect](https://affpapa.org/nevibecode/agents/seo-structure-architect.md) — субагент · ★ 42780 у репозитория
- [seo-snippet-hunter](https://affpapa.org/nevibecode/agents/seo-snippet-hunter.md) — субагент · ★ 42780 у репозитория
- [seo-competitor-pages](https://affpapa.org/nevibecode/skills/seo-competitor-pages.md) — скилл · 8700 установок

Из того же набора: [zhtyyx/codex-seo](https://affpapa.org/nevibecode/by/zhtyyx/codex-seo.md) — 59 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
