Audit your store's SEO with Hermes Agent
Auditing your store's SEO with Hermes Agent means the Nous Research agent reads StoreSEO's scores for you, from a terminal or a chat app, and reports the lowest-scoring products, collections, pages and posts with what each one is missing.
Last updated: October 2026
Set up Hermes Agent for StoreSEO
Skip this if Hermes Agent is already connected. The full guide, with the alternatives, is on the Hermes Agent page.
- 1
Add StoreSEO to config.yaml
Add this under mcp_servers in ~/.hermes/config.yaml. If the file already has an mcp_servers block, add only the storeseo entry. Then start a new Hermes session, or run /reload-mcp in the one that is open.
YAMLmcp_servers: storeseo: url: "https://mcp.storeseo.com/mcp" auth: oauth - 2
Sign in to your store
On first connect Hermes prints an authorize URL and waits for the sign-in. Run this command to start it yourself or to re-authorize later. Pick your Shopify store and approve. Hermes caches the tokens in ~/.hermes/mcp-tokens/storeseo.json.
Terminalhermes mcp login storeseo
How does this work in Hermes Agent?
Hermes Agent runs from a terminal or from chat apps such as Telegram, Discord and Slack, and keeps memory across sessions. With storeseo under mcp_servers in ~/.hermes/config.yaml and signed in through hermes mcp login storeseo, you start a session or run /reload-mcp and ask which ten products score worst. Hermes calls storeseo_start first, because every other StoreSEO tool needs the conversation id it returns, then storeseo_list_resources sorted by score, lowest first, and storeseo_get_resource_seo for each candidate. All are reads. The answer names failing criteria by their visible titles and separates what a StoreSEO tool can fix from what only you can change in the app, such as the focus keyword.
Because Hermes remembers across sessions, an audit becomes a running baseline. You can ask it to compare today's worst ten with the list it gave you last week, or to note which products you decided to fix. Products carry a GEO score for AI readiness as well, so you can ask which listings AI shopping agents will struggle with. When the list is long, ask for pages of ten or twenty, and ask it to stop at a score threshold.
The scheduler is what suits Hermes to auditing. hermes cron create takes a schedule such as every monday 9am and a prompt, and --deliver sends the result to Telegram or another chat target. An audit is exactly the sort of job to hand it: it only reads, and the finished report arrives where you already read messages. When something in the report deserves a fix, answer in a live chat, where the agent can ask and you can say yes.
-
You: Audit my Shopify store and tell me the ten worst products.
- storeseo_start read-only
- storeseo_list_resources read-only
- storeseo_get_resource_seo read-only
-
Hermes Agent: The ten lowest products score between 16 and 33. Most have no meta description, six have images without alt text, and three need a focus keyword, which you set in the StoreSEO app.
-
You: Run this every Monday and send it to Telegram, read only.
-
Hermes Agent: Use hermes cron create with a schedule, a prompt that only reads and --deliver telegram. I will keep the prompt free of preview, apply or generate.
What to ask Hermes Agent
Use StoreSEO to list my ten lowest-scoring products and the top issue on each. Read only.
Compare my current five worst products with the ones you reported last time.
Which products have the weakest GEO score for AI shopping agents, and what is missing?
- Show me my ten lowest-scoring products and the top issue on each.
- Which collections are not optimized yet, and what is failing on them?
- Give me an SEO audit of my blog posts, worst first.
- Which products have the weakest GEO score for AI shopping agents, and why?
- Summarize my store's SEO: how many products, collections, pages and posts are optimized?
- For the product Linen Shirt, list every failing SEO criterion and say which ones StoreSEO can fix.
What StoreSEO does: store seo audit
StoreSEO scores every product, collection, page and blog post against its SEO checklist, and scores products for AI readiness (GEO) as well. An agent opens a session, lists the weakest resources first and reads the per-criterion analysis for each, so you get a ranked worklist instead of a dashboard to click through.
- 1
Open a StoreSEO session
The agent calls the start tool first. It returns a conversation id every later call needs, plus a snapshot of your store: how many resources are optimized, need improvement or are not optimized, image status, rank tracking and which features are set up.
- 2
List the weakest resources
It lists products, collections, pages or articles sorted by score, lowest first, or filtered to the ones marked not optimized. Products also carry a GEO score and their AI-readiness issues.
- 3
Read the checklist for each one
For each candidate it reads the full SEO record: current meta fields, focus keyword, score, every criterion that passes or fails, image status, FAQs and AI snippet.
- 4
Sort fixes by who can make them
It separates what a StoreSEO tool can fix (meta, handle, FAQs, AI snippet, image alt text, schema) from what only you can change in the app or in Shopify admin (the focus keyword, the product title, category, inventory).
- 5
Report a worklist
You get the resources in order, with the failing criteria in plain words and one suggested next fix. Nothing is written during an audit.
Store SEO audit reference
| Resource types | Products, collections, pages and blog articles |
|---|---|
| Scores | An SEO score for every resource, plus a GEO (AI readiness) score for products |
| Status labels | Optimized, needs improvement, not optimized; GEO adds not analysed |
| Sorting | By score, lowest first, or filtered to not optimized |
| Session | Every call carries the conversation id from the start tool; calls without it fail |
| What it writes | Nothing. Every audit tool is read-only |
| Fixed only in the app | Focus keyword choice, product title wording, Shopify category, product type, inventory, variant data |
| Plan | Any active StoreSEO plan, including the free plan |
Rules Hermes Agent follows
- Every audit call is a read and runs straight away; nothing in this job changes your store.
- The agent describes criteria by their visible title, never by internal identifiers or raw status values.
- Criteria no tool can fix, such as choosing the focus keyword, are handed to you with a link into the StoreSEO app rather than guessed.
- The agent should offer one next fix at a time, tied to what it just found, instead of dumping the whole list as a checklist.
In Hermes Agent
A hermes cron job has nobody to say yes, so keep a scheduled audit to reads and reports, and never word the prompt so that it previews, applies or generates anything. After editing config.yaml, start a new session or run /reload-mcp, or the open session will not see storeseo. If you want an audit-only agent, use the tools include list to expose only StoreSEO's list and get tools. Hermes' own tool-approval controls are not described in the docs this page was checked against, so do not count on the client to stop a write.
What runs without asking. Reads such as SEO scores, store listings, settings and Google reports run straight away. Generating a preview spends AI credit but writes nothing, and StoreSEO tells the agent to say what a generation will cost before it runs one. Applying content, optimizing images, changing settings, publishing llms.txt or agents.md, writing a product description and deleting anything wait for your yes in the conversation. That yes is an instruction the agent follows, not a lock on the server, so your client's own tool-approval setting is the hard stop.
Questions
How do I get a weekly StoreSEO audit from Hermes Agent?
Create a cron job with hermes cron create, give it a schedule such as every monday 9am and a read-only prompt, and add --deliver telegram or another chat target so the report arrives in your messages.
Does Hermes Agent remember last week's audit?
Hermes keeps memory across sessions, so you can ask it to compare the current lowest scores with what it reported before. StoreSEO itself is read live each time, so the scores always come from the store.
Does an SEO audit change anything in my store?
No. The audit uses read-only tools: the session start, the resource list and the per-resource SEO record. Your store is only changed later, by a separate step you agree to.
What is the difference between the SEO score and the GEO score?
The SEO score measures a resource against StoreSEO's on-page checklist for search engines. The GEO score applies to products only and measures how ready the product is for AI shopping agents and generative search, using criteria such as FAQs, an AI snippet, alt text and product schema.
Can the agent choose my focus keyword?
No tool can set the focus keyword. The agent can tell you when the keyword is missing or looks wrong and give you a link to set it in the StoreSEO app, and several fixes such as keyword clusters and description writing need it set first.
How many products can the agent audit at once?
The listing is paginated, so the agent can walk your whole catalog page by page. In practice it is more useful to ask for the lowest scores first and work down from there.
Keep going
Store SEO audit with other agents
More Hermes Agent guides