# Keyword Proximity Checker MCP for AI Agents AI Agent Connect

> Keyword Proximity Checker measures the exact word distance between keywords in your text to help with SEO relevance. It lets you identify topical density, find keyword clusters, and verify that your main terms are close enough to matter to search engines. It's a precision tool for content audits and SEO strategy.

## Overview
- **Category:** seo
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Yem3wGKJqrGOkrO4CNmGji2IGhxXgS91bKm1h0ln/ai-agent-connect
- **Tags:** seo, keywords, proximity, text-analysis, tokenization

## Description

Writing content that ranks requires more than just sprinkling keywords across a page. You need to know if those words are actually working together to build topical authority. This Connector lets you see the underlying structure of your text by measuring how many words separate your primary terms. Instead of guessing if your content is dense enough, you can get hard numbers on keyword proximity. You'll find out if your main topics are clustered effectively or if they're too spread out to register as a coherent theme. It's a huge time-saver for auditing long-form articles or checking if a new draft meets specific SEO requirements. By connecting this to the Vinkius catalog, you can quickly run these checks across multiple pieces of content, making it much easier to maintain consistency across a whole site. It turns a tedious manual counting task into a quick check that gives you the data you need to make better content decisions. You can see exactly where your content is strongest and where it needs more focus, ensuring your strategy stays on track. It takes the guesswork out of content density and lets you focus on the actual writing.

## Tools

### detect_keyword_clusters
Identify clusters where multiple keywords appear near each other. This helps you find high-density topical areas.

### evaluate_proximity_status
Determine if specific pairs of keywords meet a predefined proximity threshold. Use this to check if content meets density rules.

### get_word_distance
Calculate the exact number of words separating two specific keywords in a given text. It provides precise data for audits.

## Prompt Examples

**Prompt:** 
```
Check if 'laptop' and 'battery' are within 5 words in this text: 'The new laptop has a huge battery life.'
```

**Response:** 
```
### Proximity Check Results

| Keyword Pair | Distance | Status |
| :--- | :--- | :--- |
| laptop - battery | 0 | **Near** |

The keywords are perfectly adjacent.
```

**Prompt:** 
```
Find all keyword clusters for ['coffee', 'beans', 'roast'] in this paragraph.
```

**Response:** 
```
### Keyword Clusters Found

*   **Cluster 1:** ['coffee', 'beans', 'roast']
    *   **Location:** Index 14 to 22
    *   **Context:** "...premium coffee beans with a dark roast..."
```

**Prompt:** 
```
What is the word distance between 'software' and 'update' in this sentence: 'Please download the latest software update today'?
```

**Response:** 
```
The word distance between **software** and **update** is **1** word.
```

## Capabilities

### Measure word gaps between specific terms
Get the exact count of words separating any two keywords in your text.

### Check proximity thresholds
Determine if keyword pairs appear close enough to meet your specific SEO requirements.

### Identify keyword clusters
Locate areas in your content where multiple keywords appear near each other.

### Audit topical density
Check if your primary topics are grouped effectively for search relevance.

### Spot weak keyword placement
Find instances where important terms are too far apart to maintain context.

## Use Cases

### The SEO Audit
A specialist has a 3,000-word guide and needs to know if 'organic growth' and 'marketing' appear together. They ask the agent to check the distance.

### Content Quality Check
An editor wants to make sure a writer didn't just keyword stuff but actually kept related terms in the same paragraph.

### Competitor Analysis
An analyst feeds a competitor's page into the agent to see how they cluster their main product keywords.

### Dynamic Content Generation
A user asks the agent to write a paragraph and then uses the tool to verify the keywords are within a 5-word limit.

## Benefits

- Stop guessing about keyword placement. Use `get_word_distance` to see exactly how many words separate your terms so you know if they're close enough for search engines.
- Automate proximity audits. Use `evaluate_proximity_status` to instantly flag content that doesn't meet your required topical density.
- Spot keyword clusters instantly. `detect_keyword_clusters` helps you find where your content is strongest and where it needs more focus.
- Save hours of manual counting. You don't have to scroll through long articles to see if words are near each other anymore.
- Improve topical authority. By ensuring keywords stay close together, you help your AI client produce content that feels more relevant to search engines.

## How It Works

The bottom line is you get hard data on keyword placement without having to count words yourself.

1. Provide the text and the specific keywords you want to analyze.
2. Run a proximity check to measure the word distance between terms.
3. Get a clear status report or a list of identified keyword clusters.

## Frequently Asked Questions

**Can the Keyword Proximity Checker help with my SEO strategy?**
Yes, it helps you ensure your keywords are close enough to build topical authority. By knowing the exact distance between terms, you can better organize your content to satisfy search engine requirements.

**How does Keyword Proximity Checker find clusters?**
It scans your text to find areas where multiple keywords appear near each other. This helps you identify where your content is most dense and where it might need more detail.

**Can I use Keyword Proximity Checker for long blog posts?**
It works great for long-form content where manual counting is difficult. You can quickly audit thousands of words to find specific keyword placements.

**Will Keyword Proximity Checker tell me if my keywords are too far apart?**
You can set a specific distance limit to check this automatically. If the distance exceeds your limit, the tool will flag it as a proximity issue.

**Does Keyword Proximity Checker work on any type of text?**
It works on any plain text you provide to your AI client. Whether it's a blog post, a product description, or a technical manual, it can analyze the proximity of your terms.

**How can Keyword Proximity Checker improve my content quality?**
It helps you ensure that related topics are actually being grouped together. This makes your content easier for readers to follow and more relevant for search engines.

**How is the word distance calculated?**
The tool calculates the difference between the positions of the keywords and subtracts one. It always finds the shortest possible distance if a keyword appears multiple times.

**What is a keyword cluster?**
A cluster is identified when multiple keywords from your list all appear within a specified `windowSize` range of tokens.

**Can I check multiple keyword pairs at once?**
Yes, using the `evaluate_proximity_status` tool, you can provide a list of keywords and a maximum distance to see which pairs are 'Near' or 'Far'.