Skip to content
Back to search

on-page-seo

On-Page SEO Analyzer - Analyze your website's SEO performance

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agricidaniel--on-page-seo/badge.svg)](/listings/agricidaniel--on-page-seo)

HTML

<a href="/listings/agricidaniel--on-page-seo"><img src="/api/listings/agricidaniel--on-page-seo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone the repository

git clone https://github.com/AgriciDaniel/on-page-seo.git
cd on-page-seo

2. Install dependencies

# Install all dependencies (root, client, and server)
npm run install:all

3. Configure environment

cp .env.example .env

Edit `.env` with your settings, or configure API keys through the app's settings page.

4. Start development servers

npm run dev

This starts both the client (http://localhost:3005) and server (http://localhost:3001).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 160 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # On-Page SEO Analyzer
  2. A comprehensive on-page SEO analysis tool that helps you audit and optimize your website's SEO performance. Analyze up to 500 pages at once with detailed insights on 74 SEO metrics.
  3. ![On-Page SEO Dashboard](docs/screenshot.png)
  4. ## How It Was Built
  5. [![Watch how it was built](https://img.youtube.com/vi/jRSx4q8AghU/maxresdefault.jpg)](https://youtu.be/jRSx4q8AghU)
  6. **[Watch the journey from n8n workflow to full app on YouTube](https://youtu.be/jRSx4q8AghU)**
  7. ## Features
  8. - **Page Discovery**: Automatically discover pages on your website using Firecrawl
  9. - **Comprehensive Analysis**: Analyze 74 SEO metrics per page using DataForSEO
  10. - **Core Web Vitals**: Track LCP, FID, and CLS scores
  11. - **Real-time Progress**: Watch your audit progress with live updates
  12. - **Export Results**: Download reports as CSV or JSON
  13. - **Dark Mode**: Full dark mode support
  14. ## Tech Stack
  15. **Frontend:**
  16. - React 19 with TypeScript
  17. - Vite for blazing fast builds
  18. - TanStack Router & React Query
  19. - Tailwind CSS with Shadcn/ui components
  20. - Recharts for data visualization
  21. **Backend:**
  22. - Node.js with Express
  23. - SQLite database (better-sqlite3)
  24. - TypeScript
  25. - Firecrawl API for page discovery
  26. - DataForSEO API for SEO analysis
  27. ## Prerequisites
  28. - Node.js 18+
  29. - npm or yarn
  30. - [Firecrawl API Key](https://firecrawl.dev)
  31. - [DataForSEO Account](https://dataforseo.com)
  32. ## Quick Start
  33. ### 1. Clone the repository
  34. ```bash
  35. git clone https://github.com/AgriciDaniel/on-page-seo.git
  36. cd on-page-seo
  37. ```
  38. ### 2. Install dependencies
  39. ```bash
  40. # Install all dependencies (root, client, and server)
  41. npm run install:all
  42. ```
  43. ### 3. Configure environment
  44. ```bash
  45. cp .env.example .env
  46. ```
  47. Edit `.env` with your settings, or configure API keys through the app's settings page.
  48. ### 4. Start development servers
  49. ```bash
  50. npm run dev
  51. ```
  52. This starts both the client (http://localhost:3005) and server (http://localhost:3001).
  53. ## Scripts
  54. | Command | Description |
  55. |---------|-------------|
  56. | `npm run dev` | Start both client and server in development mode |
  57. | `npm run dev:client` | Start only the client |
  58. | `npm run dev:server` | Start only the server |
  59. | `npm run build` | Build both client and server for production |
  60. | `npm run start` | Start the production server |
  61. | `npm run install:all` | Install dependencies for root, client, and server |
  62. ## Project Structure
  63. ```
  64. on-page-seo/
  65. ├── client/ # React frontend
  66. │ ├── src/
  67. │ │ ├── components/ # Reusable UI components
  68. │ │ ├── features/ # Feature-based modules
  69. │ │ ├── lib/ # API client and utilities
  70. │ │ ├── routes/ # TanStack Router routes
  71. │ │ └── types/ # TypeScript types
  72. │ └── ...
  73. ├── server/ # Express backend
  74. │ └── src/
  75. │ ├── routes/ # API routes
  76. │ ├── services/ # Business logic
  77. │ └── db/ # Database layer
  78. ├── shared/ # Shared types
  79. │ └── types/
  80. ├── data/ # SQLite database
  81. └── ...
  82. ```
  83. ## API Endpoints
  84. | Method | Endpoint | Description |
  85. |--------|----------|-------------|
  86. | POST | `/api/audits` | Start a new SEO audit |
  87. | GET | `/api/audits` | List all audits |
  88. | GET | `/api/audits/:id` | Get audit details with results |
  89. | GET | `/api/audits/:id/progress` | SSE stream for real-time progress |
  90. | GET | `/api/audits/:id/export` | Export audit as CSV or JSON |
  91. | DELETE | `/api/audits/:id` | Delete an audit |
  92. | GET | `/api/settings` | Get API configuration status |
  93. | PUT | `/api/settings` | Update API credentials |
  94. ## Production Deployment
  95. ### Build for production
  96. ```bash
  97. npm run build
  98. ```
  99. ### Start production server
  100. ```bash
  101. NODE_ENV=production npm run start
  102. ```
  103. The server will serve the built client files and handle API requests on the same port.
  104. ## Contributing
  105. Contributions are welcome! Please feel free to submit a Pull Request.
  106. ## License
  107. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  108. ---
  109. > For a full publishing pipeline from analysis to published content, see [Rankenstein](https://rankenstein.pro).
  110. ## Author
  111. Built by [Agrici Daniel](https://agricidaniel.com/about) - AI Workflow Architect.
  112. - [Blog](https://agricidaniel.com/blog) - Deep dives on AI marketing automation
  113. - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) - Free community, 2,800+ members
  114. - [YouTube](https://www.youtube.com/@AgriciDaniel) - Tutorials and demos
  115. - [All open-source tools](https://github.com/AgriciDaniel)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.