@power-seo/content-analysis 1.0.4 → 1.0.6

package/README.md

@@ -1,114 +1,149 @@
-# @power-seo/content-analysis — Yoast-Style SEO Content Scoring Engine for React & Node.js
+# @power-seo/content-analysis
+
+![content-analysis banner](../../image/content-analysis/banner.svg)
 
 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.
 
 [![npm version](https://img.shields.io/npm/v/@power-seo/content-analysis)](https://www.npmjs.com/package/@power-seo/content-analysis)
 [![npm downloads](https://img.shields.io/npm/dm/@power-seo/content-analysis)](https://www.npmjs.com/package/@power-seo/content-analysis)
+[![Socket](https://socket.dev/api/badge/npm/package/@power-seo/content-analysis)](https://socket.dev/npm/package/@power-seo/content-analysis)
+[![npm provenance](https://img.shields.io/badge/npm-provenance-enabled-blue)](https://github.com/CyberCraftBD/power-seo/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
 [![tree-shakeable](https://img.shields.io/badge/tree--shakeable-yes-brightgreen)](https://bundlephobia.com/package/@power-seo/content-analysis)
 
-`@power-seo/content-analysis` gives you a complete Yoast-style SEO scoring pipeline for any text content. Feed it a page's title, meta description, body HTML, focus keyphrase, images, and links — get back structured `good` / `improvement` / `error` results for every SEO factor. Run it server-side in a CMS, client-side in a React editor, or inside a CI content quality gate. All checks are individually configurable and tree-shakeable.
+`@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` / `needs-improvement` / `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 runtime dependencies** — only `@power-seo/core` as a peer.
 
-## Documentation
+---
+
+## 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 |
 
-- **Package docs:** [`apps/docs/src/content/docs/packages/content-analysis.mdx`](../../apps/docs/src/content/docs/packages/content-analysis.mdx)
-- **Ecosystem overview:** [`README.md`](../../README.md)
-- **Contributing guide:** [`CONTRIBUTING.md`](../../CONTRIBUTING.md)
+![SEO Score Dashboard](../../image/content-analysis/score-dashboard.svg)
+
+---
 
 ## Features
 
-- **Keyphrase density check** — scores optimal 0.5–3% keyword frequency in body copy
-- **Keyphrase distribution** — verifies the focus keyword appears in the first 10% of content
+- **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–158 chars), and keyphrase inclusion
-- **Heading structure** — ensures H1 exists and that the keyphrase appears in at least one heading
-- **Word count** — flags pages under the 300-word minimum threshold
+- **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 outbound and inbound link presence
-- **Configurable check suite** — disable any individual check via `disabledChecks` config
-- **Framework-agnostic** — works in Next.js, Remix, Gatsby, Vite, vanilla Node.js
+- **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
 
-## Table of Contents
-
-- [Installation](#installation)
-- [Quick Start](#quick-start)
-- [Usage](#usage)
-  - [Running All Checks at Once](#running-all-checks-at-once)
-  - [Running Individual Checks](#running-individual-checks)
-  - [Disabling Specific Checks](#disabling-specific-checks)
-  - [Using in a React Editor](#using-in-a-react-editor)
-- [API Reference](#api-reference)
-  - [`analyzeContent()`](#analyzecontent)
-  - [Individual Check Functions](#individual-check-functions)
-  - [Types](#types)
-- [The @power-seo Ecosystem](#the-power-seo-ecosystem)
-- [About CyberCraft Bangladesh](#about-cybercraft-bangladesh)
+![Google SERP Preview](../../image/content-analysis/serp-preview.svg)
+
+---
+
+## 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      | ✅                          | ❌        | ❌       | ❌           | ❌           |
+
+![Keyword Density Analysis](../../image/content-analysis/keyword-density.svg)
+
+---
 
 ## Installation
 
 ```bash
-npm install @power-seo/content-analysis
+npm install @power-seo/content-analysis @power-seo/core
 ```
 
 ```bash
-yarn add @power-seo/content-analysis
+yarn add @power-seo/content-analysis @power-seo/core
 ```
 
 ```bash
-pnpm add @power-seo/content-analysis
+pnpm add @power-seo/content-analysis @power-seo/core
 ```
 
+---
+
 ## Quick Start
 
 ```ts
 import { analyzeContent } from '@power-seo/content-analysis';
 
-const result = await analyzeContent({
-  keyphrase: 'react seo',
-  title: 'How to Add SEO to React Apps',
-  metaDescription:
-    'A complete guide to adding SEO meta tags, Open Graph, and structured data in React.',
-  bodyHtml: '<h1>React SEO Guide</h1><p>Search engine optimization for React...</p>',
-  images: [{ src: '/hero.jpg', alt: 'React SEO diagram' }],
-  links: {
-    internal: ['https://example.com/blog'],
-    external: ['https://developers.google.com/search'],
-  },
+const result = analyzeContent({
+  title: 'Best Running Shoes for Beginners',
+  metaDescription: 'Discover the best running shoes for beginners with our expert guide.',
+  keyphrase: 'running shoes for beginners',
+  content: '<h1>Best Running Shoes</h1><p>Finding the right running shoes...</p>',
+  url: 'https://example.com/best-running-shoes',
 });
 
-console.log(result.score); // e.g. 82
-console.log(result.results); // array of { id, status, message }
+console.log(result.overallStatus); // "good" | "needs-improvement" | "poor"
+console.log(result.results);
+// [{ id: 'title-presence', status: 'good', message: '...' }, ...]
 ```
 
+![SEO Check Results](../../image/content-analysis/check-results.svg)
+
+**Status thresholds (per check):**
+- `good` — check fully passes
+- `needs-improvement` — check partially passes
+- `poor` — check fails
+
+---
+
 ## Usage
 
 ### Running All Checks at Once
 
-`analyzeContent()` runs all 13 built-in checks and returns an aggregated score (0–100) along with per-check results.
+`analyzeContent()` runs all 13 built-in checks and returns an aggregated status along with per-check results.
 
 ```ts
 import { analyzeContent } from '@power-seo/content-analysis';
 
-const output = await analyzeContent({
-  keyphrase: 'next.js seo',
+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.',
-  bodyHtml: htmlString,
-  wordCount: 1250,
+  metaDescription: 'Learn how to optimize your Next.js app for search engines with meta tags and structured data.',
+  keyphrase: 'next.js seo',
+  content: htmlString,
+  url: 'https://example.com/nextjs-seo',
   images: imageList,
-  links: { internal: internalLinks, external: externalLinks },
+  internalLinks: internalLinks,
+  externalLinks: externalLinks,
 });
 
-// output.score     → number 0–100
-// output.results   → AnalysisResult[]
-// output.status    → 'good' | 'improvement' | 'error'
+// output.overallStatus  → 'good' | 'needs-improvement' | 'poor'
+// output.results        → AnalysisResult[]
 ```
 
 ### Running Individual Checks
@@ -126,121 +161,190 @@ import {
   checkLinks,
 } from '@power-seo/content-analysis';
 
-const titleResult = checkTitle({ keyphrase: 'react seo', title: 'React SEO Guide' });
-// { id: 'title-keyphrase', status: 'good', message: 'Focus keyphrase found in title.' }
+const titleResults = checkTitle({
+  title: 'React SEO Guide',
+  keyphrase: 'react seo',
+  content: '',
+});
+// [{ id: 'title-presence', status: 'good', message: '...' },
+//  { id: 'title-keyphrase', status: 'good', message: '...' }]
 
-const wc = checkWordCount({ wordCount: 250 });
-// { id: 'word-count', status: 'improvement', message: 'Word count is below 300 words.' }
+const wcResult = checkWordCount({ content: shortHtml });
+// { id: 'word-count', status: 'poor', message: 'Content is 180 words, below minimum of 300.' }
 ```
 
 ### Disabling Specific Checks
 
-Pass `config.disabledChecks` to skip checks that don't apply to your content type (e.g. skip image checks on text-only pages):
+Pass `config.disabledChecks` to skip checks that don't apply to your content type:
 
 ```ts
 import { analyzeContent } from '@power-seo/content-analysis';
 
-const output = await analyzeContent(input, {
+const output = analyzeContent(input, {
   disabledChecks: ['image-alt', 'image-keyphrase', 'external-links'],
 });
 ```
 
-### Using in a React Editor
+### React Components
 
-Integrate live scoring into a content editor — re-run analysis on every keystroke or debounced change:
+Import from the `/react` entry point for pre-built analysis UI components:
 
 ```tsx
-import { useState, useEffect } from 'react';
-import { analyzeContent } from '@power-seo/content-analysis';
-import type { ContentAnalysisOutput } from '@power-seo/content-analysis';
+import { ContentAnalyzer, ScorePanel, CheckList } from '@power-seo/content-analysis/react';
+import type { ContentAnalysisInput } from '@power-seo/content-analysis';
 
-function SeoScorePanel({ content }: { content: EditorContent }) {
-  const [analysis, setAnalysis] = useState<ContentAnalysisOutput | null>(null);
-
-  useEffect(() => {
-    analyzeContent({
-      keyphrase: content.keyphrase,
-      title: content.title,
-      metaDescription: content.description,
-      bodyHtml: content.html,
-    }).then(setAnalysis);
-  }, [content]);
-
-  if (!analysis) return null;
+// 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 (
-    <div>
-      <p>SEO Score: {analysis.score}/100</p>
-      {analysis.results.map((r) => (
-        <div key={r.id} className={`check-${r.status}`}>
-          {r.message}
-        </div>
-      ))}
-    </div>
+    <>
+      <ScorePanel score={result.score} maxScore={result.maxScore} />
+      <CheckList results={result.results} />
+    </>
   );
 }
 ```
 
+### Inside a CI Content Quality Gate
+
+Block deploys when SEO checks fail:
+
+```ts
+import { analyzeContent } from '@power-seo/content-analysis';
+
+const output = analyzeContent({ title, metaDescription, keyphrase, 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.message));
+  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()`
 
 ```ts
 function analyzeContent(
   input: ContentAnalysisInput,
   config?: AnalysisConfig,
-): Promise<ContentAnalysisOutput>;
+): ContentAnalysisOutput;
 ```
 
 #### `ContentAnalysisInput`
 
-| Prop              | Type                                       | Description                                                                  |
-| ----------------- | ------------------------------------------ | ---------------------------------------------------------------------------- |
-| `keyphrase`       | `string`                                   | Focus keyphrase to analyze against                                           |
-| `title`           | `string`                                   | Page `<title>` content                                                       |
-| `metaDescription` | `string`                                   | Meta description content                                                     |
-| `bodyHtml`        | `string`                                   | Full body HTML string                                                        |
-| `wordCount`       | `number`                                   | Pre-computed word count (optional; auto-detected from `bodyHtml` if omitted) |
-| `images`          | `Array<{src: string; alt?: string}>`       | Images found on the page                                                     |
-| `links`           | `{internal: string[]; external: string[]}` | Internal and external link URLs                                              |
+| Prop              | Type                                   | Required | Description                                    |
+| ----------------- | -------------------------------------- | -------- | ---------------------------------------------- |
+| `content`         | `string`                               | ✅       | Body HTML string                               |
+| `title`           | `string`                               | —        | Page `<title>` content                         |
+| `metaDescription` | `string`                               | —        | Meta description content                       |
+| `keyphrase`       | `string`                               | —        | Focus keyphrase to analyze against             |
+| `url`             | `string`                               | —        | Page URL (used for slug analysis)              |
+| `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`           | Aggregate score 0–100                                      |
-| `status`  | `AnalysisStatus`   | `'good'` (≥70) \| `'improvement'` (≥40) \| `'error'` (<40) |
-| `results` | `AnalysisResult[]` | Per-check results                                          |
+| Field           | Type               | Description                                               |
+| --------------- | ------------------ | --------------------------------------------------------- |
+| `overallStatus` | `AnalysisStatus`   | `'good'` \| `'needs-improvement'` \| `'poor'`            |
+| `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`      | `CheckId`        | Unique check identifier                  |
-| `status`  | `AnalysisStatus` | `'good'` \| `'improvement'` \| `'error'` |
-| `message` | `string`         | Human-readable feedback                  |
+| Field     | Type             | Description                                   |
+| --------- | ---------------- | --------------------------------------------- |
+| `id`      | `CheckId`        | Unique check identifier (see table below)     |
+| `status`  | `AnalysisStatus` | `'good'` \| `'needs-improvement'` \| `'poor'` |
+| `message` | `string`         | Human-readable actionable feedback            |
+| `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                      | Checks For                              |
-| ----------------------------- | --------------------------------------- |
-| `checkTitle(input)`           | Title presence and keyphrase inclusion  |
-| `checkMetaDescription(input)` | Description presence, length, keyphrase |
-| `checkKeyphraseUsage(input)`  | Density (0.5–3%) and distribution       |
-| `checkHeadings(input)`        | H1 existence and keyphrase in headings  |
-| `checkWordCount(input)`       | Minimum 300-word threshold              |
-| `checkImages(input)`          | Alt text presence and keyphrase in alt  |
-| `checkLinks(input)`           | Internal and external link presence     |
+| Function                      | Check ID(s)                                                    | Checks For                                         |
+| ----------------------------- | -------------------------------------------------------------- | -------------------------------------------------- |
+| `checkTitle(input)`           | `title-presence`, `title-keyphrase`                            | Title presence, length (30–60 chars), 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                |
 
 ### Types
 
-| Type                    | Description                          |
-| ----------------------- | ------------------------------------ |
-| `CheckId`               | Union of all 13 built-in check IDs   |
-| `AnalysisConfig`        | `{ disabledChecks?: CheckId[] }`     |
-| `AnalysisStatus`        | `'good' \| 'improvement' \| 'error'` |
-| `ContentAnalysisInput`  | Input shape for `analyzeContent()`   |
-| `ContentAnalysisOutput` | Output shape from `analyzeContent()` |
+| Type                    | Description                                               |
+| ----------------------- | --------------------------------------------------------- |
+| `CheckId`               | Union of all 13 built-in check IDs                        |
+| `AnalysisConfig`        | `{ disabledChecks?: CheckId[] }`                          |
+| `AnalysisStatus`        | `'good' \| 'needs-improvement' \| 'poor'`                 |
+| `ContentAnalysisInput`  | Input shape for `analyzeContent()`                        |
+| `ContentAnalysisOutput` | Output shape from `analyzeContent()`                      |
+| `AnalysisResult`        | Single check result with id, status, message, score       |
+
+---
+
+## 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 runtime dependencies** — only `@power-seo/core` as a peer dependency
+- **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](https://www.npmjs.com/org/power-seo) Ecosystem
 
@@ -268,15 +372,19 @@ All 17 packages are independently installable — use only what you need.
 
 ---
 
+## 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](https://ccbd.dev)
 
-**[CyberCraft Bangladesh](https://ccbd.dev)** is a Bangladesh-based enterprise-grade software engineering 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.
+**[CyberCraft Bangladesh](https://ccbd.dev)** 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.
 
-|                      |                                                                |
-| -------------------- | -------------------------------------------------------------- |
-| **Website**          | [ccbd.dev](https://ccbd.dev)                                   |
-| **GitHub**           | [github.com/cybercraftbd](https://github.com/cybercraftbd)     |
-| **npm Organization** | [npmjs.com/org/power-seo](https://www.npmjs.com/org/power-seo) |
-| **Email**            | [info@ccbd.dev](mailto:info@ccbd.dev)                          |
+[![Website](https://img.shields.io/badge/Website-ccbd.dev-blue?style=for-the-badge)](https://ccbd.dev)
+[![GitHub](https://img.shields.io/badge/GitHub-cybercraftbd-black?style=for-the-badge&logo=github)](https://github.com/cybercraftbd)
+[![npm](https://img.shields.io/badge/npm-power--seo-red?style=for-the-badge&logo=npm)](https://www.npmjs.com/org/power-seo)
+[![Email](https://img.shields.io/badge/Email-info@ccbd.dev-green?style=for-the-badge&logo=gmail)](mailto:info@ccbd.dev)
 
 © 2026 [CyberCraft Bangladesh](https://ccbd.dev) · Released under the [MIT License](../../LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@power-seo/content-analysis",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Yoast-style SEO content analysis engine with scoring, checks, and React components",
   "license": "MIT",
   "type": "module",
@@ -55,11 +55,26 @@
     "vitest": "^2.1.0"
   },
   "keywords": [
-    "seo",
-    "content-analysis",
-    "scoring",
-    "react",
-    "typescript"
+    "seo-content-analysis",
+    "yoast-seo-alternative",
+    "keyword-density-checker",
+    "focus-keyphrase",
+    "react-seo",
+    "nextjs-seo",
+    "meta-description-validator",
+    "heading-seo-checker",
+    "content-quality-gate",
+    "headless-cms-seo",
+    "programmatic-seo",
+    "keyphrase-density",
+    "seo-audit",
+    "typescript-seo",
+    "content-seo-automation",
+    "react-editor-seo",
+    "ci-seo",
+    "edge-runtime-seo",
+    "seo-scoring",
+    "content-analysis"
   ],
   "sideEffects": false,
   "author": "CyberCraft Bangladesh <info@ccbd.dev>",
@@ -70,5 +85,13 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/CyberCraftBD/power-seo/issues"
+  },
+  "homepage": "https://github.com/CyberCraftBD/power-seo/tree/main/packages/content-analysis#readme",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/cybercraftbd"
   }
 }