Track keyword rankings with Hermes Agent
Tracking keyword rankings with Hermes Agent means using Nous Research's open-source agent, from a terminal or a chat app, to manage StoreSEO's Google rank tracker, with its memory carrying your keyword plan across sessions and hermes cron delivering a ranking report on a schedule.
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 run Hermes in a terminal or reach it from Telegram, Discord or Slack, and you describe the keywords you want to follow. Hermes opens a StoreSEO session with storeseo_start, calls storeseo_list_rank_locations and storeseo_list_rank_languages to get the exact country and language names, and tells you the rows it would add, for example linen shirt for United States, English, desktop. When you answer yes it calls storeseo_add_keywords. The first Google check is queued in the background, so a fresh keyword has no position until storeseo_list_keywords shows one.
Hermes keeps memory across sessions, which suits a job that unfolds over weeks. You can tell it which keywords you care about and why, and in a later session ask how they moved. It reads storeseo_list_keywords for the latest position, change, SERP features and competitor positions, and storeseo_get_keyword_history for the dated trail of one keyword. storeseo_list_competitors shows the domains you track, up to five, and a new one goes in through storeseo_add_competitors after your yes.
For a standing report, hermes cron create takes a schedule and a prompt and delivers the answer to a chat target such as Telegram. Write that prompt as reads only, because a scheduled run has nobody to approve a write. Rank and competitor tracking are Pro plan tools, and the tracker covers Google, not AI search engines.
-
You: How did my tracked keywords move this month?
- storeseo_start read-only
- storeseo_list_keywords read-only
-
Hermes Agent: Five keywords are tracked. Two climbed, two fell and one is still pending its first check. Want a competitor comparison for the two that fell?
-
You: Yes please.
- storeseo_list_competitors read-only
- storeseo_get_keyword_history read-only
-
Hermes Agent: Both competitors you track gained ground on those two keywords in the last three checks.
What to ask Hermes Agent
Use StoreSEO to list my tracked keywords and summarize which ones are climbing and which are falling. Remember my top three keywords for next time.
Look up the exact names for Canada and French in the rank tracker, then ask me before adding linen shirt as a mobile keyword.
Schedule a Monday 9am hermes cron job that reports my keyword position changes to Telegram. Reads only, no adds or deletes.
- Track shopify linen shirts and linen shirt for men in the United States on mobile.
- How have my tracked keywords moved this month, and where do my competitors rank?
- Show the rank history for organic cotton tote since July.
- Add example-competitor.com as a competitor.
- Build a keyword cluster for my best seller and tell me the estimated credit first.
- Which tracked keywords dropped out of the top ten?
What StoreSEO does: keyword rank tracking
StoreSEO checks your Google rank for tracked keywords by country, language and device, records the history and compares competitor domains. Keyword clusters group related keywords around a product's focus keyword with search volume and difficulty.
Requires: Rank and competitor tracking are Pro plan tools. Keyword clusters spend AI Content Optimizer credit.
- 1
Pick the market
The agent looks up the exact country and language names the tracker accepts, because new keywords must use them verbatim.
- 2
Add keywords
After your yes it adds keywords with a country, language and device. Checks run in the background, so positions appear later.
- 3
Read ranks and history
It lists your keywords with the latest Google position, change, SERP features and competitor positions, and reads the dated history for any keyword.
- 4
Compare competitors
Up to five competitor domains are tracked alongside your keywords. To change one, it is deleted and the new domain added.
- 5
Build a cluster
For a product with a focus keyword, StoreSEO generates a cluster of related keywords in the background; the agent states the estimated credit first and polls until it is ready.
Keyword rank tracking reference
| Search engine | Google; AI search engines are not tracked |
|---|---|
| Locations | 213 countries, country level only |
| Languages | 127 languages |
| Devices | Desktop or mobile |
| Competitors | Up to five domains; no edit, delete and re-add |
| Keyword limit | Counts against your plan's keyword limit |
| Deleting a keyword | Removes its entire rank history; cannot be undone |
| Keyword cluster | Built around the product's existing focus keyword, sorted by search volume, with relevance and difficulty |
| Plan | Pro plan for rank and competitor tools |
Rules Hermes Agent follows
- On a plan without rank tracking, the agent explains the upgrade instead of calling the rank tools.
- Country and language names come from the lookup tools, never typed from memory.
- Deleting a keyword or competitor erases its history for good, so the agent confirms each one.
- A cluster needs a focus keyword set in the StoreSEO app; the agent states the estimated credit and waits for your yes.
In Hermes Agent
Start a new Hermes session or run /reload-mcp after editing config.yaml, otherwise the open session does not see the storeseo server. If you want a read-only rank agent, use Hermes' tools include list to expose only the StoreSEO list and get tools, which keeps storeseo_delete_keyword out of reach. A scheduled hermes cron run cannot wait for a yes, so keep it to reads and ask for adds and deletes in a chat you can answer. If you connect with a personal access token, it sits in config.yaml, so keep that file out of version control.
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
Does Hermes Agent remember my tracked keywords between sessions?
Hermes keeps memory across sessions, so you can tell it which keywords matter and ask later how they moved. The positions themselves always come from StoreSEO's tracker, read with storeseo_list_keywords.
How do I get a weekly ranking report from Hermes?
Create a hermes cron job with a schedule, a read-only prompt and a delivery target such as Telegram. The job reads your keyword positions and history through StoreSEO and sends the summary to the chat.
Which plan do I need for keyword tracking through an agent?
Rank tracking and competitor tracking are Pro plan tools. On other plans the agent should explain that instead of calling them. Keyword clusters work on plans with AI Content Optimizer credit.
Does StoreSEO track rankings in AI search engines?
No. The rank tracker checks Google results by country, language and device. AI visibility is handled by the GEO score, llms.txt and agents.md jobs instead.
Why are new keywords pending?
Rank checks run in the background. Adding a keyword queues the first check, and its position appears in the keyword list once that check completes.
What is a keyword cluster?
A group of related keywords built around a product's focus keyword, sorted by search volume and scored for relevance and difficulty. It shows which wider terms the product page can target.
Keep going
Keyword rank tracking with other agents
More Hermes Agent guides