How nagarajumedi/open-seo works
OpenSEO is a self-hostable, pay-as-you-go SEO research suite with hosted accounts and project workspaces. Users select a project and run focused workflows—keyword and domain research, rank tracking, backlinks, audits, AI visibility, and search-performance analysis—then inspect results and manage integrations. The README also highlights MCP and agent skills as a way to use SEO data through AI agents. The tree and excerpts establish the main product areas, but do not show most server-function wiring, so uncertain call and persistence links are omitted.
Main entry points: _app/route.tsx App routes · $projectId/route.tsx Project workspace · KeywordResearchPage.tsx Keyword research · KeywordResearchService.ts Keyword research service
Components 24
Workspace and access
- App routes
src/routes/_app/route.tsx - Project workspace
src/routes/_project/p/$projectId/route.tsx - Authentication
src/lib/auth.ts - Project context
src/server/features/project-context/services/ProjectContextService.ts
SEO research
- Keyword research
src/client/features/keywords/page/KeywordResearchPage.tsx - Keyword research service
src/server/features/keywords/services/KeywordResearchService.ts - Domain insights
src/client/features/domain/DomainOverviewPage.tsx - Domain service
src/server/features/domain/services/DomainService.ts - Rank tracking
src/client/features/rank-tracking/RankTrackingOverview.tsx - Backlink analysis
src/client/features/backlinks/BacklinksPage.tsx - Backlink service
src/server/features/backlinks/services/BacklinksService.ts - Site audits
src/client/features/audit/launch/LaunchView.tsx - Audit service
src/server/features/audit/services/AuditService.ts
Measurement and AI
- AI visibility
src/client/features/ai-search/BrandLookupPage.tsx - AI search services
src/server/features/ai-search/services/brandLookup.ts - Search performance
src/client/features/search-performance/SearchPerformancePage.tsx - Google integrations
src/server/features/ga4/services/Ga4Service.ts
Services and integrations
- MCP and agent access
src/server/features/activation/mcpActivation.ts - Database provider
src/db/provider.ts - Application data
src/db/schema.ts
Other components
- SEO user
- DataForSEO
- Google services
- AI agent
Connections 23
- SEO user → App routes: opens
- App routes → Authentication: authenticates
- SEO user → Project workspace: selects project
- Project workspace → Project context: configures
- SEO user → Keyword research: researches keywords
- SEO user → Domain insights: explores domain
- SEO user → Rank tracking: tracks rankings
- SEO user → Backlink analysis: reviews backlinks
- SEO user → Site audits: starts audit
- SEO user → AI visibility: checks visibility
- SEO user → Search performance: reviews performance
- AI agent → MCP and agent access: uses SEO data
- Keyword research → Keyword research service
- Domain insights → Domain service
- Backlink analysis → Backlink service
- Site audits → Audit service: starts audit
- AI visibility → AI search services
- Search performance → Google integrations
- Keyword research service → DataForSEO
- Domain service → DataForSEO
- Backlink service → DataForSEO
- Database provider → Application data
- Google integrations → Google services