@power-seo/content-analysis

@power-seo/content-analysis

Keyword-focused content analysis with real-time scoring, readability checks, and actionable feedback — like Yoast SEO, but as a standalone TypeScript library that works anywhere.

@power-seo/content-analysis delivers a comprehensive, WordPress SEO plugin–style scoring pipeline for evaluating text content, comparable to Yoast SEO, All in One SEO (AIOSEO), Rank Math, SEOPress, and The SEO Framework. Provide a page title, meta description, body content, focus keyphrase, images, and links — get back structured good / ok / poor results across all critical SEO factors. Run it server-side in a CMS, client-side in a React editor, or inside a CI content quality gate. All 13 analysis checks are fully configurable and tree-shakeable.

Zero external runtime dependencies — @power-seo/core is a direct dependency bundled with this package; no extra install needed.

Why @power-seo/content-analysis?

	Without	With
Keyphrase check	❌ Manual grep	✅ Density + distribution scoring
Title validation	❌ Eye-check only	✅ Presence, length, keyphrase match
Meta description	❌ Unchecked	✅ Length (120–160 chars) + keyphrase
Heading structure	❌ Missed H1s	✅ H1 hierarchy + keyphrase in subheadings
Image alt text	❌ Skipped	✅ Alt presence + keyphrase in alt
Link analysis	❌ Unknown	✅ Internal + external link presence
SEO score	❌ Guesswork	✅ Aggregate score with per-check breakdown
Framework support	❌ WordPress-only	✅ Next.js, Remix, Vite, Node.js, Edge

Features

• Keyphrase density check — scores optimal 0.5–2.5% keyword frequency in body copy
• Keyphrase distribution — verifies the focus keyword appears in intro, headings, slug, and image alt
• Title checks — detects missing titles and keyphrase absence in the <title> tag
• Meta description checks — validates presence, length (120–160 chars), and keyphrase inclusion
• Heading structure — validates H1 existence, hierarchy, and keyphrase in subheadings
• Word count — flags pages under 300 words (good at 1,000+)
• Image alt text — scans all images for missing alt attributes
• Image keyphrase — checks whether at least one image alt contains the focus keyphrase
• Internal and external link analysis — verifies inbound and outbound link presence
• Per-check disable config — skip irrelevant checks via disabledChecks config
• React components — pre-built ScorePanel, CheckList, and ContentAnalyzer UI components
• Framework-agnostic — works in Next.js, Remix, Gatsby, Vite, vanilla Node.js, Edge
• Full TypeScript support — complete type definitions for all inputs, outputs, and check IDs
• Tree-shakeable — import only the checks you use; zero dead code in your bundle

Comparison

Feature	@power-seo/content-analysis	Yoast SEO	next-seo	seo-analyzer	react-helmet
Keyphrase density check	✅	✅	❌	Partial	❌
Keyphrase distribution	✅	✅	❌	❌	❌
Title + meta validation	✅	✅	❌	Partial	❌
Heading structure check	✅	✅	❌	❌	❌
Image alt + keyphrase check	✅	✅	❌	❌	❌
Internal / external link check	✅	✅	❌	❌	❌
Aggregate SEO score	✅	✅	❌	Partial	❌
Per-check disable config	✅	❌	❌	❌	❌
Works outside WordPress	✅	❌	✅	✅	✅
TypeScript-first	✅	❌	Partial	❌	❌
Tree-shakeable	✅	❌	Partial	❌	❌
React UI components	✅	✅	❌	❌	❌
CI / Node.js usage	✅	❌	❌	✅	❌
Zero runtime dependencies	✅	❌	❌	❌	❌

Installation

npm install @power-seo/content-analysis

yarn add @power-seo/content-analysis

pnpm add @power-seo/content-analysis

Quick Start

import { analyzeContent } from '@power-seo/content-analysis';

const result = analyzeContent({
  title: 'Best Running Shoes for Beginners',
  metaDescription: 'Discover the best running shoes for beginners with our expert guide.',
  focusKeyphrase: 'running shoes for beginners',
  content: '<h1>Best Running Shoes</h1><p>Finding the right running shoes...</p>',
});

console.log(result.score); // e.g. 38
console.log(result.maxScore); // e.g. 55
console.log(result.results);
// [{ id: 'title-presence', status: 'good', description: '...', score: 5, maxScore: 5 }, ...]

Status thresholds (per check):

• good — check fully passes
• ok — check partially passes
• poor — check fails

Usage

Running All Checks at Once

analyzeContent() runs all 13 built-in checks and returns an aggregated status along with per-check results.

import { analyzeContent } from '@power-seo/content-analysis';

const output = analyzeContent({
  title: 'Next.js SEO Best Practices',
  metaDescription:
    'Learn how to optimize your Next.js app for search engines with meta tags and structured data.',
  focusKeyphrase: 'next.js seo',
  content: htmlString,
  images: imageList,
  internalLinks: internalLinks,
  externalLinks: externalLinks,
});

