KeywordPlanner

Code

import { KeywordPlanner, type PlannerKeyword } from "@fadymondy/nasaq/web";export function Plan({ keywords }: { keywords: PlannerKeyword[] }) {  return <KeywordPlanner keywords={keywords} onAssignOwner={async (id, url) => { await api.setOwner(id, url); }} />;}

SEO · beta

Live examples and controls: KeywordPlanner in the lab.

InstallCopy Anchor Link

npx shadcn@latest add https://docs.nasaqui.com/r/keyword-planner.json

KeywordPlanner turns a flat keyword list into a content plan. Each keyword has an intent (informational, commercial, transactional or navigational, guessed from the wording unless you set it), volume, difficulty and an owning URL that you edit in the cell. A Clusters tab groups related keywords under the biggest one, and a Cannibalization tab lists keywords where two of your own pages rank, with a one-click Keep this page.

When to useCopy Anchor Link

• Planning which page targets which keywords.
• Finding pages that compete with each other in search.

When not to useCopy Anchor Link

• Watching positions over time: use KeywordTracker.

ImportCopy Anchor Link

import { KeywordPlanner } from "@fadymondy/nasaq/web";

Quick startCopy Anchor Link

import { KeywordPlanner, type PlannerKeyword } from "@fadymondy/nasaq/web";

export function Plan({ keywords }: { keywords: PlannerKeyword[] }) {
  return <KeywordPlanner keywords={keywords} onAssignOwner={async (id, url) => { await api.setOwner(id, url); }} />;
}

AnatomyCopy Anchor Link

KeywordPlanner         data-slot="keyword-planner"
  Tabs                 Keywords | Clusters | Cannibalization
    DataTable          keyword, intent, cluster, volume, difficulty, owner URL
    clusters           head keyword, members, total volume
    conflicts          keyword, ranking URLs with positions, Keep this page

APICopy Anchor Link

KeywordPlannerCopy Anchor Link

PlannerKeywordCopy Anchor Link

{ id, keyword, volume, difficulty (0 to 100), intent?, ownerUrl?, rankingUrls?: { url, position }[] }.

HelpersCopy Anchor Link

• classifyIntent(keyword) guesses an intent from English and Arabic cue words.
• clusterKeywords(rows, threshold = 0.5) groups by shared word overlap.
• findCannibalization(rows, depth = 20) lists keywords with two or more of your URLs in the top depth; keep is the owner if it is one of them, otherwise the best ranking URL.
• keywordTokens, normalizeUrl are the building blocks (/Blog/ and /blog are the same page).

ExamplesCopy Anchor Link

Only the maths, for a report:

import { findCannibalization } from "@fadymondy/nasaq/web";

const conflicts = findCannibalization(keywords);

Read only (no owner editing):

import { KeywordPlanner } from "@fadymondy/nasaq/web";

<KeywordPlanner keywords={keywords} />;

AccessibilityCopy Anchor Link

A failed save shows a visible message and keeps the old value.

RTL & i18nCopy Anchor Link

Arabic keywords are classified with Arabic cue words and shown with dir="auto"; URLs stay left-to-right. Built-in English and Arabic strings; override with labels.

Styling & tokensCopy Anchor Link

Intent badges use the status tokens (info, warning, success, neutral). Logical spacing only.

Do / Don'tCopy Anchor Link

• Do give each keyword exactly one owning page.
• Do resolve cannibalization by merging or re-targeting, not only by picking a winner.
• Don't trust the guessed intent for brand terms; set intent yourself.

RelatedCopy Anchor Link

• KeywordTracker
• SeoPageList

LabCopy Anchor Link

https://docs.nasaqui.com/?path=/docs/components-seo-keyword-planner--docs