54 Commits

Author SHA1 Message Date
Ben Senescu
6fce0fb980
Update README.md 2026-06-17 16:00:19 -04:00
Ben Senescu
d339f0c3d9
Fix MCP output validation and error reporting 2026-06-16 13:52:59 -04:00
Ben Senescu
f1232554f1
Update README with hosted version information
Added a section about the hosted version of OpenSEO and updated the reasons to use OpenSEO.
2026-06-15 19:55:34 -04:00
Ben Senescu
8a85b7b794
AI Visibility: competitor Share of Voice + clarity fixes for AI citations (#248) 2026-06-09 22:33:11 -04:00
Ben Senescu
d459006f40
Restore and update 'Why use OpenSEO?' section
Reintroduce 'Why use OpenSEO?' section with key features.
2026-06-05 16:28:01 -04:00
Ben Senescu
6be0a54b15
Update README.md 2026-06-05 16:26:57 -04:00
Ben Senescu
f46e0b9539
Update image source in README.md 2026-06-04 18:15:13 -04:00
Ben Senescu
7a26be46cc
Self-hosted Google Search Console (#236) 2026-06-04 18:06:16 -04:00
Ben Senescu
1fd7b2cbce
Replace image in README.md
Updated image in README.md to a new source.
2026-06-02 16:41:05 -04:00
Ben Senescu
738497e749
Update section title and table of contents in README 2026-06-02 16:18:44 -04:00
Ben Senescu
9660838c1f
Update images in README.md 2026-06-02 16:17:14 -04:00
Ben Senescu
dae5cfd68e
readme: Add banner image (#234) 2026-06-02 14:27:20 -04:00
Ben Senescu
506dde84d1
Add additional MCP tools for Local SEO (#222) 2026-05-26 18:38:14 -04:00
Ben Senescu
0e75e07660
website: Add MCP and Skills Docs 2026-05-24 18:35:55 -04:00
Ben Senescu
90f369ad46
readme: update roadmap + add MCP and skills (#213) 2026-05-22 09:55:42 -04:00
Ben Senescu
a52cf0bf95 docs: tweak readme 2026-04-16 18:54:25 -04:00
Ben Senescu
53a83996ef feat: Rank Tracking MVP (#91) 2026-04-14 20:29:38 -04:00
Ben Senescu
01c11b0c5f
release: v0.0.5 (#102) 2026-04-08 14:18:46 -04:00
Ben Senescu
d773105e8d fix: use backlinks history for default trends (#69)
* fix: use backlinks history for default trends

* simplify backlinks: remove filters, always use history endpoint

Remove the filter UI (status, subdomains, indirect links, exclude internal)
and hardcode defaults across the stack. Replace the conditional
timeseries_summary + timeseries_new_lost_summary fallback with a single
backlinks/history/live call for trend data. This reduces the overview from
5 parallel API calls to 3 and removes all conditional branching.

* improve charts

* fix: refresh backlinks cost docs
2026-04-08 14:09:02 -04:00
Ben Senescu
a65c5fb00a
readme: add link to website
Updated social media and mailing list links in README.
2026-04-06 20:09:21 -04:00
Ben Senescu
638f5a6602 refactor: move lighthouse audits to dataforseo (#43)
* refactor: move lighthouse audits to dataforseo

* chore: remove obsolete audit settings modal

* refactor: rename psi flows to lighthouse

* save

* refactor: simplify audit lighthouse storage flow

* fix: separate lighthouse metrics from actionable audits

* refactor: remove redundant audit project inputs

* feat: redesign lighthouse issues screen with score gauges and table layout

Replace flat score cards with circular SVG gauges, condense metrics into
a compact grid, and switch issue list from cards to an expandable table
with fixed column widths.

* test: harden lighthouse regression coverage

* fix: restore project-scoped audit inputs

* refactor: simplify lighthouse payload handling

* refactor: inline lighthouse server handlers

* refactor: share audit workflow types

* refactor: simplify lighthouse payload flows

* save

* refactor: drop project pagespeed api key

* fix: restore lighthouse issues loading with resilient project context

* fix: restore audit issues back navigation

* refactor: simplify project context and lighthouse error handling

* fix: tolerate DataForSEO lighthouse payload drift

* refactor: route audit lighthouse through dataforseo client
2026-03-26 20:25:27 -04:00
Ben Senescu
4040a854a7
feat: Add better auth (#24)
* refactor: rename delegated auth user table

* feat: scaffold hosted better auth setup

* feat: add hosted auth flows

* refactor: scope project access to organizations

* fix: harden hosted auth entry points

* fix: stabilize org backfills and auth state

* refactor: simplify hosted organization setup

* fix: restore hosted auth signup flow

* fix: preserve hosted workspace access

* fix: preserve hosted auth redirects

* Improve hosted auth UX: auto-redirect to sign-up, hide header on auth pages, add form placeholders, and trust portless dev origins

- Auto-redirect unauthenticated users to /sign-up in hosted mode
- Hide top nav on /sign-in and /sign-up for a cleaner auth experience
- Add input placeholders across sign-in and sign-up forms
- Make name field optional on sign-up (falls back to email username)
- Update copy: remove 'hosted' from user-facing text, rename link to 'Create account'
- Trust *.open-seo.localhost:1355 in dev mode to fix Better Auth origin rejection with portless worktrees

* Simplify hosted auth flow and remove standalone PSI

Use TanStack Form for sign-in and sign-up, make hosted unauthenticated handling redirect-focused, and inline auth route errors. Remove the leftover standalone PSI route, services, and table so PSI only exists within site audits.

* Align project auth with Better Auth organizations

* Make server function auth middleware global

* Reduce auth server function boilerplate

* delete migrations

* fix regenerated migration data backfills

* Simplify hosted auth flow and project audit scoping

* Use active project context for audit actions

* Allow hosted session project updates

* Let agent dev server inherit auth mode

* Match hosted header to gateway account menu

* Scope project session updates to active project

* Inline authenticated server function setup

* Polish header project and account controls

* restore auth generate script

* Use explicit project access in server functions

Make project-scoped server functions take projectId input and enforce ownership through shared middleware instead of session-backed current project state. Document the tradeoffs in an ADR so future changes can follow the same boundary.

* fix ci dependency detection for auth tooling

* Harden project auth in server middleware

Authorize projectId automatically in authenticated server middleware and add a requireProject guard for project-scoped handlers. This makes the auth boundary harder to bypass and removes ad hoc non-null assertions from server functions.

* Inline project id input schemas

Remove tiny shared projectId schema helpers where they were adding indirection without reducing real complexity. Keep project-scoped validation explicit at each server function boundary.

* Skip hosted backlinks access checks

* Simplify auth mode helpers

* Avoid rerunning auth server middleware

* Simplify server function scoping ADR

* Fix backlinks project scoping in hosted auth

* Refine auth route foundations

* Simplify ensure user auth resolution

Split auth-mode context resolvers into focused modules so the middleware reads as request orchestration instead of implementation details. Reuse a shared ensured-user context type across server middleware.

* Simplify hosted organization bootstrap

Use Better Auth to own hosted organization creation and membership so hosted auth only needs to resolve a default active organization. Keep delegated-mode compatibility records isolated in a separate helper.

* Clarify hosted auth and backlinks behavior

Document the hosted AUTH_MODE deploy contract and explain why hosted deployments skip manual backlinks verification. This makes the platform-managed behavior explicit in the code paths that differ from self-serve mode.

* Document hosted org creation callback

Explain why auth.ts injects createOrganization into the hosted org helper. This makes the dependency direction explicit and avoids future import cycles while keeping the helper reusable.

* Fix CI check failures

* Fix nav link prop forwarding

* save
2026-03-19 19:24:34 -04:00
Ben Senescu
23fb595755
chore: rename references to open-rank back to open-seo (#35)
* docs: move project docs into docs directory

* docs: rebrand landing site as OpenSEO

* fix: update remaining OpenSEO backlinks links

* Change landing page copy + format

* website: add www custom domain route

* Tweak README

* save
2026-03-16 18:58:44 -04:00
Ben Senescu
8405564925
feat: Add Backlinks page (#23)
* feat: add backlinks setup and overview workflow

* save

* fix backlinks timeseries and refine overview layout

* update backlinks table guidance

* refactor backlinks CI cleanup

* refactor backlinks page state colocation

* fix backlinks access error handling

Differentiate DataForSEO subscription access failures from billing issues and preserve exact page hosts for page-level backlink lookups.

* fix backlinks project scoping and error states

* simplify backlinks billing and lazy loading

* harden backlinks profiling and access flow

* refine backlinks access status typing

* update backlinks scope selection and access handling

* fix backlinks scope fallback and cache scoping

* fix backlinks ci checks

* docs: simplify backlinks pricing

* refine backlinks search: move scope toggle below input, remove redundant description

* refine backlinks summaries and help text

* refine backlinks table sorting

* fix backlinks invalid target handling

* delete docs

* fix backlinks scope inference and domain normalization

* docs: mark backlinks as a supported workflow

* fix backlinks links badge wrapping

* test: split backlinks test suites
2026-03-16 17:48:13 -04:00
Ben Senescu
b859fae8dc
docs: move project docs into docs directory (#32) 2026-03-16 17:38:24 -04:00
Ben Senescu
534d4e2093 docs: clarify updating docker self hosted instances 2026-03-16 15:10:05 -04:00
Ben Senescu
33173f5c04
chore: publish OpenSEO Docker images and use image-first self-host flow (#18)
* chore: add published Docker image workflow and self-host image flow

* fix: align Docker publish and build paths

Use the canonical GHCR image name and correct Dockerfile path references so CI publishing and documented local builds work as expected.

* fix: restore Docker self-host runtime defaults

Use the full Node base image and expose Compose env vars to the Cloudflare Vite runtime so local self-hosting keeps auth bindings and outbound HTTPS working.
2026-03-12 19:28:45 -04:00
Ben Senescu
6017fbc4ef
feat: Add DataForSEO key setup guard and onboarding help (#12)
* add DataForSEO key setup guard and onboarding help

Detect missing DataForSEO credentials at app load so users get a clear setup path before running SEO workflows.

* fix api key setup warning visibility and help docs

Make the setup warning fail-safe when status checks error, switch the top notice to DaisyUI alert styling, and add Cloudflare dashboard secret instructions to the help page.

* fix README formatting for CI

* fix seo api key status fallback behavior

* harden DataForSEO setup status checks and modal UX

Gate API key status behind authenticated middleware and improve the setup modal’s keyboard/accessibility behavior, with a clearer fallback notice when status checks fail.

* refine setup UX and local env docs

Hide the API key setup modal on the setup guide route to avoid a self-blocking flow, and clarify README local configuration for DATAFORSEO_API_KEY format.
2026-03-11 15:12:29 -04:00
Ben Senescu
f75bbaeb37
Enforce type-aware TypeScript linting and remove unsafe assertions (#15)
* Enforce safe TypeScript assertions and validate runtime payloads

* Fix CI knip config and floating promise lint

* Validate DataForSEO payloads with Zod schemas

Replace weak object guards with endpoint-level schema parsing so invalid API shapes fail fast instead of being silently filtered. Align downstream keyword mapping with the stricter validated payload contracts.
2026-03-11 11:56:48 -04:00
Ben Senescu
a3b1f6e967
update README (#11) 2026-03-10 22:51:40 -04:00
Ben Senescu
991799932f
docs: Add better Cloudflare Hosting docs (#10)
* chore: bump @every-app/sdk to 0.1.14 for deploy install

* Add selfhosting to Cloudflare file

* Revise Cloudflare deployment instructions in README

Updated instructions for Cloudflare deployment and setup.

* docs: streamline self-hosting docs and split Cloudflare guide

* save
2026-03-10 21:44:50 -04:00
Ben Senescu
3e489d0771
feat: remove Every App dependency (#8)
* remove Every App SDK and add auth modes for Cloudflare Access and local_noauth

* align local dev auth defaults and normalize Access team domain

* Apply suggestions from code review

* restore local drizzle D1 URL helper

* save

* fix auth error mapping and document self-hosting setup

* Tweak readme

* improve auth config error UI and remove manifest link

* fix team domain config validation and docs anchor
2026-03-10 14:36:16 -04:00
Ben Senescu
0bd61ae264 Link portless in local development docs 2026-03-09 23:49:16 -04:00
Ben Senescu
d60276de9e Remove Cloudflare self-hosting section from README 2026-03-09 23:47:26 -04:00
Ben Senescu
d490dde51f Simplify Docker self-hosting configuration 2026-03-09 23:37:58 -04:00
Ben Senescu
2d01ce5196 Remove obsolete Docker helper scripts 2026-03-09 23:25:47 -04:00
Ben Senescu
71da670924 Simplify Docker self-hosting commands and env flow 2026-03-09 23:20:23 -04:00
Ben Senescu
2acf943346 Standalone OpenSEO docker 2026-03-08 15:21:01 -04:00
Ben Senescu
c20ea9f851 Update .env.example 2026-03-04 20:46:42 -05:00
Ben Senescu
be50738dad
Use portless for local dev and agents (#5)
* Use portless for local dev and agents

* save

* save
2026-03-04 16:33:55 -05:00
Ben Senescu
35700ca80a
Improve error handling + local setup (#4)
* Add unified Docker self-host stack for OpenSEO and Gateway

* Fix self-host migration flow and env wiring

* Track latest gateway release by default and harden migrations

* Fix gateway static asset serving in self-host runtime

* Run gateway self-host from source with .env-based Vite runtime

* Harden self-host env mode and remove apt dependency from gateway build

* Avoid gateway build ENOSPC by installing deps at runtime

* Revert temporary ENOSPC workaround for gateway Docker setup

* Use Cloudflare selfhost env precedence for Docker runtime

* Add selfhost wrangler environment and tighten Docker docs

* Stabilize selfhost Docker runtime and persistence

Use full Node base images for reliable TLS trust, simplify selfhost startup/env handling, and persist local gateway wrangler state to avoid resets between restarts.

* Simplify Docker selfhost: rename scripts to docker:selfhost:*, remove GATEWAY_RELEASE_REPO, default to latest gateway

* Remove selfhost wrangler env, use .env.local everywhere, simplify docker script names

* Simplify selfhost compose: remove D1 preflight, conditional migration, and healthcheck

* Extract inline Node.js from gateway Dockerfile into standalone scripts

* Save

* Move OpenSEO dependency install from container startup to image build step

* Move self-host docker scripts and compose into dedicated folder

* save

* disable TanStack devtools in Docker self-host

* Make edits

* clarify self-hosting env setup docs

* save

* save

* centralize server-function error middleware and simplify client-safe messaging

* remove local migration-specific error remapping

Keep auth middleware simple by letting DB/schema failures flow through the centralized error handler and remove the unused LOCAL_DB_MIGRATION_REQUIRED client/server code path.

* remove custom error logging in favor of plain console.error

* standardize PSI error codes and sanitize non-Error throws
2026-03-04 16:27:41 -05:00
Ben Senescu
4350b12c67 Support docker compose self hosting 2026-03-04 14:45:36 -05:00
Ben Senescu
b1e634166a
Fix grammatical error in README description 2026-03-03 12:05:20 -05:00
Ben Senescu
d3cce8e0b1
Add walkthrough video 2026-03-02 17:25:14 -05:00
Ben Senescu
5d2f867316
Clarify OpenSEO description in README
Removed 'professionals' from the description for clarity.
2026-02-28 19:49:12 -05:00
Ben Senescu
aa518b6e0b
Add Community section to README
Added a Community section with Discord link and social media.
2026-02-27 17:06:50 -05:00
Ben Senescu
4fe0a1a73c
Update demo image link in README.md 2026-02-27 16:58:59 -05:00
Ben Senescu
2c90e05368
Revise README for Self Hosting and API Key Setup
Updated the README to remove the DataForSEO API Key Setup section and adjust the Self Hosting instructions.
2026-02-27 15:51:53 -05:00
Ben Senescu
236694032d Fix reference to super-seo 2026-02-27 15:18:52 -05:00
Ben Senescu
45412263b2
Update README links and structure for clarity 2026-02-27 15:04:23 -05:00