# iamramgarhia/all-in-one-free-seo-tool architecture

> Architecture diagram of the GitHub repository iamramgarhia/all-in-one-free-seo-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iamramgarhia/all-in-one-free-seo-tool
- Repository: https://github.com/iamramgarhia/all-in-one-free-seo-tool

## Overview

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: [`src/db/client.ts`](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/db/client.ts) (Application database), [`src/app/clients/actions.ts`](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/app/clients/actions.ts) (Client onboarding), [`src/lib/automation-engine.ts`](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/automation-engine.ts) (Automation engine), [`src/lib/ai-site-audit.ts`](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/ai-site-audit.ts) (Site audits)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client Management"]
  node_client_ui["Client onboarding<br/>[actions.ts]"]
  node_reports["Client reports"]
  node_proposals["Proposals<br/>[actions.ts]"]
end

subgraph group_seo["SEO Workflows"]
  node_audit["Site audits<br/>[ai-site-audit.ts]"]
  node_rank["Keywords and rankings"]
  node_visibility["AI search visibility"]
  node_local["Local SEO"]
  node_backlinks["Backlinks and competitors"]
  node_content["Content tools"]
end

subgraph group_action["Planning and Automation"]
  node_tasks["Tasks and planning"]
  node_agent["Autonomous agent<br/>[executor.ts]"]
  node_automation["Automation engine"]
end

subgraph group_platform["Platform Services"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_settings["Provider settings<br/>[settings-store.ts]"]
  node_activity["Activity log<br/>[activity.ts]"]
  node_data[("Application database<br/>[client.ts]")]
  node_schema["Domain schema<br/>[schema.ts]"]
end

subgraph group_integrations["External Connections"]
  node_wordpress["WordPress bridge"]
  node_mcp["MCP tools<br/>[server.ts]"]
  node_api["Public API"]
  node_ai_services{{"AI providers"}}
  node_search_services{{"Search data services"}}
end

node_agency(("Agency user"))

node_agency -->|"onboards sites"| node_client_ui
node_client_ui -->|"starts audit"| node_audit
node_agency -->|"researches keywords"| node_rank
node_agency -->|"checks visibility"| node_visibility
node_agency -->|"manages local SEO"| node_local
node_agency -->|"analyzes links"| node_backlinks
node_agency -->|"uses content tools"| node_content
node_agency -->|"generates reports"| node_reports
node_agency -->|"creates proposals"| node_proposals
node_agency -->|"configures automations"| node_automation
node_audit -->|"informs proposals"| node_proposals
node_audit -->|"agent fixes findings"| node_agent
node_agent -->|"writes site fixes"| node_wordpress
node_mcp -->|"served by route"| node_api
node_mcp -->|"reads settings"| node_settings
node_mcp -.->|"invokes tools"| node_ai_services
node_settings -->|"reads and writes"| node_data
node_data -->|"uses schema"| node_schema
node_client_ui -->|"persists clients"| node_data
node_client_ui -->|"calls audit module"| node_audit
node_automation -->|"loads automations"| node_data
node_automation -->|"creates tasks"| node_tasks
node_automation -->|"logs activity"| node_activity
node_activity -->|"writes log"| node_data
node_agency -.->|"connects data sources"| node_search_services
node_rank -.->|"uses search data"| node_search_services

click node_client_ui "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/app/clients/actions.ts"
click node_audit "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/ai-site-audit.ts"
click node_rank "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/keywords"
click node_visibility "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/ai-visibility"
click node_local "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/gbp"
click node_backlinks "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/backlinks"
click node_content "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/tools"
click node_reports "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/reports"
click node_proposals "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/app/proposals/actions.ts"
click node_tasks "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/tasks"
click node_agent "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/agent/executor.ts"
click node_automation "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/automation-engine.ts"
click node_wordpress "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/wordpress-plugin/seo-tool-bridge.php"
click node_mcp "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/mcp/server.ts"
click node_api "https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/api/v1"
click node_auth "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/auth.ts"
click node_settings "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/settings-store.ts"
click node_activity "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/activity.ts"
click node_data "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/db/client.ts"
click node_schema "https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/db/schema.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_ui,node_reports,node_proposals,node_agency toneBlue
class node_audit,node_rank,node_visibility,node_local,node_backlinks,node_content toneAmber
class node_tasks,node_agent,node_automation toneMint
class node_auth,node_settings,node_activity,node_data,node_schema toneRose
class node_wordpress,node_mcp,node_api,node_ai_services,node_search_services toneIndigo
```

## Components

### Client Management

- [Client onboarding](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/app/clients/actions.ts): `src/app/clients/actions.ts`
- [Client reports](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/reports): `src/app/reports`
- [Proposals](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/app/proposals/actions.ts): `src/app/proposals/actions.ts`

### SEO Workflows

- [Site audits](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/ai-site-audit.ts): `src/lib/ai-site-audit.ts`
- [Keywords and rankings](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/keywords): `src/app/keywords`
- [AI search visibility](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/ai-visibility): `src/app/ai-visibility`
- [Local SEO](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/gbp): `src/app/gbp`
- [Backlinks and competitors](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/backlinks): `src/app/backlinks`
- [Content tools](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/tools): `src/app/tools`

### Planning and Automation

- [Tasks and planning](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/tasks): `src/app/tasks`
- [Autonomous agent](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/agent/executor.ts): `src/lib/agent/executor.ts`
- [Automation engine](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/automation-engine.ts): `src/lib/automation-engine.ts`

### Platform Services

- [Authentication](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Provider settings](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/settings-store.ts): `src/lib/settings-store.ts`
- [Activity log](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/activity.ts): `src/lib/activity.ts`
- [Application database](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/db/client.ts): `src/db/client.ts`
- [Domain schema](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/db/schema.ts): `src/db/schema.ts`

### External Connections

- [WordPress bridge](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/wordpress-plugin/seo-tool-bridge.php): `wordpress-plugin/seo-tool-bridge.php`
- [MCP tools](https://github.com/iamramgarhia/all-in-one-free-seo-tool/blob/main/src/lib/mcp/server.ts): `src/lib/mcp/server.ts`
- [Public API](https://github.com/iamramgarhia/all-in-one-free-seo-tool/tree/main/src/app/api/v1): `src/app/api/v1`
- **AI providers**
- **Search data services**

### Other components

- **Agency user**

## Connections

- Agency user → Client onboarding: onboards sites
- Client onboarding → Site audits: starts audit (evidence: `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 (evidence: `src/lib/mcp/server.ts`)
- MCP tools → AI providers: invokes tools
- Provider settings → Application database: reads and writes (evidence: `src/lib/settings-store.ts`)
- Application database → Domain schema: uses schema (evidence: `src/db/client.ts`)
- Client onboarding → Application database: persists clients (evidence: `src/app/clients/actions.ts`)
- Client onboarding → Site audits: calls audit module (evidence: `src/app/clients/actions.ts`)
- Automation engine → Application database: loads automations (evidence: `src/lib/automation-engine.ts`)
- Automation engine → Tasks and planning: creates tasks (evidence: `src/lib/automation-engine.ts`)
- Automation engine → Activity log: logs activity (evidence: `src/lib/automation-engine.ts`)
- Activity log → Application database: writes log (evidence: `src/lib/activity.ts`)
- Agency user → Search data services: connects data sources
- Keywords and rankings → Search data services: uses search data
