How thusitha2001/acl-blog-agent works
ACL Blog Agent is an SEO content workspace centered on turning a keyword or brief into a publish-ready article, with progress streamed to the browser. Its main workflow analyzes live search results, builds a brief, optionally scrapes a supplied site, retrieves grounding context, generates an article and scores it. Separate product branches support competitor audits, rewriting, and editing. The README documents these capabilities; the sampled excerpts do not expose every API route or internal call, so uncertain connections are omitted.
Main entry points: pipeline_1click.py One-click pipeline · app.js Browser workspace · api.py FastAPI API · competitors.py Competitor analysis
Components 24
Article generation
- One-click pipeline
backend/acl_agent/pipeline_1click.py - Article generation
backend/acl_agent/generation.py - Quality validation
backend/acl_agent/validation.py - SEO scoring
backend/acl_agent/scoring.py - Article rewriter
backend/acl_agent/rewrite.py - Article and SEO output
Research and grounding
- SERP and brief
backend/acl_agent/auto_brief.py - Website scraping
backend/acl_agent/scraping.py - Knowledge retrieval
backend/acl_agent/knowledge_base.py
Content workspace
- Browser workspace
frontend/app.js - Competitor workspace
frontend/competitors.js - Article editor
frontend/editor.js
SEO analysis
- Competitor analysis
backend/acl_agent/competitors.py - Search Console diagnosis
backend/acl_agent/gsc_diagnosis.py - Analysis recommendations
backend/acl_agent/analysis_llm.py
Backend services
- FastAPI API
backend/acl_agent/api.py - Model client
backend/acl_agent/llm.py - Account service
backend/acl_agent/auth.py - Account records
backend/acl_agent/auth.py
Other components
- Writer
- Search results
- User website
- LLM provider
- Google Search Console
Connections 33
- Writer → Browser workspace: enters brief
- Browser workspace → FastAPI API: POSTs generation
- FastAPI API → One-click pipeline: invokes
- One-click pipeline → SERP and brief: analyzes and briefs
- SERP and brief → Search results: queries results
- One-click pipeline → Website scraping: scrapes optionally
- Website scraping → User website: fetches pages
- One-click pipeline → Knowledge retrieval: retrieves context
- One-click pipeline → Article generation: generates draft
- Article generation → Model client: requests completion
- Model client → LLM provider: calls model
- One-click pipeline → SEO scoring: scores article
- One-click pipeline → Quality validation: validates output
- One-click pipeline → FastAPI API: returns result
- FastAPI API → Browser workspace: streams progress and result
- Browser workspace → Article and SEO output: renders
- Writer → Competitor workspace: submits audit
- Competitor workspace → FastAPI API: requests analysis
- FastAPI API → Competitor analysis: dispatches audit
- Competitor analysis → Search results: checks SERP
- Competitor analysis → User website: fetches pages
- Competitor analysis → Search Console diagnosis: uses diagnosis
- Search Console diagnosis → Google Search Console: reads performance data
- Competitor analysis → Analysis recommendations: builds recommendations
- Analysis recommendations → Model client: requests advice
- Writer → Article editor: edits article
- Article editor → FastAPI API: requests scoring
- Writer → Browser workspace: requests rewrite
- Browser workspace → Article rewriter: streams rewrite request
- Article rewriter → Model client: requests rewrite
- Browser workspace → Account service: submits credentials
- Account service → Account records: reads and writes
- Account service → LLM provider