// output.score      → number (sum of all check scores)
// output.maxScore   → number (maximum possible score)
// output.results    → AnalysisResult[]

Running Individual Checks

Each check is exported as a standalone function — useful when you want to run only a subset of the analysis.

import {
  checkTitle,
  checkMetaDescription,
  checkKeyphraseUsage,
  checkHeadings,
  checkWordCount,
  checkImages,
  checkLinks,
} from '@power-seo/content-analysis';

const titleResults = checkTitle({
  content: '',
  title: 'React SEO Guide',
  focusKeyphrase: 'react seo',
});
// [
//   { id: 'title-presence', title: 'SEO title', description: '...', status: 'good', score: 5, maxScore: 5 },
//   { id: 'title-keyphrase', title: 'Keyphrase in title', description: '...', status: 'good', score: 5, maxScore: 5 }
// ]

const wcResult = checkWordCount({ content: shortHtml });
// { id: 'word-count', title: 'Word count', description: 'The content is 180 words...', status: 'poor', score: 1, maxScore: 5 }

Disabling Specific Checks

Pass config.disabledChecks to exclude specific checks from the output. Checks are still executed internally but their results are filtered from output.results and excluded from score/maxScore totals. Invalid check IDs are silently ignored.

import { analyzeContent } from '@power-seo/content-analysis';

const output = analyzeContent(input, {
  disabledChecks: ['image-alt', 'image-keyphrase', 'external-links'],
});

React Components

Import from the /react entry point for pre-built analysis UI components:

import { ContentAnalyzer, ScorePanel, CheckList } from '@power-seo/content-analysis/react';
import { analyzeContent } from '@power-seo/content-analysis';
import type { ContentAnalysisInput } from '@power-seo/content-analysis';

// All-in-one component
function Editor({ input }: { input: ContentAnalysisInput }) {
  return <ContentAnalyzer input={input} />;
}

// Or compose individually
function SeoPanel({ input }: { input: ContentAnalysisInput }) {
  const result = analyzeContent(input);
  return (
    <>
      <ScorePanel score={result.score} maxScore={result.maxScore} />
      <CheckList results={result.results} />
    </>
  );
}

Inside a CI Content Quality Gate

Block deploys when SEO checks fail:

import { analyzeContent } from '@power-seo/content-analysis';

const output = analyzeContent({ title, metaDescription, focusKeyphrase, content });

const failures = output.results.filter((r) => r.status === 'poor');

if (failures.length > 0) {
  console.error('SEO checks failed:');
  failures.forEach((r) => console.error(' ✗', r.description));
  process.exit(1);
}

API Reference

Entry Points

Import	Description
@power-seo/content-analysis	Core analyzer and individual check functions
@power-seo/content-analysis/react	React components for analysis UI

analyzeContent()

function analyzeContent(
  input: ContentAnalysisInput,
  config?: AnalysisConfig,
): ContentAnalysisOutput;

ContentAnalysisInput

Prop	Type	Required	Description
content	string	✅	Body HTML string
title	string	—	Page <title> content
metaDescription	string	—	Meta description content
focusKeyphrase	string	—	Focus keyphrase to analyze against
slug	string	—	URL slug (used for keyphrase-in-slug check)
images	Array<{ src: string; alt?: string }>	—	Images found on the page
internalLinks	string[]	—	Internal link URLs
externalLinks	string[]	—	External link URLs

ContentAnalysisOutput

Field	Type	Description
score	number	Sum of all individual check scores
maxScore	number	Maximum possible score (varies by enabled checks)
results	AnalysisResult[]	Per-check results
recommendations	string[]	Descriptions from all failed or partial checks

AnalysisResult

Field	Type	Description
id	string	Unique check identifier (one of the CheckId values)
title	string	Short display label for the check (e.g. "SEO title")
description	string	Human-readable actionable feedback
status	AnalysisStatus	'good' | 'ok' | 'poor'
score	number	Points earned for this check
maxScore	number	Maximum points for this check

AnalysisConfig

Field	Type	Description
disabledChecks	CheckId[]	List of check IDs to skip during analysis

Individual Check Functions

Function	Check ID(s)	Checks For
checkTitle(input)	title-presence, title-keyphrase	Title presence and length (50–60 chars, validated inside title-presence), keyphrase
checkMetaDescription(input)	meta-description-presence, meta-description-keyphrase	Description presence, length (120–160 chars), keyphrase
checkKeyphraseUsage(input)	keyphrase-density, keyphrase-distribution	Density (0.5–2.5%) and occurrence in key areas
checkHeadings(input)	heading-structure, heading-keyphrase	H1 presence, hierarchy, keyphrase in subheadings
checkWordCount(input)	word-count	Min 300 words (good at 1,000+)
checkImages(input)	image-alt, image-keyphrase	Alt text presence and keyphrase in alt
checkLinks(input)	internal-links, external-links	Internal and external link presence

