Can a keyword be mapped to more than one page?

No. PolyFuzz returns the single best match per keyword, so each keyword is assigned at most one page (the H1 with the highest similarity). Pages can receive many keywords, and that is what the Opportunity Size column counts.

Why does a keyword appear in Content Gaps when I clearly have a page for it?

Two reasons visible in the code. Anything below the similarity threshold is treated as unmapped. Less obviously, the Exclude exact matches toggle drops keywords whose text already appears inside the matched H1, and those dropped keywords are then counted as unmapped, so they land in the Content Gaps sheet despite having a perfect page. Untick the toggle if that distinction matters to you.

What does it actually match against, the whole page?

Only the single H1 or title column you select, lowercased. Page body content is never embedded, so pages with vague or branded H1s will under-match regardless of the threshold you set.

Does it need an API key or cost anything to run?

No. Embeddings are computed locally with sentence-transformers, so there is no per-keyword cost. The first run is slow because the selected model has to download; after that it is cached.

Do my CSVs need specific column names?

No fixed names, but auto-detection looks for a column called Address for URLs, columns containing 'h1' or 'title' for page content, 'keyword' or 'query' for keywords, and 'vol' for volume. If nothing matches, the first column is silently preselected, so always check the dropdowns before running. Both files must be CSV, not Excel.

Back to Tools

Keyword-to-Page Mapper

Use cases

Finding content opportunities from competitor keywords Mapping keywords to existing content Identifying content gaps Content strategy planning

PolyFuzz with Sentence Transformers for semantic similarity (not exact keyword matching).

Three embedding models: all-MiniLM-L6-v2 (fastest), multi-qa-mpnet-base-dot-v1, all-mpnet-base-v2 (most accurate).

Similarity threshold 0.5-0.95 (default 0.75).

Exact match exclusion toggle.

xlsxwriter multi-sheet Excel.

Streamlit App

Platform

Browser-based (no installation required)

Input

Pages CSV: URL/Address + H1/Title column

Keywords CSV: Keyword + optional Volume (Ahrefs/SEMrush format)

Output

Mapped CSV: keyword, H1, similarity, URL, volume, opportunity count. Gaps CSV: unmapped keywords. Excel: multi-sheet combining both.

Launch App View Source

Features

PolyFuzz + Sentence Transformers semantic matching
3 embedding models: MiniLM, mpnet-base-dot, mpnet-base-v2
Similarity threshold slider (0.5-0.95, default 0.75)
Exact match exclusion toggle
Content gap detection for unmapped keywords
Multi-sheet xlsxwriter Excel export

How to use

1 Upload crawl export with H1s/titles
2 Upload competitor keywords
3 Select embedding model
4 Set similarity threshold (0.5-0.95)
5 Toggle exact match exclusion
6 Download mapped keywords and content gaps

Frequently asked questions

Can a keyword be mapped to more than one page?: No. PolyFuzz returns the single best match per keyword, so each keyword is assigned at most one page (the H1 with the highest similarity). Pages can receive many keywords, and that is what the Opportunity Size column counts.
Why does a keyword appear in Content Gaps when I clearly have a page for it?: Two reasons visible in the code. Anything below the similarity threshold is treated as unmapped. Less obviously, the Exclude exact matches toggle drops keywords whose text already appears inside the matched H1, and those dropped keywords are then counted as unmapped, so they land in the Content Gaps sheet despite having a perfect page. Untick the toggle if that distinction matters to you.
What does it actually match against, the whole page?: Only the single H1 or title column you select, lowercased. Page body content is never embedded, so pages with vague or branded H1s will under-match regardless of the threshold you set.
Does it need an API key or cost anything to run?: No. Embeddings are computed locally with sentence-transformers, so there is no per-keyword cost. The first run is slow because the selected model has to download; after that it is cached.
Do my CSVs need specific column names?: No fixed names, but auto-detection looks for a column called Address for URLs, columns containing 'h1' or 'title' for page content, 'keyword' or 'query' for keywords, and 'vol' for volume. If nothing matches, the first column is silently preselected, so always check the dropdowns before running. Both files must be CSV, not Excel.

Want me to run this for you?

I run this tool as a managed service, or build something custom around your data. You get the insights without touching the code.

Tell Me What You Need

Category Title SuggesterAppContent

Analyse category pages and suggest high-performing keywords for titles.

Meta Description GraderAppContent

Score and compare meta descriptions using OpenAI GPT models on key SEO criteria.

Meta Description RewriterAppContent

Rewrite meta descriptions using AI with proper length optimisation.

Content Reviewer (LLM)AppContent

Review web content and get AI-powered annotations with improvement suggestions.

Keyword Extractor (LLM)AppContent

Extract and categorise keywords from content for internal linking opportunities.

Break-even ROAS CalculatorBrowserPPC

Calculate the minimum ROAS needed to break even.

Need something built for your business?

This tool started as bespoke client work. I build custom scripts, data pipelines, and full apps for SEO and product data problems that off-the-shelf tools don't solve.