8000 claude-seo/CHANGELOG.md at main · miladahmadim/claude-seo · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
112 lines (91 loc) · 6.05 KB

CHANGELOG.md

File metadata and controls

112 lines (91 loc) · 6.05 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.3.0] - 2026-03-06

Added

  • Extension system: extensions/ directory convention for self-contained add-ons with install/uninstall scripts
  • DataForSEO extension: 22 commands across 9 API modules (SERP, keywords, backlinks, on-page, content, business listings, AI visibility, LLM mentions). Install: ./extensions/dataforseo/install.sh
  • DataForSEO integration: seo-audit, seo-content, seo-geo, seo-page, seo-plan, seo-technical auto-detect DataForSEO MCP tools for enriched analysis
  • Plugin manifest: .claude-plugin/plugin.json for official plugin directory submission
  • Documentation: Extensions architecture in ARCHITECTURE.md, 22 new commands in COMMANDS.md, updated MCP integration guide

Fixed

  • Title tag threshold: Pre-commit hook now uses 60-char max, aligned with quality-gates.md and echo message
  • SSRF prevention: Added to capture_screenshot.py (defense-in-depth, matching fetch_page.py)
  • Frontmatter cleanup: Removed non-standard allowed-tools from main SKILL.md

Changed

  • Sub-skill count: 12 + 1 extension (added seo-dataforseo via DataForSEO extension)
  • Subagent count: 6 + 1 optional (added seo-dataforseo agent via extension)
  • DataForSEO promoted from "Community" to "Official extension" in MCP docs

[1.2.0] - 2026-02-19

Security

  • SSRF prevention: Added private IP blocking to fetch_page.py and analyze_visual.py
  • Path traversal prevention: Added output path sanitization to capture_screenshot.py and file validation to parse_html.py
  • Install hardening: Removed --break-system-packages, switched to venv-based pip install
  • requirements.txt: Now persisted to ~/.claude/skills/seo/ for user retry

Fixed

  • YAML frontmatter parsing: Removed HTML comments before --- delimiter in 8 files (skills: seo-content, seo-images, seo-programmatic, seo-schema, seo-technical; agents: seo-content, seo-performance, seo-technical). Thanks @kylewhirl for identifying this in the codex-seo fork.
  • Windows installer: Merged @kfrancis improvements — python -m pip, py -3 launcher fallback, requirements.txt persistence, non-fatal subagent copy, better error diagnostics (PR #6)
  • requirements.txt missing after install: Now copied to skill directory so users can retry (#1)

Changed

  • Python dependencies now installed in a venv at ~/.claude/skills/seo/.venv/ with --user fallback (#2)
  • Playwright marked as explicitly optional in install output
  • Windows installer uses Resolve-Python helper for robust Python detection (#5)

[1.1.0] - 2026-02-07

Security (CRITICAL)

  • urllib3 ≥2.6.3: Fixes CVE-2026-21441 (CVSS 8.9) - decompression bypass vulnerability
  • lxml ≥6.0.2: Updated from 5.3.2 for additional libxml2 security patches
  • Pillow ≥12.1.0: Fixes CVE-2025-48379
  • playwright ≥1.55.1: Fixes CVE-2025-59288 (macOS)
  • requests ≥2.32.4: Fixes CVE-2024-47081, CVE-2024-35195

Added

  • GEO (Generative Engine Optimization) major enhancement:
    • Brand mention analysis (3× more important than backlinks for AI visibility)
    • AI crawler detection (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, etc.)
    • llms.txt standard detection and recommendations
    • RSL 1.0 (Really Simple Licensing) detection
    • Passage-level citability scoring (optimal 134-167 words)
    • Platform-specific optimization (Google AI Overviews vs ChatGPT vs Perplexity)
    • Server-side rendering checks for AI crawler accessibility
  • LCP Subparts analysis: TTFB, resource load delay, resource load time, render delay
  • Soft Navigations API detection for SPA CWV measurement limitations
  • Schema.org v29.4 additions: ConferenceEvent, PerformingArtsEvent, LoyaltyProgram
  • E-commerce schema updates: returnPolicyCountry now required, organization-level policies

Changed

  • E-E-A-T framework: Updated for December 2025 core update - now applies to ALL competitive queries, not just YMYL
  • SKILL.md description: Expanded to leverage new 1024-character limit
  • Schema deprecations expanded: Added ClaimReview, VehicleListing (June 2025)
  • WebApplication schema: Added as correct type for browser-based SaaS (vs SoftwareApplication)

Fixed

  • Schema-types.md now correctly distinguishes SoftwareApplication (apps) vs WebApplication (SaaS)

[1.0.0] - 2026-02-07

Added

  • Initial release of Claude SEO
  • 9 specialized skills: audit, page, sitemap, schema, images, technical, content, geo, plan
  • 6 subagents for parallel analysis: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual
  • Industry templates: SaaS, local service, e-commerce, publisher, agency, generic
  • Schema library with deprecation tracking:
    • HowTo schema marked deprecated (September 2023)
    • FAQ schema restricted to government/healthcare sites only (August 2023)
    • SpecialAnnouncement schema marked deprecated (July 31, 2025)
  • AI Overviews / GEO optimization skill (seo-geo) - new for 2026
  • Core Web Vitals analysis using current metrics:
    • LCP (Largest Contentful Paint): <2.5s
    • INP (Interaction to Next Paint): <200ms - replaced FID on March 12, 2024
    • CLS (Cumulative Layout Shift): <0.1
  • E-E-A-T framework updated to September 2025 Quality Rater Guidelines
  • Quality gates for thin content and doorway page prevention:
    • Warning at 30+ location pages
    • Hard stop at 50+ location pages
  • Pre-commit and post-edit automation hooks
  • One-command install and uninstall scripts (Unix and Windows)
  • Bounded Python dependency pinning with CVE-aware minimums (lxml >= 5.3.2)

Architecture

  • Follows Anthropic's official Claude Code skill specification (February 2026)
  • Standard directory layout: scripts/, references/, assets/
  • Valid hook matchers (tool name only, no argument patterns)
  • Correct subagent frontmatter fields (name, description, tools)
  • CLI command is claude (not claude-code)
0