Note: There is no separate title-length check ID. Title length validation (50–60 chars) is evaluated inside the title-presence check — a title that exists but is outside the recommended range returns status: 'ok' rather than 'good'.

Types

Type	Description
CheckId	Union of all 13 built-in check IDs
AnalysisConfig	{ disabledChecks?: CheckId[] }
AnalysisStatus	'good' | 'ok' | 'poor'
ContentAnalysisInput	Input shape for analyzeContent()
ContentAnalysisOutput	Output shape from analyzeContent()
AnalysisResult	Single check result with id, title, description, status, score, maxScore

Use Cases

• Headless CMS — score content as editors write, before publishing
• Next.js / Remix apps — run analysis server-side per route and expose scores in admin dashboards
• SaaS landing pages — enforce SEO quality programmatically across all marketing pages
• eCommerce product pages — validate product titles, descriptions, and image alt text at scale
• Blog platforms — provide real-time Yoast-style feedback in the post editor
• CI/CD content gates — block deploys when SEO checks fail

Architecture Overview

• Pure TypeScript — no compiled binary, no native modules
• Zero external runtime dependencies — @power-seo/core ships as a direct dependency, no separate install
• Framework-agnostic — works in any JavaScript environment
• SSR compatible — safe to run in Next.js Server Components, Remix loaders, or Express handlers
• Edge runtime safe — no Node.js-specific APIs; runs in Cloudflare Workers, Vercel Edge, Deno
• Tree-shakeable — "sideEffects": false with named exports per check function
• Dual ESM + CJS — ships both formats via tsup for any bundler or require() usage

Supply Chain Security

• No install scripts (postinstall, preinstall)
• No runtime network access
• No eval or dynamic code execution
• npm provenance enabled — every release is signed via Sigstore through GitHub Actions
• CI-signed builds — all releases published via verified github.com/CyberCraftBD/power-seo workflow
• Safe for SSR, Edge, and server environments

The @power-seo Ecosystem

All 17 packages are independently installable — use only what you need.

Package	Install	Description
@power-seo/core	npm i @power-seo/core	Framework-agnostic utilities, types, validators, and constants
@power-seo/react	npm i @power-seo/react	React SEO components — meta, Open Graph, Twitter Card, breadcrumbs
@power-seo/meta	npm i @power-seo/meta	SSR meta helpers for Next.js App Router, Remix v2, and generic SSR
@power-seo/schema	npm i @power-seo/schema	Type-safe JSON-LD structured data — 20 builders + 18 React components
@power-seo/content-analysis	npm i @power-seo/content-analysis	Yoast-style SEO content scoring engine with React components
@power-seo/readability	npm i @power-seo/readability	Readability scoring — Flesch-Kincaid, Gunning Fog, Coleman-Liau, ARI
@power-seo/preview	npm i @power-seo/preview	SERP, Open Graph, and Twitter/X Card preview generators
@power-seo/sitemap	npm i @power-seo/sitemap	XML sitemap generation, streaming, index splitting, and validation
@power-seo/redirects	npm i @power-seo/redirects	Redirect engine with Next.js, Remix, and Express adapters
@power-seo/links	npm i @power-seo/links	Link graph analysis — orphan detection, suggestions, equity scoring
@power-seo/audit	npm i @power-seo/audit	Full SEO audit engine — meta, content, structure, performance rules
@power-seo/images	npm i @power-seo/images	Image SEO — alt text, lazy loading, format analysis, image sitemaps
@power-seo/ai	npm i @power-seo/ai	LLM-agnostic AI prompt templates and parsers for SEO tasks
@power-seo/analytics	npm i @power-seo/analytics	Merge GSC + audit data, trend analysis, ranking insights, dashboard
@power-seo/search-console	npm i @power-seo/search-console	Google Search Console API — OAuth2, service account, URL inspection
@power-seo/integrations	npm i @power-seo/integrations	Semrush and Ahrefs API clients with rate limiting and pagination
@power-seo/tracking	npm i @power-seo/tracking	GA4, Clarity, PostHog, Plausible, Fathom — scripts + consent management

Keywords

seo content analysis · yoast seo alternative · content scoring typescript · keyword density checker · react seo scoring · nextjs content analysis · seo score npm · focus keyphrase checker · meta description validator · heading seo checker · content quality gate · headless cms seo · seo readability checker · content optimization library · programmatic seo · keyphrase density analyzer · seo audit npm package · typescript seo library · content seo automation · react editor seo · ci seo check · edge runtime seo

About CyberCraft Bangladesh

CyberCraft Bangladesh is a Bangladesh-based enterprise-grade software development and Full Stack SEO service provider company specializing in ERP system development, AI-powered SaaS and business applications, full-stack SEO services, custom website development, and scalable eCommerce platforms. We design and develop intelligent, automation-driven SaaS and enterprise solutions that help startups, SMEs, NGOs, educational institutes, and large organizations streamline operations, enhance digital visibility, and accelerate growth through modern cloud-native technologies.

© 2026 CyberCraft Bangladesh · Released under the MIT License