yuzushi-dev / hermes-seo

# Hermes SEO
Hermes SEO is a native Hermes plugin port of SEO workflows from Claude SEO v2.4.2. It includes 25 workflow skills plus the `seo` router, 19 specialist role skills, 56 utility scripts, Schema.org templates, and optional integrations. Claude SEO was created by Daniel Agrici. See credits for upstream attribution and media notes.
This independent community plugin is maintained at yuzushi-dev/hermes-seo. It is listed in the Hermes plugin catalog. Release v0.1.0 remains available.
## What it does
The plugin helps Hermes inspect websites, prepare SEO recommendations, validate or draft structured data, and run focused workflows for content, local search, international SEO, and AI search visibility. Its skills guide the analysis; bundled utilities handle specific checks and transformations.
The map below groups the 25 workflow skills. Provider integrations are optional, and Google OAuth workflows remain disabled because Hermes does not yet provide a profile-scoped authorization route.
## Install
Install the released commit from GitHub with Hermes' Git installer:
 [code] 
The `--ref` value pins the install to the v0.1.0 commit. `--yes-deps` consents to installing the plugin's declared Python dependencies, including in non-interactive shells. The plugin registers namespaced skills such as `hermes-seo:seo-audit` and `hermes-seo:role-seo-technical`; use `skills_list` and `skill_view` to discover or load them. The `hermes-seo:seo` skill routes general SEO requests. The runtime commands are `hermes seo setup`, `hermes seo doctor`, and `hermes seo run`.
`hermes seo setup` creates a private virtual environment and downloads pinned Python packages. Browser setup also downloads Chromium and may use substantial disk space. Setup is user initiated. `hermes seo doctor --json` checks readiness without changing the system. Use `hermes_seo_run` for credentialed utilities and `hermes seo run ` for noncredentialed utilities. Both run through the isolated environment and script allowlist.
## Main workflows
| Workflow | Skill | Use it for |
| --- | --- | --- |
| Site audit | `hermes-seo:seo-audit` | Site-wide findings and priorities |
| Technical SEO | `hermes-seo:seo-technical` | Crawlability, indexing, and technical checks |
| Page review | `hermes-seo:seo-page` | On-page analysis of one URL |
| Content brief | `hermes-seo:seo-content-brief` | Planning a page around a topic |
| Structured data | `hermes-seo:seo-schema` | Inspecting, validating, or drafting Schema.org JSON-LD |
| AI search | `hermes-seo:seo-geo` | Generative Engine Optimization analysis |
| Local SEO | `hermes-seo:seo-local` | Local visibility and business profile checks |
| Strategy | `hermes-seo:seo-plan` | SEO planning for a site or business type |
## Example requests
Ask Hermes in natural language, for example:
- “Run `hermes-seo:seo-audit` on `https://example.com` and give me the highest-priority findings with evidence.”
- “Use `hermes-seo:seo-schema` to inspect the JSON-LD on `https://exa