Table of contents:
The Friction Isn’t the Design. It’s the Philosophy
There is a pattern that most SEO professionals follow without really thinking about it.
You pull a keyword list from Ahrefs.
You export it to a CSV.
You upload the CSV to a clustering tool and wait for it to process.
You download the results.
You open a spreadsheet and start interpreting clusters. You open a separate AI tool to help you figure out which clusters to prioritise and what to write.
You brief a writer or write the content yourself.
Each of those steps is a handoff.
Each handoff is friction.
And friction is where time disappears.
A few weeks ago, Hank Azarian, a full stack marketer who runs agent orchestrated workflows, posted this on a LinkedIn thread.

So naturally I responded and asked to clarify.
So he followed up with this:

Hank was right.

And his comment is exactly why we built the Keyword Insights skill for Claude.
We have just shipped something that removes most of those handoffs.
Keyword Insights now has a native skill for Claude, Anthropic’s AI assistant, and it changes the way the full workflow can run.
Instead of moving between tools, you have a single conversation.
Your keywords go in, your content strategy and drafts come out, and Claude handles the orchestration in between.
This article explains what the skill is, how it works, what it can actually do, and why it is worth adding to your workflow whether you are an SEO consultant, a content team lead, or an agency scaling up client deliverables.
What Is the Claude Skill?
Claude is an AI assistant built by Anthropic.
Unlike a lot of AI tools, Claude is particularly good at reasoning through complex multi step tasks, working with structured data, and following precise instructions without going off script.
It has become a popular choice for SEOs who use it to interpret data, draft content, and manage workflows.

The Keyword Insights skill is a deep integration that gives Claude direct access to the full Keyword Insights API.
This means Claude does not just talk about SEO strategy in the abstract.
It can actually run your keyword clustering jobs, classify search intent, generate content briefs, and trigger the Writer Agent on your behalf, all in real time, using live SERP data.
When you connect the skill, Claude becomes a conversational interface for the entire KI platform.
You tell it what you want to do in plain English. It figures out the right API calls to make, submits the order, waits for it to complete, and returns your results, formatted and ready to act on.
The Problem It Solves
To understand why this is useful, it helps to think clearly about where time actually goes in a keyword research workflow.
The analysis itself takes a few minutes.
The clustering takes a few minutes. But the time in between?
Moving files around. Waiting for exports.
Interpreting a spreadsheet with 1,200 rows and 40 columns.
Deciding which clusters are relevant to the site’s existing content.
Figuring out which clusters represent quick wins versus long term plays.
Briefing a writer on what the content should cover.
That middle layer, the interpretation and decision making layer, is where most of the hours go. And historically it has been entirely manual, because the tools that produce the data are separate from the tools that help you think about it.
Here’s a look at the traditional workflow versus the new, conversational approach:
| Traditional Workflow (The Old Way) | Conversational Workflow (The New Way) |
|---|---|
| 1. Export 1,200 keywords from Ahrefs. | 1. Upload the same CSV to Claude. |
| 2. Open the CSV, clean it up. | 2. Type: “Cluster this for the UK market.” |
| 3. Upload to a clustering tool. Wait. | 3. Claude confirms, submits, and waits for you. |
| 4. Download the clustered spreadsheet. | 4. Results are summarized in the chat. |
| 5. Spend 45 mins filtering and pivoting. | 5. Ask: “Which clusters should a new site focus on?” |
| 6. Open another AI tool for ideas. | 6. Claude provides a prioritized list with reasoning. |
| 7. Copy and paste data to brief a writer. | 7. Ask: “Generate briefs for the top 3 clusters.” |
| Total Time: ~90 minutes + context switching | Total Time: ~25 minutes, all in one window |
The Claude skill collapses that gap.
You do not move the data between tools anymore.
Claude holds the context, does the analysis, and can immediately act on it.
Ask it to cluster your keywords and it clusters them.
Ask it which clusters to prioritise and it analyses the results and gives you a recommendation.
Ask it to generate a brief for the top cluster and it does that in the same session, without you re-uploading anything or explaining the context again.
Why This Is Different from Generic MCP Tools
If you have been following the MCP (Model Context Protocol) conversation, you have probably seen the complaints.
Context windows filling up before you even start. Claude becoming unusable after a few queries.

Hallucinations when the AI tries to interpret raw data it does not understand.
The problem with generic MCP tools is that they give Claude access to raw data without any processing or intelligence layer.
If you connect Claude to something like DataForSEO via MCP, you get raw keyword data.
Thousands of keywords.
No clustering.
No intent classification.
No SERP analysis.
Just numbers.
Claude then has to hold all of that raw data in its context window while trying to make sense of it.
The context fills up fast. Performance degrades. And because Claude is working with unprocessed data, it starts guessing. It might cluster “CRM software” and “CRM tools” together because they look similar, even though Google shows completely different results for those searches.
It might recommend creating content for keywords you already rank for, causing cannibalization.
It might miss intent mismatches entirely.
You are flying blind.
The Keyword Insights skill works differently.
We do not dump raw data into Claude’s context. We process it first.
When you ask Claude to cluster keywords using our skill, here is what actually happens:
- Claude sends your keyword list to the Keyword Insights API
- Our platform runs SERP analysis on every keyword, checking actual Google results
- Keywords are clustered based on SERP overlap, not word similarity
- Intent is classified based on what is actually ranking, not assumptions
- The results are summarized and returned to Claude in a structured format
Claude gets clean, processed insights, not raw data dumps. The context window stays manageable. The recommendations are based on real SERP data, not guesses.
Here is a practical example. Let’s say you have these three keywords in your list:
- “Project management software”
- “Project management tools”
- “Project management app”
A generic MCP tool would dump all three into Claude’s context with their search volumes.
Claude might say “these look similar, target them on one page.”
But if you check Google, you will often find different ranking patterns.
“Software” queries might show enterprise solutions. “Tools” queries might show listicles and comparisons.
“App” queries might show mobile focused results.
The Keyword Insights skill catches this because we check the actual SERPs.
We cluster based on ranking overlap, not word similarity.
If the top 10 results are different, we put them in separate clusters. If you already have content ranking for one of those keywords, we can tell you that too, preventing cannibalization.
This is the difference between raw data access and processed intelligence.
| Generic MCP Tool (e.g., DataForSEO) | Keyword Insights Skill |
|---|---|
| Raw keyword data dumped into context | Processed, SERP analyzed results |
| Context window fills up quickly | Structured summaries, minimal context usage |
| AI guesses at clustering based on words | Real SERP overlap clustering |
| No intent classification | Intent based on actual ranking pages |
| No cannibalization detection | Checks existing content automatically |
| Hallucinations increase with data size | Reliable, data backed recommendations |
If you want Claude to help with keyword research, you need to give it intelligence, not just data. That is what this skill does.
How to Get Started
Before using the skill you need two things: a Keyword Insights account on the Premium plan (API access is included at no extra cost), and a Keyword Insights API key created from the API Keys section of your dashboard.

Your key will look like this: kwi_sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ.
It does not expire unless you delete it, which makes it well suited for ongoing integrations and automated workflows.
If you are using Claude through the API or in an agentic setup, set your key as an environment variable called KWI_API_KEY.
If you are using Claude.ai with the skill enabled through the interface, the connection is handled through the skill configuration.
I have written a detailed step by step on how to download and install the Keyword Insights Claude skill here.
Once you are connected, the workflow is entirely conversational.
What You Can Actually Do
Here is a full breakdown of every capability the skill supports today.
Keyword Clustering
This is the core use case. Upload a CSV from any SEO tool, Ahrefs, Semrush, Google Search Console, Moz, SE Ranking, it does not matter, and ask Claude to cluster it.
Claude handles the file parsing automatically.
This includes Ahrefs exports, which use UTF 16 encoding and tab separators that trip up most tools.
It detects the keyword and search volume columns by header name, handles edge cases like missing volumes or extra columns, and prepares the data for submission without you having to do any cleaning.

Once the order is submitted, Claude polls for results and updates you when they are ready.
For a list of 400 keywords, you are typically looking at a 3-8 minute wait.
Claude will give you a summary in the chat and offer to save the full results as a file.
The clustering uses live SERP overlap data, which means keywords that consistently appear in the same search results get grouped together.
This produces clusters that reflect actual search behaviour rather than just topical similarity, which is why the results tend to be more actionable than rule based clustering approaches.
You can customise the clustering in a number of ways:
Grouping accuracy runs from 1 to 7. A lower setting produces broader clusters with more keywords in each group. A higher setting produces tighter clusters with stricter SERP overlap requirements.
The default is 4, which works well for most projects. If you are working on a very established site with existing content, a higher accuracy setting helps you find more specific gaps. If you are planning a new site, a lower setting gives you a cleaner hub structure to build around.
Location and language let you target specific markets. If you are running a UK SEO campaign, tell Claude to use the UK as the location and the clustering will use UK SERP data. Same for Australia, Germany, any other market.
Hub creation method controls how Claude groups clusters into larger topic hubs. The medium setting works well in most cases.
Search Intent Classification
Sometimes you do not need full clustering.
You just want to know whether a keyword list is dominated by informational queries, or whether there is enough commercial and transactional intent to justify a conversion focused content strategy.

Ask Claude for an intent analysis and it runs a context only order through Keyword Insights, which is faster and cheaper than full clustering.

The results classify every keyword as informational, commercial, transactional, or navigational, with the option to get a summary breakdown across the full list.

This is particularly useful when you are inheriting someone else’s keyword research and need to quickly audit the intent profile before doing anything else.
Content Brief Generation
Once you have your clusters, the next step is usually briefing content.
Claude can generate a full structured content brief for any keyword, directly from within the same conversation.

Tell it which keyword you want a brief for and it submits a content brief order to KI.
The brief is built from SERP analysis, so it reflects what is actually ranking for that keyword, not just what a language model thinks should be in the article.
Content briefs cost approximately 100 credits each.


For most workflows, you would generate briefs for your top priority clusters rather than every keyword in the list, so the credit cost stays manageable.
Writer Agent
For situations where you need a first draft quickly, the skill can trigger the KI Writer Agent. Give Claude a keyword, a target word count, and a tone of voice, and it will submit a writer agent order and return a full long form article draft based on SERP data.

You will get the output in HTML and Markdown formats.

Credit and Account Management
Ask Claude how many credits you have at any point in the conversation and it will fetch your live balance from the KI API. It also checks your balance proactively before submitting large or expensive orders and will warn you if the balance is insufficient before anything is charged.
A Full Workflow Example
Here is how this plays out in practice for a content team building out a new website in a competitive niche.
The SEO lead exports a keyword list from Ahrefs. About 600 keywords with monthly search volumes. They upload the CSV to Claude and type:
“Cluster this for the UK market. Set grouping accuracy to 5. I want clustering and intent for all keywords.”
Claude confirms the settings and submits the order. Six minutes later, results are ready. Claude summarises: 34 clusters identified, top 5 clusters accounting for 58% of total search volume, intent split roughly 60% informational and 40% commercial.
The SEO lead asks:
“Which clusters should I focus on first for a new site with no domain authority?”
Claude analyses the clusters, looks at the intent distribution, and recommends the three clusters with the highest informational volume and the lowest competitive density based on the data. It explains its reasoning.
“Generate a content brief for each of those three clusters.”
Three content brief orders are submitted. Ten minutes later, three structured briefs are ready. Claude presents them in the chat and offers to save them as files.
“Save all three as a single document.”
Done. The SEO lead has gone from a raw CSV export to three prioritised, briefed content topics in under 25 minutes, without leaving the Claude window.
That is the workflow change this skill enables.
Calculate Your Time Savings
Let’s break down the actual ROI of using the Claude skill versus the traditional workflow:
| Task | Traditional Time | With Claude Skill | Time Saved |
|---|---|---|---|
| Export & clean keyword data | 10 minutes | 2 minutes | 8 minutes |
| Upload & wait for clustering | 15 minutes | 6 minutes (automated) | 9 minutes |
| Analyze results & identify priorities | 45 minutes | 5 minutes | 40 minutes |
| Generate content briefs (3 topics) | 60 minutes | 10 minutes | 50 minutes |
| Total | 130 minutes | 23 minutes | 107 minutes (82% faster) |
For an SEO consultant billing at $150/hour, that’s $267.50 saved per project.
For an agency running 10 client projects per month, that’s $2,675 in recovered billable time.
Who Benefits Most
SEO consultants and freelancers
Running client keyword research will find the most immediate time savings.
The interpretation layer, deciding which clusters matter and why, used to require manually going back and forth between a spreadsheet and an AI tool. That is now a single conversation.
Content teams at SaaS companies and media businesses
Businesses producing content at scale will benefit from the brief generation pipeline. Cluster a large keyword list, identify the priority topics, and generate briefs for your writers in one session.
SEO agencies
Managing multiple clients can run separate clustering sessions for each client with different location and language settings, and use Claude to help interpret results in the context of each client’s existing site and content strategy.
Technical SEOs and developers
Folks building SEO tooling or content pipelines will find the skill useful as an orchestration layer. Claude can handle the reasoning and interpretation while the KI API provides the underlying data. The skill can be extended or customised for more complex automated workflows.
Agent orchestrated workflows
People like Hank’s are the perfect fit. If you are running loops where agents handle research, briefing, and drafting, you can now pipe Keyword Insights data directly into your automation chain without breaking flow to log into a dashboard.
Common Questions
“Isn’t this just another AI tool that gives generic advice?”
No. The Keyword Insights skill uses live SERP data from our platform, not generic AI knowledge. Every cluster, brief, and recommendation is based on actual search results and real ranking patterns.
“What if I run out of credits mid-project?”
Claude checks your credit balance before submitting any order and will warn you if you’re running low. You can also ask “How many credits do I have?” at any point in the conversation.
“Is there a learning curve?”
If you can have a conversation, you can use the skill. There’s no special syntax or commands to learn. Just tell Claude what you want in plain English.
“Can I use this with my existing SEO tools?”
Absolutely. The skill works with keyword exports from Ahrefs, Semrush, Google Search Console, Moz, SE Ranking, and any other tool that exports to CSV.
A Note on Credits
Every operation through the skill uses your standard Keyword Insights credits. The rates are the same as using the platform directly:
- Clustering uses 1 credit per keyword
- Intent only orders cost less than full clustering
- Content briefs cost approximately 100 credits each
- Writer Agent orders cost approximately 1,200 credits each
Claude is built to be responsible with your credits. It checks your balance before large orders, warns you if costs are high, and always asks for confirmation before submitting Writer Agent jobs. For very large keyword lists, it will estimate the total cost and ask you to confirm before proceeding.
If you are planning to run a large clustering project, it is worth checking your balance at the start of the conversation. Just ask: “How many credits do I have?”
Tips for Getting the Best Results
Be specific about your market
Claude defaults to the United States if you do not specify a location. If you are targeting the UK, Australia, Germany, or anywhere else, mention it explicitly. The SERP data used for clustering is market specific, so this directly affects the quality of your results.
Give Claude context about your site
If you mention what kind of site you are building, what topics it already covers, and what stage it is at, Claude can make much better recommendations about which clusters to prioritise. It is not just running the API calls, it is reasoning about the strategy.
Use intent only orders when that is all you need
If you just want to audit the intent profile of a keyword list, do not pay for full clustering. Ask Claude for intent classification only. It is faster and cheaper.
Chain your actions
The whole point of a conversational interface is that context carries over. Do not start a new conversation for each step. Cluster your keywords, discuss the results, request briefs, and ask for a content calendar recommendation all in the same session. Claude holds the context throughout.
Ask for a file when the results are large
For clustering results with more than 50 or 60 keywords, ask Claude to save the full data as a CSV or spreadsheet. The in chat summary gives you the high level view, but the file gives you everything you need for execution.
Adjust grouping accuracy for your situation
If you are getting clusters that feel too broad, bump the accuracy up to 5 or 6. If you are getting too many tiny clusters that are hard to prioritise, drop it to 3. You can always rerun with different settings if the first pass does not look right.
Use the API for large scale work
Keep in mind that Claude has a 200k token context window. It means it cannot handle very large projects. Keyword insights can handle thousands of keywords (up to 5M) via our API. So for large scale projects its recommended to use our API.
Getting Started Today
The Keyword Insights skill for Claude is available now for all Premium plan users.
To get started, create an API key from the API Keys section of your dashboard, enable the Keyword Insights skill in your Claude environment, and start a conversation.
The full setup documentation and use cases is available in the Keyword Insights docs under Integrations.
If you have questions or want to share a workflow you have built using the skill, reach out via the in app chat or through the website.
We are actively developing the skill further and feedback from how people are using it in practice directly shapes what we build next.
Table of contents:
Start your 7 day
$1 trial
Sign up today for a $1 trial and enjoy access to 6000 keyword clustering credits, 3 Keyword discovery searches, 1 Content Brief and Pro versions of SERP Similarity, SERP Explorer.