Compare Keywords Before You Write

Compare search phrases for one country. See estimated monthly searches, how hard each may be to appear near the top of unpaid results, and what people may be looking for. When available, view the cost per ad click and estimated visits to the page at the top from all searches it appears for. Figures are estimates; some may be missing.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use the Ahrefs Keyword Metrics tool in Toolmu with my existing connection. If the connection is missing, follow https://toolmu.com/SKILL.md. Ask me for one country and the search phrases only if either is missing. I can give the full country name; convert it to the two-letter form this tool needs, and ask me if the country is unclear. Do not ask me to type a code. Treat phrases separated by commas, semicolons or new lines as separate items and keep their wording. Use one country and 1–100 phrases per request. If I provide more than 100, ask me to narrow the list instead of starting extra requests. Explain monthly search volume as an estimate based on the latest known data, not a count of unique people. Describe difficulty as an estimate of reaching the top 10 unpaid results on a 0–100 scale; it is not ad competition or a ranking promise. Explain what people may be looking for based on the returned intent information. The top page’s estimated visits cover all searches it appears for, not just one phrase or my own site traffic. Include ad cost per click only when returned. Use a currency or convert only when this Tool clearly supplies its unit; otherwise say the unit is not provided. Mark missing values as unavailable, never zero. Stay within my existing spending authorization and do not run extra requests automatically.

Task:
Compare [coffee maker], [drip coffee maker] and [small kitchen coffee maker] in [United States]. Show how often each is searched monthly, how hard it may be to appear near the top of Google results without ads, what people want, visits to the top page, and what an ad click may cost if available.

Paste into your connected AI's conversation.

Connection guide

Up to 15.12 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Ahrefs

Compare Keywords Before You Write

You receive

Get metric records for the returned keywords in your selected country. Your Agent can compare demand and organic ranking difficulty, then add the leading page's traffic potential, intent and advertising CPC as context for the shortlist.

Start with your task

Compare [coffee maker], [drip coffee maker] and [small kitchen coffee maker] in [United States]. Show how often each is searched monthly, how hard it may be to appear near the top of Google results without ads, what people want, visits to the top page, and what an ad click may cost if available.

What to know

Some metrics may be missing, and the request does not guarantee a fresh measurement. Estimates do not promise rankings or future traffic; keep unavailable values distinct from zero.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `country, keywords`
Search country`queryParams.country`	`string`	Required	Required two-letter ISO 3166-1 alpha-2 country code, such as us. Selects the search market for the requested keyword metrics; there is no default country. Minimum length `2` Maximum length `2`
Keyword array`queryParams.keywords`	`array`	Required	Required array of 1–100 non-empty strings, for example ["keyword difficulty checker", "keyword search volume"]. Supply separate array entries rather than a comma-separated string. Minimum items `1` Maximum items `100`
[]`queryParams.keywords[]`	`string`	—	Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "country",
        "keywords"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "country": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Two-letter country code (ISO 3166-1 alpha-2), e.g. 'us'."
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "maxItems": 100,
          "minItems": 1,
          "description": "Keywords to analyze (up to 100). Each returned keyword is one billed row."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Search volume estimates average monthly searches in the selected country over Ahrefs' latest known 12 months of data. It is not necessarily the latest month's volume. A keyword may have more than one search-intent label.

The Agent's comparison or shortlist is additional analysis of the returned records. Keep missing metrics visible and consider intent alongside demand and difficulty before choosing a topic. This request measures a supplied list; it does not generate new keyword ideas.

Ahrefs keyword metric definitions

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Ahrefs KD estimates how hard it is to reach the top 10 organic results on a 100-point scale. It is not paid-ad competition, and a low score does not guarantee a ranking.

Compare Keywords Before You Write

Compare Keywords Before You Write

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Compare coffee maker searches

Choose a gardening article topic

Compare headphone searches

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Compare coffee maker searches

Choose a gardening article topic

Compare headphone searches

Questions about this tool.

What does Keyword Difficulty measure?

Is traffic potential the traffic this keyword will bring me?

How should CPC be displayed?