SEOnaut

SEOnaut is an open-source SEO auditing tool designed to analyze websites for issues that may impact search engine rankings. It performs a comprehensive site scan and generates a report detailing any identified issues, organized by severity and potential impact on SEO.

SEOnaut categorizes issues into three levels of severity: critical, high, and low. The tool can detect various SEO-related problems, such as broken links (to avoid 404 errors), redirect issues (temporary, permanent, or loops), missing or duplicate meta tags, incorrectly ordered headings, and more.

A hosted version of SEOnaut is available at seonaut.org.

Technology

SEOnaut is a web-based application built with the Go programming language and a MySQL database for data storage. The frontend is designed for simplicity, using custom CSS and minimal vanilla JavaScript. Apache ECharts is used to provide an interactive dashboard experience.

While it is possible to configure a custom database and compile SEOnaut manually, using the provided Docker files is recommended. These files simplify the setup process and eliminate the need for manual configuration, allowing for quicker and easier deployment.

Quick Start Guide

To get started with SEOnaut, follow these steps to run it using Docker:

1. Install Docker
   Ensure Docker is installed on your system. You can download and install Docker from the official website.

2. Clone the Repository
   Clone the SEOnaut repository:

   git clone https://github.com/stjudewashere/seonaut.git

3. Navigate to the Project Directory
   Change into the project directory:

   cd seonaut

4. Build and Run Docker Containers
   Run the following command to build and start the Docker containers:

   docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d --build

5. Access the Application
   Once the containers are running, open your browser and visit:

   http://localhost:9000

   SEOnaut is set up to run on port 9000 using unencrypted HTTP by default. For added security, it is recommended to configure HTTPS using a reverse proxy. This will ensure encrypted communication between the client and the server.

For more detailed installation and configuration instructions, refer to the INSTALL.md file.

Contributing

Please see CONTRIBUTING for details.

License

SEOnaut is open-source under the MIT license. See License File for more information.