222a/claude-marketplace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
claude-marketplace/plugins/222a-seo-audit/commands/222a-issue.md

2.9 KiB
Raw Permalink Blame History

description argument-hint
Разбор одной проблемы из аудита (URL + рекомендации + evidence) <issue_code> [audit_run_id]

Пользователь хочет разобрать конкретную проблему. Аргументы: $ARGUMENTS (первый — issue_code, опциональный второй — audit_run_id).

Шаги

  1. Распарсить аргументы:

    • Первое слово — issue_code (например seo.duplicate_title, tech.internal_broken_link, perf.no_compression).
    • Второе слово (если есть) — audit_run_id.
    • Если issue_code пустой — попроси пользователя указать.
    • Если audit_run_id пустой — возьми последний completed аудит через list_audits.

  2. Получить страницы с проблемой:

    • Вызови get_issue_pages с audit_run_id и issue_code.
    • Покажи список URL с их статусом (HTTP code, title если есть).

  3. Получить рекомендации:

    • Вызови get_issue_remediation с audit_run_id и issue_code.
    • Покажи рекомендации.

  4. Разобрать evidence:

    • В ответах get_issue_pages инспектируй evidence_type и evidence[]:
      • GSC CTR issues → gsc_page_metrics
      • Yandex position drops → yandex_webmaster_queries
      • Site-level sitemap → sitemap_discovery
      • duplicate_h1 → duplicate_h1_groups
      • near_duplicate → near_duplicate_groups
      • URL issues → url_samples / mixed_case_groups
      • hreflang → hreflang_*
    • Page-level checks (schema, og, viewport, redirect_chain, perf., viewport_bad, js_errors, content.missing_, tap_targets_small, font_too_small, heading_hierarchy_broken) → per-page data с конкретной находкой.
    • Покажи пользователю самые важные эвиденсы.

  5. Особый случай tech.internal_broken_link vs tech.target_not_crawled:

    • Если код tech.target_not_crawled — НЕ называй это «битыми ссылками». Это страницы, обнаруженные но не закраленные (по max_pages_cap или robots_disallowed).
    • Рекомендация: увеличить max_pages (особенно если top_uncrawled_targets[].incoming_count высокий — это популярные URL в навигации/футере) или поправить robots.txt.

  6. Сохранить артефакт:

    • Если есть mcp.write — вызови save_audit_artifact с типом seo_recommendations или developer_tasks (зависит от природы проблемы), source="claude-code".