https://github.com/StJudeWasHere/seonaut
Open source SEO audit tool.
https://github.com/StJudeWasHere/seonaut
audit crawler crawlergo crawlers crawling docker docker-compose go golang multiuser search-engine-optimization seo seo-audit seotools web
Last synced: about 1 year ago
JSON representation
Open source SEO audit tool.
- Host: GitHub
- URL: https://github.com/StJudeWasHere/seonaut
- Owner: StJudeWasHere
- License: mit
- Created: 2022-03-02T10:15:57.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-14T10:06:46.000Z (about 1 year ago)
- Last Synced: 2025-04-14T11:24:04.831Z (about 1 year ago)
- Topics: audit, crawler, crawlergo, crawlers, crawling, docker, docker-compose, go, golang, multiuser, search-engine-optimization, seo, seo-audit, seotools, web
- Language: Go
- Homepage: https://seonaut.org
- Size: 2.9 MB
- Stars: 342
- Watchers: 5
- Forks: 56
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-seo-mcp-servers - seonaut - based SEO auditing tool with interactive dashboard | (:hammer_and_wrench: Standalone Open Source SEO Tools / :gear: OpenClaw SEO Skills)
README
# SEOnaut
[](https://goreportcard.com/report/github.com/stjudewashere/seonaut) [](LICENSE) [](https://github.com/StJudeWasHere/seonaut/actions/workflows/test.yml)
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](https://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](https://www.docker.com/).
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](docs/INSTALL.md) file.
## Contributing
Please see [CONTRIBUTING](docs/CONTRIBUTING.md) for details.
## License
SEOnaut is open-source under the MIT license. See [License File](LICENSE) for more information.