How to Use Google keyword difficulty in Hermes
Returns a 0 to 100 score for the difficulty of reaching Google's top 10 organic results for each keyword. Use it to compare ranking difficulty across an existing keyword shortlist.
Prompts to try with Google keyword difficulty in Hermes
Copy an example into Hermes, or ask in your own words.
Each month, use Google keyword difficulty for 'trail running shoes', 'waterproof running shoes', and 'running shoes for beginners' for English searches in the United States. Report score changes from the previous check.
Every Monday at 9am: use Google keyword difficulty to look this up and give me the result as a table.
Pull the latest numbers from Google keyword difficulty and tell me what changed since last week.
Check Google keyword difficulty and summarize what you find in three bullet points.
Pull the newest data from Google keyword difficulty and give me the result as a table.
How to set up Google keyword difficulty in Hermes
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Hermes this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Add the server and sign in
Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
hermes mcp add spiral \ --url https://api.spiral.ai/mcp \ --auth oauth \ --connect-timeout 300
- Check it
In a chat that was already open, run /reload-mcp.
hermes mcp list hermes mcp test spiral
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Google keyword difficulty
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "dataforseo/keywords/difficulty", "input": { "keywords": [ "<keywords>" ], "language_code": "<language_code>", "location_code": 1 } }'
Then paste one of the prompts above: Hermes finds Google keyword difficulty on Spiral, shows the price and runs it.
Google keyword difficulty providers and prices
Spiral runs Google keyword difficulty through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Hermes for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Location code | a number | DataForSEO location code, such as 2840 for the United States. Use this or location_name. |
Every API field of DataForSEO · Keyword difficulty is on its tool page: open its card above.
What can you do with Google keyword difficulty in Hermes?
Maintain a monthly keyword research digest for a defined market and topic. Compare newly returned DataForSEO phrases and metrics with earlier results to flag changes worth an editor's review.
Choose the next articles to commission
Expand running shoe topics with category ideas and longer phrases. Compare search demand and organic difficulty, then use intent labels to separate buying guides from informational articles.
Plan ecommerce category pages
Research terms around espresso machines, including related product categories and specific buying queries. Use demand, difficulty, and search intent to propose category pages and supporting guides.
Compare keyword opportunities across markets
Research English-language standing desk queries separately for the United States and United Kingdom. Compare discovered phrases, demand, and country-specific difficulty, then classify the shortlisted terms by intent.
Prioritize existing content updates
Take the topics from an existing cycling guide library and look for related searches and more specific phrases. Combine demand, difficulty, and intent with your content inventory to recommend which pages to expand first.
Build a help center topic backlog
Expand spreadsheet topics into related subjects and detailed questions. Classify informational searches and compare their organic difficulty before proposing tutorial briefs.
More on Google keyword difficulty and Hermes
Overview
Google keyword difficulty in other agents
Questions about Google keyword difficulty in Hermes
Can Hermes use Google keyword difficulty?
Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Google keyword difficulty like any built-in tool.
How much does Google keyword difficulty cost in Hermes?
Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.
Do I need an Alexandria account to use Google keyword difficulty in Hermes?
No. Spiral runs Google keyword difficulty on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Google keyword difficulty in Hermes?
About two minutes: add the server and sign in, then check it.
Does Hermes wait while Google keyword difficulty runs?
Google keyword difficulty runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.
How fresh is DataForSEO's keyword data?
The keyword database follows a monthly refresh cycle tied to Google Ads. Search results used by DataForSEO Labs refresh on a separate cycle of 30 to 90 days, depending on the query and location.
Are search volumes exact counts for each phrase?
Google groups similar keywords and can report their combined search volume. That makes these figures unsuitable for measuring small differences between closely related spellings or phrases.
Does competition mean organic ranking difficulty?
Google Ads competition measures competition among advertisers in paid search. Organic difficulty is a separate DataForSEO score from 0 to 100 for reaching Google's top 10 organic results.
How much monthly history is available?
Google Ads keyword search volume offers up to four years of history. Keyword discovery results include a shorter history covering the previous 12 months.
Does DataForSEO cover every country?
No. DataForSEO says locations in Russia and Belarus are no longer supported across its services.
Start using Google keyword difficulty in Hermes
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Hermes:
set up https://spiral.ai/SKILL.md


