How iamramgarhia/all-in-one-free-seo-tool works
This is a self-hosted SEO platform for freelancers and agencies. The main workflow is to onboard client sites, audit and monitor them, turn findings into managed fixes or agent actions, then report outcomes. Major parallel capabilities include research/rank tracking, AI-search visibility, local SEO, automation, proposals, and integrations. Some feature subsystems are represented by their exact enclosing directories because their implementation was not sampled; edges are limited to README statements and relationships visible in the source index or excerpts.
Main entry points: client.ts Application database · actions.ts Client onboarding · automation-engine.ts Automation engine · ai-site-audit.ts Site audits
Components 23
Client Management
- Client onboarding
src/app/clients/actions.ts - Client reports
src/app/reports - Proposals
src/app/proposals/actions.ts
SEO Workflows
- Site audits
src/lib/ai-site-audit.ts - Keywords and rankings
src/app/keywords - AI search visibility
src/app/ai-visibility - Local SEO
src/app/gbp - Backlinks and competitors
src/app/backlinks - Content tools
src/app/tools
Planning and Automation
- Tasks and planning
src/app/tasks - Autonomous agent
src/lib/agent/executor.ts - Automation engine
src/lib/automation-engine.ts
Platform Services
- Authentication
src/lib/auth.ts - Provider settings
src/lib/settings-store.ts - Activity log
src/lib/activity.ts - Application database
src/db/client.ts - Domain schema
src/db/schema.ts
External Connections
- WordPress bridge
wordpress-plugin/seo-tool-bridge.php - MCP tools
src/lib/mcp/server.ts - Public API
src/app/api/v1 - AI providers
- Search data services
Other components
- Agency user
Connections 26
- Agency user → Client onboarding: onboards sites
- Client onboarding → Site audits: starts audit
src/app/clients/actions.ts - Agency user → Keywords and rankings: researches keywords
- Agency user → AI search visibility: checks visibility
- Agency user → Local SEO: manages local SEO
- Agency user → Backlinks and competitors: analyzes links
- Agency user → Content tools: uses content tools
- Agency user → Client reports: generates reports
- Agency user → Proposals: creates proposals
- Agency user → Automation engine: configures automations
- Site audits → Proposals: informs proposals
- Site audits → Autonomous agent: agent fixes findings
- Autonomous agent → WordPress bridge: writes site fixes
- MCP tools → Public API: served by route
- MCP tools → Provider settings: reads settings
src/lib/mcp/server.ts - MCP tools → AI providers: invokes tools
- Provider settings → Application database: reads and writes
src/lib/settings-store.ts - Application database → Domain schema: uses schema
src/db/client.ts - Client onboarding → Application database: persists clients
src/app/clients/actions.ts - Client onboarding → Site audits: calls audit module
src/app/clients/actions.ts - Automation engine → Application database: loads automations
src/lib/automation-engine.ts - Automation engine → Tasks and planning: creates tasks
src/lib/automation-engine.ts - Automation engine → Activity log: logs activity
src/lib/automation-engine.ts - Activity log → Application database: writes log
src/lib/activity.ts - Agency user → Search data services: connects data sources
- Keywords and rankings → Search data services: uses search data