Skip to content

mascanho/RustySEO

Repository files navigation

RustySEO

A modern SEO/GEO toolkit

Rust

Logo


Shallow Crawl (Single Page)

Logo

Deep Crawl (Page Bulk)

Logo


RustySEO - A cross-platform SEO toolkit

RustySEO is an all-in-one, cross-platform Marketing toolkit, designed for comprehensive SEO & GEO analysis. It enables users to crawl websites, analise server logs gaining actionable insights into their marketing and SEO strategies.

As an open-source project, RustySEO aims to enhance your SEO efforts. Please note that initial versions may have bugs and issues, and we welcome your contributions in the form of bug reports or fixes via our repository.

Our mission is to offer a robust, free alternative to the costly commercial SEO tools currently on the market.

Keep in mind that all the integrations are free to use (up to an extent). Its abuse will result in 404 or 503 by the providers.

As long as you don't spam (many requests per second) you should be ok to use RustySEO as your daily driver for SEO. :)

πŸ”– TL;DR

For a better experience you need to get a Google PageSpeed Insights API KEY.

Got to "Connectors" > "PageSpeed Insights" and add your key, for the time being you can try one I generated (It will expire over time):

AIzaSyAHsCM-Cs4cCqdGi798wh8af-bSnXbVUjw

We recommend using Google Gemini if you want the best AI features.

As of today, the smaller local LLMs are not working properly and are not recommended if you want to make the most of the AI features.

These LLMs might get deprecated due to their lack of uniform performance across different models.

Authentication currently takes place server side, as such it is slightly more cumbersome when integrating with Google OAuth 2.0. This is particularly true for Google Search Console (GSC) and Google Analytics 4 (GA4)

This authentication will be passed to the client-side in the future.

Use at your own risk, this software is new and under development.

‼️ You will get prompted with "Unknown/Unregistered Developer" on Windows and Mac. See below how to open and install ‼️

Windows Mac OS

🀘 Features

  • Shallow & deep crawl;
  • Technical Diagnostics (core web vitals, Page Speed Insights);
  • On-Page SEO Analysis (content analysis, Keyword density, etc...);
  • Improvements / Suggestions on page crawl;
  • Dashboards;
  • Task Manager / Tracker
  • Reporting (CSV, Excel, Google Sheets, PDF);
  • Topic generator;
  • Keyword generator;
  • Local LLM (ollama);
  • Free API LLM (Google Gemini);
  • Built-in AI chatbot;
  • Crawl history;
  • Image conversion and optimization;

πŸ—ΊοΈ Roadmap

# Feature Status
1 Deep crawl (multiple pages concurrently) βœ…
2 More integrations βœ…
3 Better reporting βœ…
4 Password protection & encryption ⚠️
5 Client-side OAuth2 authentication ⚠️
6 Better local LLM support ❌
7 SEMrush Integration ⚠️
8 Topic / Content calendar view βœ…
9 Regression Analysis of GA4 data ⚠️
10 Topic Modeling ⚠️
11 Chatbot Crawl Context βœ…
12 Extraction of HTML / JS / CSS fragments ☠️
13 Schema Generator & Validator βœ…
14 Keyword Clustering ⏳
15 Machine Learning βœ…
16 Collaboration ⏳
17 API / Streaming ⏳
18 Very Large website support (> 100K URLs) πŸ‹πŸ»

πŸ”Œ Connectors / APIs (Get your keys, they are free πŸ˜‰)

⌨️ Keymaps

Keys Result
CTRL + D Deep Crawl
CTRL + S Shalow Crawl
CTRL + K log analysis
CTRL + H Toggle Sidebar
CTRL + L Toggle Side Task Manager
CTRL + T Create TODO/Task

Setting up Google Search Console

Windows

To setup Google Search Console, follow these steps:

  1. You need to set up Google Cloud Console with Search Console API enabled and Service Account active. Make sure you have full ownership of your GSC property.

  2. Launch RustySEO;

  3. Go to the menu Connectors πŸ‘‰ Search Console

  4. Add your Google Search Console credentials

RustySEO

You can find all the details in your Google Cloud console account with the exception of the "URL" and "Property Type", which should match what you have in your Google Search console account.

RustySEO

  1. Submit the credentials and your desired options

  2. Restart RustySEO

  3. Since windows does not allow to output logs into the terminal by default, we just need to force it so that we can grab the link generated on the server to generate our token. Google keeps changing this but the goal is to have it done client-side (once I have the time). Launch RustySEO from Windows Powershell with the following command:

C:\Users\[your user]\AppData\Local\rustyseo\rustyseo.exe | Tee-Object -Filepath "C:\Users\[your user]\Downloads\rusty.log"

This will output all the logs into powershell. You will see a link from Google Auth. Simply open it in your browser with the same account that you generated your GSC API. Accept.

  1. Restart RustySEO after the token has been generated

  2. You should now see your GSC data inside RustySEO

Mac OSX

After installation, you can start using My Software. Here are some basic instructions:

To setup Google Search Console, follow these steps:

  1. You need to set up Google Cloud Console with Search Console API enabled and Service Account active. Make sure you have full ownership of your GSC property.

  2. Launch RustySEO;

  3. Go to the menu Connectors πŸ‘‰ Search Console

  4. Add your Google Search Console credentials

RustySEO

You can find all the details in your Google Cloud console account with the exception of the "URL" and "Property Type", which should match what you have in your Google Search console account.

RustySEO

  1. Submit the credentials and your desired options

  2. Restart RustySEO

  3. Open your terminal and execute the following:

/Applications/rustyseo.app/Contents/MacOS/rustyseo

This will output all the logs into your terminal. You will see a link from Google Auth. Open it in your browser with the same account that you generated your GSC API. Accept the following prompts.

  1. Restart RustySEO after the token has been generated

  2. You should now see your GSC data inside RustySEO

Linux

in a few weeks...

About

A SEO/GEO toolkit to analyse and optimise websites.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages