How anasmohtaj-cell/seo_agent works
This repository is a small SEO operations service: HTTP requests launch site crawls and technical audits, expose their findings and reports, and apply or roll back publishing changes. The crawl and audit paths use in-memory state; audits analyze crawled pages with Lighthouse, while publishing delegates changes through a CMS connector. The README provides no architectural detail, so the graph follows the shown routes and source references; WordPress is imported by the publishing controller but its use is not shown.
Main entry points: technicalAgent.ts Technical Agent · server.ts Express Server · PublishingAgent.ts Publishing Agent · technicalController.ts Audit Controller
Components 22
HTTP API
- Express Server
src/server.ts - Crawl Routes
src/routes/crawlRoutes.ts - Crawl Controller
src/controllers/crawlController.ts - Audit Routes
src/routes/technicalRoutes.ts - Audit Controller
src/controllers/technicalController.ts - Publishing Routes
src/routes/publishingRoutes.ts - Publishing Controller
src/controllers/publishingController.ts
Crawl
- Crawl Agent
src/agents/crawl/CrawlAgent.ts - Finding Types
src/types/finding.ts
Technical Audit
- Technical Agent
src/agents/technical/technicalAgent.ts - Lighthouse
- Report Types
src/types/technicalReport.ts
Publishing
- Publishing Agent
src/agents/publishing/PublishingAgent.ts - Publishing Types
src/types/publishing.ts
State and Connectors
- Crawl Agent Store
src/services/crawlAgentStore.ts - Report Store
src/services/technicalReportStore.ts - Publishing Store
src/services/publishingStore.ts - CMS Connector
src/connectors/CMSConnector.ts - Mock CMS
src/connectors/MockCMSConnector.ts - WordPress Connector
src/connectors/wordpress/WordPressConnector.ts - Site Service
src/services/siteServices.ts
Other components
- API Client
Connections 24
- API Client → Express Server: sends requests
- Express Server → Crawl Routes: mounts routes
src/server.ts - Express Server → Audit Routes: mounts routes
src/server.ts - Express Server → Publishing Routes: mounts routes
src/server.ts - Crawl Routes → Crawl Controller: routes requests
src/routes/crawlRoutes.ts - Audit Routes → Audit Controller: routes requests
src/routes/technicalRoutes.ts - Publishing Routes → Publishing Controller: routes requests
src/routes/publishingRoutes.ts - Crawl Controller → Crawl Agent Store: starts crawl; reads findings
src/controllers/crawlController.ts - Crawl Agent Store → Crawl Agent: holds agent
src/services/crawlAgentStore.ts - Crawl Agent → Finding Types: uses types
src/agents/crawl/CrawlAgent.ts - Audit Controller → Technical Agent: starts audit
src/controllers/technicalController.ts - Audit Controller → Report Store: reads report
src/controllers/technicalController.ts - Technical Agent → Crawl Agent Store: gets pages
src/agents/technical/technicalAgent.ts - Technical Agent → Lighthouse: audits pages
src/agents/technical/technicalAgent.ts - Technical Agent → Report Store: saves report
src/agents/technical/technicalAgent.ts - Technical Agent → Report Types: builds reports
src/agents/technical/technicalAgent.ts - Technical Agent → Site Service: constructs service
src/agents/technical/technicalAgent.ts - Publishing Controller → Publishing Agent: applies or rolls back
src/controllers/publishingController.ts - Publishing Controller → Mock CMS: configures connector
src/controllers/publishingController.ts - Publishing Agent → Publishing Store: uses history store
src/agents/publishing/PublishingAgent.ts - Publishing Agent → CMS Connector: applies changes through
src/agents/publishing/PublishingAgent.ts - Publishing Agent → Publishing Types: uses types
src/agents/publishing/PublishingAgent.ts - Mock CMS → CMS Connector: implements contract
src/connectors/MockCMSConnector.ts - WordPress Connector → CMS Connector: implements contract
src/connectors/wordpress/WordPressConnector.ts