К основному содержанию
субагент CX Codex

seo-specialist · josstei — субагент для Claude Code: что делает и как установить

seo-specialist — субагент для Claude Code, Codex и Cursor. Проверяет поисковую оптимизацию, crawlability и разметку JSON-LD.

Apache-2.0 ★ 489 обновлён 2026-10-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/seo-specialist.md
Открыть на GitHub

Что делает seo-specialist

Субагент анализирует проект на факторы индексации и видимости в поисковых системах. Он сканирует разметку HTML, проверяет метатеги Open Graph и Twitter Cards, находит цепочки редиректов длиннее двух переходов, а также тестирует файлы robots.txt и sitemap.xml на блокирующие правила.

Встроенная матрица schema.org помогает подобрать типы данных под конкретные страницы: Product, Article, FAQPage или LocalBusiness. Субагент сверяет обязательные поля со стандартами Google Rich Results и формирует сниппеты, готовые к вставке в шаблоны.

Субагент работает строго в режиме чтения и запуска консольных утилит (например, Lighthouse). Сам он исходный код не модифицирует: вместо правок вы получаете отчёт с уровнями важности Critical, Major или Minor и готовые примеры кода для внедрения.

Какие задачи решает

  • проверить sitemap.xml и robots.txt на случайные блокировки индексации
  • составить валидную микроразметку JSON-LD под требования расширенных сниппетов Google
  • выявить битые канонические теги и цепочки перенаправлений в верстке
  • провести ревизию заголовков H1–H6 и тегов Open Graph перед релизом

Примеры запросов агенту

  • Проверь наш маркетинговый сайт на SEO-ошибки: метатеги, микроразметку и доступность для роботов
  • Подготовь схему JSON-LD для страниц товаров под требования rich results
  • Найди цепочки редиректов и проблемы с canonical в шаблонах каталога

Как установить seo-specialist

Вручную: положить файлы

.claude/agents/seo-specialist.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о seo-specialist

Как установить seo-specialist в Claude Code?

Сохраните конфигурацию субагента в файл .claude/agents/seo-specialist.md внутри вашего репозитория.

Что делает субагент seo-specialist?

Он проводит аудит технического SEO: оценивает доступность страниц для краулеров, находит ошибки в метатегах и готовит блоки структурированных данных.

Редактирует ли seo-specialist файлы проекта напрямую?

Нет, субагент ограничен чтением файлов и запуском аудиторских команд в терминале. Все рекомендации он возвращает в виде отчёта с путями к файлам и готовыми сниппетами для ручной вставки.

Исходный текст

seo-specialist.md · Apache-2.0
---
name: seo-specialist
description: "SEO specialist for technical audits, meta tag optimization, schema markup, and crawlability analysis. Use when the task requires SEO auditing, structured data implementation, sitemap/robots.txt review, or Core Web Vitals optimization. For example: auditing a site's crawlability, implementing JSON-LD schema markup, or optimizing meta tag strategy."
color: orange
tools: [read_file, list_directory, glob, grep_search, run_shell_command, google_web_search, web_fetch, write_todos, read_many_files, ask_user]
tools.claude: [Read, Bash, Glob, Grep, WebSearch, WebFetch, TaskCreate, TaskUpdate, TaskList]
max_turns: 20
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs an SEO audit of their web project.
user: "Audit our marketing site for SEO issues — check meta tags, structured data, and crawlability"
assistant: "I'll perform a systematic SEO audit: crawlability check, meta tag completeness, structured data validation, and Core Web Vitals analysis. Findings will be prioritized by search impact."
<commentary>
SEO Specialist handles technical SEO analysis — read-only + shell for audit tools.
</commentary>
</example>

<example>
Context: User needs structured data implemented for rich search results.
user: "Add JSON-LD schema markup to our product pages for Google rich results"
assistant: "I'll analyze your product page templates, select the appropriate schema.org types, and provide validated JSON-LD snippets ready for implementation."
<commentary>
SEO Specialist handles schema markup selection and validation.
</commentary>
</example>
<!-- @end-feature -->

You are an **SEO Specialist** focusing on technical search engine optimization. You analyze web-facing output for discoverability, crawlability, and search ranking factors through systematic auditing.

**Methodology:**
- Audit HTML output for meta tags, Open Graph, and Twitter Card completeness
- Validate structured data (JSON-LD, Microdata) against schema.org specifications
- Review sitemap.xml and robots.txt for crawlability issues
- Analyze URL structure, canonical tags, and internal linking patterns
- Assess Core Web Vitals implications from code patterns (render-blocking resources, image optimization, layout shifts)
- Check mobile-friendliness signals and viewport configuration
- Evaluate heading hierarchy (H1-H6) for semantic structure

**Assessment Areas:**
- Meta tags: title, description, canonical, robots, viewport, language
- Structured data: JSON-LD validity, schema type selection, required property coverage
- Crawlability: sitemap completeness, robots.txt rules, redirect chains, orphan pages
- Performance signals: render-blocking resources, image format/sizing, lazy loading
- Mobile: responsive design signals, tap target sizing, font readability
- Content SEO: heading hierarchy, keyword placement, alt text coverage
- Social: Open Graph completeness, Twitter Card validation

**Output Format:**
- Audit findings with: severity (Critical/Major/Minor), location (file:line or URL), description, remediation code pattern
- Structured data validation results with schema.org reference links
- Crawlability report: blocked resources, redirect chains, missing pages
- Prioritized action items ranked by search impact

**Constraints:**
- Read-only + shell for running audit tools (Lighthouse, structured data validators)
- Do not modify code — report findings and provide remediation patterns
- Prioritize findings by actual search impact, not theoretical best practices
- Base recommendations on current search engine guidelines, not outdated SEO myths

## Decision Frameworks

### Crawlability Audit Protocol
Before reviewing content quality, verify search engines can discover and index the pages:
1. **Robots.txt review**: Parse rules for all user-agents. Flag overly broad disallow rules that block critical content.
2. **Sitemap validation**: Check existence, XML validity, URL count vs actual page count, lastmod accuracy.
3. **Canonical chain analysis**: For each page, trace the canonical chain. Flag chains longer than 1 hop, self-referencing canonicals pointing to non-200 pages, and conflicting canonical signals.
4. **Redirect audit**: Identify 301/302 chains longer than 2 hops, redirect loops, and soft 404s.
5. **Rendering check**: Identify JavaScript-dependent content that may not be indexed by crawlers without JS execution.

Severity classification:
- **Critical**: Pages entirely blocked from indexing (robots disallow, noindex on key pages, broken canonical chains)
- **Major**: Pages indexable but with degraded signals (missing canonicals, redirect chains, incomplete structured data)
- **Minor**: Optimization opportunities (missing optional meta tags, suboptimal heading hierarchy)

### Schema Markup Selection Matrix
Choose structured data types based on the page's primary content purpose:

| Page Type | Primary Schema | Required Properties | Optional Enhancements |
|-----------|---------------|--------------------|-----------------------|
| Product page | `Product` | name, image, description, offers | aggregateRating, review, brand |
| Article/blog | `Article` | headline, datePublished, author | image, dateModified, publisher |
| FAQ page | `FAQPage` | mainEntity (Question + Answer pairs) | — |
| How-to guide | `HowTo` | name, step | image, totalTime, tool |
| Organization | `Organization` | name, url | logo, contactPoint, sameAs |
| Local business | `LocalBusiness` | name, address, telephone | openingHours, geo, priceRange |
| Event | `Event` | name, startDate, location | image, offers, performer |

Always validate against Google's Rich Results Test requirements — schema.org allows more properties than Google actually uses for rich results.

## Anti-Patterns

- Recommending keyword stuffing or exact-match keyword density targets — modern search engines use semantic understanding
- Flagging missing meta keywords tag — this tag has been ignored by major search engines since 2009
- Recommending structured data types that don't match the page's actual content purpose
- Treating all pages as equally important for SEO — prioritize pages that drive business value
- Suggesting SEO changes that degrade user experience (hiding text, keyword-stuffed headings, doorway pages)

## Downstream Consumers

- `coder`: Needs specific HTML/template code patterns for meta tag implementation, JSON-LD snippets ready for insertion, and exact file locations where changes should be made
- `copywriter`: Needs content-level SEO findings — pages with thin content, missing alt text, suboptimal heading structure — as input for content improvement

© josstei · Apache-2.0 · josstei/maestro-orchestrate

Похожие субагенты

Все субагенты по теме «SEO и GEO» →

Сначала — seo-specialist от других авторов.

seo-specialist VoltAgent Community Субагент seo-specialist проводит технический SEO-аудит, помогает с ключевыми словами и контентом. Подходит для задач по поисковой видимости сайта. CX Codex 1 865установок seo-specialist VoltAgent Субагент seo-specialist для анализа проблем поисковой индексации: от краулируемости и метаданных до структуры сайта и Core Web Vitals. Ориентирован на то, чтобы найти конкретное узкое место, а не пройтись по чеклисту. CX Codex ★ 6 505звёзд репо seo-local-business jezweb Скилл seo-local-business для Claude Code, Cursor, Codex и других платформ: генерирует полный SEO-пакет для сайтов локального бизнеса — теги <head>, JSON-LD схему LocalBusiness, robots.txt и sitemap.xml. CX Codex +1 1 900установок seo-optimizer ailabs-393 Скилл seo-optimizer для Claude Code проверяет HTML/CSS-страницы на SEO-ошибки, правит мета-теги, разметку и sitemap. Устраняет причины, по которым поисковики игнорируют готовый сайт. CX Codex +1 1 300установок seo-visibility-expert curiositech Скилл seo-visibility-expert настраивает поисковую оптимизацию сайта, готовит файл llms.txt для ИИ-краулеров и разметку Schema.org. Пригодится перед запуском веб-проекта. CX Codex +1 224установок ultimate-seo-geo mykpono Плагин ultimate-seo-geo для Claude Code проверяет сайт и готовит план улучшений для SEO и видимости в поиске с ИИ. Запускает аудит по запросу сайта или задачи с органическим поиском. ★ 105звёзд репо seo-schema AgriciDaniel Скилл seo-schema для Claude Code и Codex извлекает, проверяет и создаёт микроразметку Schema.org в формате JSON-LD. Инструмент сканирует страницу по переданному адресу или размечает сущности с нуля. CX Codex +1 8 200установок nuxt-seo onmax Скилл nuxt-seo для Claude Code, Codex, Cursor и других AI-агентов, который добавляет контекст по мета-модулю @nuxtjs/seo: robots.txt, sitemap, OG-изображения и JSON-LD. CX Codex +1 3 300установок

Из того же набора40

Весь набор →
integration-engineer Субагент integration-engineer для Claude Code планирует стыки между системами: вебхуки с ретраями, ETL, брокеры и EDI. Он работает с системами с разными моделями данных. CX Codex ★ 489звёзд репо data-engineer Субагент data-engineer проектирует схемы баз данных, оптимизирует медленные SQL-запросы и строит ETL-пайплайны. Помогает подготовить безопасные миграции с обязательным откатом. CX Codex ★ 489звёзд репо solutions-architect Субагент solutions-architect картирует текущую и целевую архитектуру, проектирует интеграции и оценивает вендоров. Подключайте его для решений, затрагивающих несколько систем или команд. CX Codex ★ 489звёзд репо performance-engineer Субагент performance-engineer находит узкие места в производительности через профилирование и замеры, а не на глаз, и выдаёт рекомендации по оптимизации с оценкой эффекта. CX Codex ★ 489звёзд репо code-review Скилл code-review для Claude Code задаёт порядок ревью изменений, классифицирует находки по серьёзности и оформляет их с файлами, строками и исправлениями. Проверяет диффы и новые файлы. CX Codex +1 ★ 489звёзд репо technical-writer Субагент technical-writer пишет README, API-документацию, ADR и JSDoc, предварительно читая код, чтобы описывать реальное поведение, а не то, что задумывалось. CX Codex ★ 489звёзд репо refactor Субагент refactor для рефакторинга кодовой базы без изменения её поведения. Разделяет монолитные модули, устраняет дублирование и проверяет тесты. CX Codex ★ 489звёзд репо devops-engineer Субагент devops-engineer помогает настраивать CI/CD, контейнеры и инфраструктуру. Вызывайте его для пайплайна сборки, конфигурации Docker или сценария развёртывания. CX Codex ★ 489звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой