@sargonpiraev/seokit

Playwright SEO matchers for Next.js — toHaveMetadata and toHaveJsonLd

Install

npm install @sargonpiraev/seokit @playwright/test

Formerly published as @sargonpiraev/seodit — same API, new package name:

npm uninstall @sargonpiraev/seodit
npm install @sargonpiraev/seokit @playwright/test

Quick start

import { expect as baseExpect, test } from "@playwright/test";
import { extendSeokitExpect } from "@sargonpiraev/seokit";

const expect = extendSeokitExpect(baseExpect);

test("/en", async ({ page }) => {
  await page.goto("/en");
  await expect(page).toHaveMetadata({
    lang: "en",
    title: /.+/,
    alternates: { canonical: "https://example.com/en" },
  });
  await expect(page).toHaveJsonLd([{ "@type": "Organization" }]);
});

Skill (optional)

For Cursor and other coding agents. Skill docs.

skills.sh

npx skills add https://github.com/sargonpiraev/seokit/tree/main/packages/seokit/skills/seokit -a cursor -y

skills-npm (version-locked)

npm i -D skills-npm
npx skills-npm setup
npm install @sargonpiraev/seokit

Documentation

• Docs
• llms.txt
• llms-full.txt
• Source
• npm
• Example app