Set up structured data with Hermes Agent
Setting up structured data with Hermes Agent means asking Nous Research's open-source agent from a terminal or chat app to review your StoreSEO JSON-LD schema types and send complete settings once you agree.
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?
You talk to Hermes from a terminal or from Telegram, Discord or Slack, and ask which structured data your Shopify store publishes. Hermes calls storeseo_start, then storeseo_list_schema_types, and answers with each schema type, its on or off state and whether it takes settings. The storeseo entry sits in the mcp_servers block of config.yaml with auth: oauth, so the sign-in was done once with hermes mcp login and Hermes refreshes the tokens itself. If you edited that file during a session, start a new one or run /reload-mcp first.
Configuring a type follows the same read-then-write order every time. Hermes calls storeseo_get_schema_settings, which returns the current settings and the field template, edits the object with the details you provide and shows you the complete result. Only after your yes does it call storeseo_update_schema_settings, which replaces the stored settings instead of merging them. Hermes keeps memory across sessions, so a later conversation can start from what it learned: which types you switched on last week, or that you want the organization logo to stay as it is. It still reads the current settings again before writing, because the store may have changed.
Hermes also has hermes cron, which runs a prompt on a schedule and delivers the answer to a chat target. A weekly job that lists the schema types and reports any that are off is a sensible use. The run has nobody to confirm a write, so the prompt should be limited to the list and get tools. Changes wait for a chat you can answer.
-
You: Which schema types does my store publish today?
- storeseo_start read-only
- storeseo_list_schema_types read-only
- storeseo_get_schema_settings read-only
-
Hermes Agent: Product schema is on and review is off. Review needs product on, which it is. Shall I send its settings and switch review schema on?
-
You: Yes, enable it.
- storeseo_update_schema_settings needs approval
What to ask Hermes Agent
Use StoreSEO to list my JSON-LD schema types, then tell me which ones are off and which take settings.
Read my product schema and review schema settings. Remember that review needs product schema on, and do not change anything yet.
Set up organization schema from my business details. Show me the full settings object and wait for my yes.
- Which JSON-LD schema types are enabled on my store?
- Set up organization schema with my business name, logo and contact email. Read the current settings first.
- Turn on product schema and review schema.
- Is local business schema configured? Show me what is missing.
- Enable FAQ schema for products if my plan includes it.
What StoreSEO does: structured data (json-ld)
StoreSEO adds JSON-LD schema to your storefront so search engines and AI assistants can read your products, business and FAQs as data. The agent lists every schema type, reads a type's settings and its field template, and sends back a complete settings object.
Requires: The FAQ schema types need the FAQ Schema feature in your plan.
- 1
List the schema types
The agent lists every type with whether it is on and whether it takes settings. Configurable types are product, review, sale dates, product merchant, organization and local business.
- 2
Read before writing
For a configurable type it reads the current settings and the field template, because an update replaces the whole settings object rather than merging into it.
- 3
Fill in your details
Business name, address, contact details and similar fields come from you. Organization and local business share the same business information, so changing one changes both.
- 4
Switch it on
After your yes the agent sends the complete settings with the status. Organization, local business and product merchant need complete settings to be enabled.
Structured data (JSON-LD) reference
| Configurable types | Product, review, sale dates, product merchant, organization, local business |
|---|---|
| Toggle-only types | Every other type, including the four FAQ types |
| Update behaviour | Settings replace the stored object; read first, then send the full object |
| Dependencies | Review, sale dates and product merchant need product schema on; disabling product also disables product merchant |
| Shared data | Organization and local business share basic business information |
| FAQ types | Product, collection, article and page FAQ need the FAQ Schema feature in your plan |
| Sale dates | Also needs a discount permission that only the app's own Sale Dates toggle can request |
Rules Hermes Agent follows
- The agent reads the current settings before every settings update, because the update replaces them wholesale.
- Business details come from you; the agent does not invent an address, phone number or opening hours.
- Turning a schema type on or off changes your live storefront markup, so the agent confirms the change first.
- When a type is refused for a missing plan feature or dependency, the agent says which one rather than retrying.
In Hermes Agent
Hermes only sees the storeseo server in a session started after config.yaml changed, so start a new session or run /reload-mcp before you blame the connection. A token kept in config.yaml for a machine with no browser is a secret, so keep the file out of version control and revoke the token in StoreSEO under Settings, AI Toolkit if it leaks. A hermes cron job cannot wait for your yes, so give a scheduled schema check only reads and say it must not call the update tool. The record for Hermes does not document its own tool-approval controls, so treat StoreSEO's confirmation as an instruction the agent follows, and use the include and exclude lists to expose only the list and get tools to a read-only agent.
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
Will Hermes Agent remember my business details for schema settings?
Hermes keeps memory across sessions, so it may recall details you gave it before. It should still read the current StoreSEO settings before an update, because the update replaces the stored object.
Can a hermes cron job change schema settings?
Keep it from doing so. A scheduled run has nobody to say yes, so ask it to list types and read settings only, and make changes in a chat you can answer.
What schema types can StoreSEO add to my store?
StoreSEO manages product, review, sale dates, product merchant, organization and local business schema with settings, plus toggle-only types such as the FAQ types for products, collections, articles and pages.
Why does the agent read my schema settings before changing them?
A settings update replaces the whole stored object instead of merging. Reading first and sending back the complete object is the only way to change one field without wiping the others.
Why was review schema refused?
Review, sale dates and product merchant schema depend on product schema. Turn product schema on first, then enable the dependent type.
Do I need a particular plan for FAQ schema?
Yes. The four FAQ schema types need the FAQ Schema feature in your StoreSEO plan. Without it, any change to them is refused with a message saying the feature is not in your plan.
Keep going
Structured data (JSON-LD) with other agents
More Hermes Agent guides