From e8ab41e91b8f92e05a20ca9c59802589605eeee5 Mon Sep 17 00:00:00 2001 From: Ben Senescu Date: Fri, 27 Feb 2026 15:01:43 -0500 Subject: [PATCH 1/2] save --- README.md | 37 +++++++++++++++++++++++++++++++------ 1 file changed, 31 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index cb63556..029c516 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,32 @@ # OpenSEO -OpenSEO is an SEO tool for *the people* (non-seo professionals). If tools like Semrush or Ahrefs are too expensive or bloated, OpenSEO is a pay by usage alternative that you actually control. +OpenSEO is an SEO tool for _the people_ (non-seo professionals). If tools like Semrush or Ahrefs are too expensive or bloated, OpenSEO is a pay by usage alternative that you actually control. ![OpenSEO demo (placeholder)](https://placehold.co/1200x675?text=OpenSEO+Demo+GIF+Coming+Soon) +## Table of Contents + +- [Why Use This](#why-use-this) +- [Main SEO Workflows](#main-seo-workflows) +- [Roadmap](#roadmap) +- [Pricing / Costs](#pricing--costs) +- [DataForSEO API Key Setup \\[5 minutes\\]](#dataforseo-api-key-setup-5-minutes) +- [Self Hosting (Deploy on Cloudflare) \\[5-10 minutes\\]](#self-hosting-deploy-on-cloudflare-5-10-minutes) + - [Prerequisites](#prerequisites) + - [Deploy OpenSEO](#deploy-openseo) +- [Local Development](#local-development) + - [Prerequisites](#prerequisites-1) + - [Run Locally (Quick Test)](#run-locally-quick-test) + - [Local Development Workflow (for coding agents)](#local-development-workflow-for-coding-agents) + - [Database Commands](#database-commands) +- [Contributing](#contributing) +- [SEO API Cost Reference](#seo-api-cost-reference) + - [Pricing sources](#pricing-sources) + - [1) Site audit](#1-site-audit) + - [2) Keyword research (`related` mode)](#2-keyword-research-related-mode) + - [3) Domain overview](#3-domain-overview) + - [Planning examples](#planning-examples) + ## Why Use This - Open source and self-hostable. @@ -60,14 +83,15 @@ Note: even though the env var is named `DATAFORSEO_API_KEY`, this app sends it a OpenSEO is built on [Every App](https://github.com/every-app/every-app), a platform for easily self-hosting open source apps like OpenSEO in your own Cloudflare account. Cloudflare enables much more powerful functionality than is possible running on your own computer or on a VPS. -*Windows Users* +_Windows Users_ -This has not been tested on Windows. Please let me know if you run into problems. Using WSL will likely work better. Also, try using [fly.io Sprites](https://sprites.dev/) to get a linux sandbox for free if you get totally stuck. +This has not been tested on Windows. Please let me know if you run into problems. Using WSL will likely work better. Also, try using [fly.io Sprites](https://sprites.dev/) to get a linux sandbox for free if you get totally stuck. ### Prerequisites + If you don't want to make a Cloudflare account yet (its easy!) and just want to test out OpenSEO, skip to the [Run Locally](#seo-api-cost-reference) section. -Note: If you're not comfortable with the terminal or these phrases, ChatGPT or Claude will do a good job coaching you through this. +Note: If you're not comfortable with the terminal or these phrases, ChatGPT or Claude will do a good job coaching you through this. 1. Install [Node.js](https://nodejs.org/) (includes `npx`). 2. Create a Cloudflare account: [dash.cloudflare.com/sign-up](https://dash.cloudflare.com/sign-up) @@ -84,7 +108,8 @@ npx everyapp gateway deploy ``` 5. Create an Account -- Follow the link output by the last command to create an account. You will access OpenSEO through this account. + +- Follow the link output by the last command to create an account. You will access OpenSEO through this account. ### Deploy OpenSEO @@ -133,7 +158,7 @@ Running locally is the fastest way to test core flows. In the future, local mode ### Local Development Workflow (for coding agents) ```sh -# This log file make it easier for your coding agent to debug. +# This log file make it easier for your coding agent to debug. mkdir .logs touch .logs/dev-server.log # terminal 1: start once and keep running From 45412263b233c266a7f65d57da2399370a225acc Mon Sep 17 00:00:00 2001 From: Ben Senescu <44480372+bensenescu@users.noreply.github.com> Date: Fri, 27 Feb 2026 15:04:23 -0500 Subject: [PATCH 2/2] Update README links and structure for clarity --- README.md | 17 +++-------------- 1 file changed, 3 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 029c516..79c05aa 100644 --- a/README.md +++ b/README.md @@ -9,23 +9,12 @@ OpenSEO is an SEO tool for _the people_ (non-seo professionals). If tools like S - [Why Use This](#why-use-this) - [Main SEO Workflows](#main-seo-workflows) - [Roadmap](#roadmap) -- [Pricing / Costs](#pricing--costs) -- [DataForSEO API Key Setup \\[5 minutes\\]](#dataforseo-api-key-setup-5-minutes) -- [Self Hosting (Deploy on Cloudflare) \\[5-10 minutes\\]](#self-hosting-deploy-on-cloudflare-5-10-minutes) - - [Prerequisites](#prerequisites) - - [Deploy OpenSEO](#deploy-openseo) +- [Pricing / Costs (Free + API costs)](#pricing--costs) +- [DataForSEO API Key Setup \[5 minutes\]](#dataforseo-api-key-setup-5-minutes) +- [Self Hosting (Deploy on Cloudflare) \[5-10 minutes\]](#self-hosting-deploy-on-cloudflare-5-10-minutes) - [Local Development](#local-development) - - [Prerequisites](#prerequisites-1) - - [Run Locally (Quick Test)](#run-locally-quick-test) - - [Local Development Workflow (for coding agents)](#local-development-workflow-for-coding-agents) - - [Database Commands](#database-commands) - [Contributing](#contributing) - [SEO API Cost Reference](#seo-api-cost-reference) - - [Pricing sources](#pricing-sources) - - [1) Site audit](#1-site-audit) - - [2) Keyword research (`related` mode)](#2-keyword-research-related-mode) - - [3) Domain overview](#3-domain-overview) - - [Planning examples](#planning-examples) ## Why Use This