Skip to content
Jithendar.com
ContentsShow or hide

Guide · SEO agent, AI & ML

The seo-agent service, in simple words

A helper program that runs next to the website and does the SEO work in the background.

For: adminsPage 28 of 71

Overview

The website and the seo-agent are two separate programs. The website shows pages and the admin. The seo-agent is a Python program that does the slow, background work, so the website stays fast.

  • It wakes up on a timetable (for example every morning at 06:10 UTC to fetch Search Console data). Pressing Run now in the admin, or asking through MCP, starts the same job straight away.
  • It fetches data from Google and DataForSEO and saves it in the same database the website uses.
  • It looks at the numbers, finds pages that can do better and asks Claude to write a suggested fix.
  • It saves every suggestion as a draft. It never publishes on its own.
  • It also trains the ML models each week, builds reports and keeps the Ask the Blog search index up to date.

Every run is listed in Data sync with its status, what it did and any errors. If the seo-agent is down, the website keeps working; only the background jobs wait.

Diagram

The SEO agent sits next to the web app: it reads Google data, drafts with Claude and saves drafts and numbers in the shared database.
Diagram (draw.io). Select it to open full size.

Where to find it

This page of the admin: /admin/sync. Only admins (and read-only demo accounts) can open it.