Getting Started
About
The nextjs-seo-manager is a tool for your Next.js website that allows you to set up an optimized website quickly and effortlessly. Manage your page metadata, robots.txt, sitemaps, and structured data without rebuilding your project bundle. It supports both the Pages Router and the App Router.
How It Works
The system has three parts:
- SEO Manager Dashboard (seomanager.dev) — a web interface where you manage SEO metadata, robots.txt, sitemaps, AI tools, and project settings.
- npm package (
nextjs-seo-manager) — installed in your Next.js project to fetch and render SEO data at build or request time. - API — connects the two. Your site calls the SEO Manager API to retrieve the latest SEO data for each page.
AI-Powered Optimization
SEO Manager includes an AI assistant that can analyze your pages, score them from 0–100, and suggest improvements to titles, descriptions, keywords, and more. You can chat with the AI, let it auto-optimize pages on a schedule, and build a knowledge base so recommendations stay relevant to your brand. See the AI Assistant section for details.
Credits
SEO Manager uses a credit-based system. New projects start with 250 credits to get you going.
Usage draws from your credit balance: SEO pages, fetch requests, storage, AI tokens, and additional users each consume credits. Credits are charged daily. When your balance runs low, top up with credit packs (5,000, 25,000, or 100,000 credits) to avoid interruption.
View rates and top up here.
Pages Router vs App Router
nextjs-seo-manager supports both routing strategies. Choose the guide that matches your project:
| Feature | Pages Router | App Router |
|---|---|---|
| SEO metadata | SEOHelper + <Head> | createPageSEO + generateMetadata + AppSEOHelper |
| Robots.txt | RobotsHelper component | robotsbasichelper route handlers |
| Sitemaps | SitemapHelper component | sitemapbasichelper route handlers |
| Data fetching | getServerSideProps / getStaticProps | Server Components / React cache() |
If you are using the Pages Router, follow the Get Setup section. If you are using the App Router, follow the App Router section.
Requirements
- react@17.0.0 or greater.
- react-dom@17.0.0 or greater.
How to get started
- Create your account — Register.
- Create your project — Create Project.
- Create your API Keys. Create both a ProjectKey and a SecretKey.
- Install nextjs-seo-manager:
npm install nextjs-seo-manager - Set up your environment variables in
.env.local:SEO_MANAGER_PROJECT_ID=your_project_id SEO_MANAGER_SECRET_KEY=your_secret_key NEXT_PUBLIC_SEO_MANAGER_PROJECT_KEY=your_project_key - Follow the setup guide for your router:
- Pages Router — SEOInit
- App Router — App Router Metadata