# baskar-forever/autoseo_publisher architecture

> Architecture diagram of the GitHub repository baskar-forever/autoseo_publisher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baskar-forever/autoseo_publisher
- Repository: https://github.com/baskar-forever/autoseo_publisher

## Overview

AutoSEO Publisher discovers timely topics, researches and drafts an article, applies quality and SEO improvements, then publishes it to WordPress. The sampled entry point confirms duplicate-topic checks, research, and publishing; the README describes validation and self-healing, while several post-processing steps are supported by the main.py reference index but not shown in its excerpt. Dashed edges mark those less-verified connections.

Main entry points: [`main.py`](https://github.com/baskar-forever/autoseo_publisher/blob/main/main.py) (Pipeline Runner), [`article_generater.py`](https://github.com/baskar-forever/autoseo_publisher/blob/main/article_generater.py) (Article Generator), [`wordpress_uploader.py`](https://github.com/baskar-forever/autoseo_publisher/blob/main/wordpress_uploader.py) (WordPress Uploader), [`tools/trend_keyword_tool.py`](https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/trend_keyword_tool.py) (Trend Discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Pipeline"]
  node_main["Pipeline Runner<br/>[main.py]"]
end

subgraph group_research["Discovery &amp; Research"]
  node_trend["Trend Discovery"]
  node_research_agent["Fact Research<br/>[research_agent.py]"]
  node_serp["Search Results<br/>[serp_tool.py]"]
end

subgraph group_writing["Article Creation"]
  node_article["Article Generator"]
  node_image_search["Image Search"]
  node_internal_links["Internal Links"]
end

subgraph group_quality["Quality &amp; SEO"]
  node_content_quality["Content Quality"]
  node_seo_validator["SEO Validation<br/>[seo_validator.py]"]
  node_link_audit["Link Audit<br/>[link_audit.py]"]
  node_external_links["External Link Resolution"]
  node_faq["FAQ Injection<br/>[faq_injector.py]"]
  node_image_optimizer["Image Optimization<br/>[image_optimizer.py]"]
  node_toc["Table of Contents<br/>[toc_generator.py]"]
  node_topic_guard["Topic Guard<br/>[topic_guard.py]"]
  node_transparency["Source Transparency"]
end

subgraph group_publishing["WordPress Publishing"]
  node_uploader["WordPress Uploader"]
  node_categorizer["Auto Categorization"]
  node_token_tracker["Token Tracking<br/>[token_tracker.py]"]
  node_wordpress[("WordPress")]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_main
node_main -.->|"discovers topics"| node_trend
node_main -->|"generates draft"| node_article
node_main -->|"runs research"| node_research_agent
node_article -->|"uses tool"| node_trend
node_article -->|"uses tool"| node_serp
node_article -->|"uses tool"| node_image_search
node_article -->|"uses tool"| node_internal_links
node_main -.->|"validates content"| node_content_quality
node_main -.->|"validates SEO"| node_seo_validator
node_main -.->|"audits links"| node_link_audit
node_main -.->|"resolves links"| node_external_links
node_main -.->|"adds FAQ"| node_faq
node_main -.->|"optimizes images"| node_image_optimizer
node_main -.->|"adds contents"| node_toc
node_main -.->|"checks topics"| node_topic_guard
node_main -.->|"adds transparency"| node_transparency
node_main -->|"publishes result"| node_uploader
node_uploader -->|"uploads posts"| node_wordpress
node_uploader -.->|"selects category"| node_categorizer
node_uploader -.->|"checks SEO"| node_seo_validator
node_uploader -.->|"tracks usage"| node_token_tracker

click node_main "https://github.com/baskar-forever/autoseo_publisher/blob/main/main.py"
click node_trend "https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/trend_keyword_tool.py"
click node_research_agent "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/research_agent.py"
click node_serp "https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/serp_tool.py"
click node_article "https://github.com/baskar-forever/autoseo_publisher/blob/main/article_generater.py"
click node_image_search "https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/image_search_tool.py"
click node_internal_links "https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/fetch_internal_links.py"
click node_content_quality "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/content_validator.py"
click node_seo_validator "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/seo_validator.py"
click node_link_audit "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/link_audit.py"
click node_external_links "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/external_link_resolver.py"
click node_faq "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/faq_injector.py"
click node_image_optimizer "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/image_optimizer.py"
click node_toc "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/toc_generator.py"
click node_topic_guard "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/topic_guard.py"
click node_transparency "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/source_transparency.py"
click node_uploader "https://github.com/baskar-forever/autoseo_publisher/blob/main/wordpress_uploader.py"
click node_categorizer "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/auto_categorizer.py"
click node_token_tracker "https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/token_tracker.py"

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_main toneBlue
class node_trend,node_research_agent,node_serp toneAmber
class node_article,node_image_search,node_internal_links toneMint
class node_content_quality,node_seo_validator,node_link_audit,node_external_links,node_faq,node_image_optimizer,node_toc,node_topic_guard,node_transparency toneRose
class node_uploader,node_categorizer,node_token_tracker,node_wordpress,node_operator toneIndigo
```

## Components

### Pipeline

- [Pipeline Runner](https://github.com/baskar-forever/autoseo_publisher/blob/main/main.py): `main.py`

### Discovery & Research

- [Trend Discovery](https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/trend_keyword_tool.py): `tools/trend_keyword_tool.py`
- [Fact Research](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/research_agent.py): `utils/research_agent.py`
- [Search Results](https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/serp_tool.py): `tools/serp_tool.py`

### Article Creation

- [Article Generator](https://github.com/baskar-forever/autoseo_publisher/blob/main/article_generater.py): `article_generater.py`
- [Image Search](https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/image_search_tool.py): `tools/image_search_tool.py`
- [Internal Links](https://github.com/baskar-forever/autoseo_publisher/blob/main/tools/fetch_internal_links.py): `tools/fetch_internal_links.py`

### Quality & SEO

- [Content Quality](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/content_validator.py): `utils/content_validator.py`
- [SEO Validation](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/seo_validator.py): `utils/seo_validator.py`
- [Link Audit](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/link_audit.py): `utils/link_audit.py`
- [External Link Resolution](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/external_link_resolver.py): `utils/external_link_resolver.py`
- [FAQ Injection](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/faq_injector.py): `utils/faq_injector.py`
- [Image Optimization](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/image_optimizer.py): `utils/image_optimizer.py`
- [Table of Contents](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/toc_generator.py): `utils/toc_generator.py`
- [Topic Guard](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/topic_guard.py): `utils/topic_guard.py`
- [Source Transparency](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/source_transparency.py): `utils/source_transparency.py`

### WordPress Publishing

- [WordPress Uploader](https://github.com/baskar-forever/autoseo_publisher/blob/main/wordpress_uploader.py): `wordpress_uploader.py`
- [Auto Categorization](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/auto_categorizer.py): `utils/auto_categorizer.py`
- [Token Tracking](https://github.com/baskar-forever/autoseo_publisher/blob/main/utils/token_tracker.py): `utils/token_tracker.py`
- **WordPress**

### Other components

- **Operator**

## Connections

- Operator → Pipeline Runner: runs (evidence: `README.md`)
- Pipeline Runner → Trend Discovery: discovers topics (evidence: `main.py`)
- Pipeline Runner → Article Generator: generates draft (evidence: `main.py`)
- Pipeline Runner → Fact Research: runs research (evidence: `main.py`)
- Article Generator → Trend Discovery: uses tool (evidence: `article_generater.py`)
- Article Generator → Search Results: uses tool (evidence: `article_generater.py`)
- Article Generator → Image Search: uses tool (evidence: `article_generater.py`)
- Article Generator → Internal Links: uses tool (evidence: `article_generater.py`)
- Pipeline Runner → Content Quality: validates content (evidence: `main.py`)
- Pipeline Runner → SEO Validation: validates SEO
- Pipeline Runner → Link Audit: audits links (evidence: `main.py`)
- Pipeline Runner → External Link Resolution: resolves links (evidence: `main.py`)
- Pipeline Runner → FAQ Injection: adds FAQ (evidence: `main.py`)
- Pipeline Runner → Image Optimization: optimizes images (evidence: `main.py`)
- Pipeline Runner → Table of Contents: adds contents (evidence: `main.py`)
- Pipeline Runner → Topic Guard: checks topics (evidence: `main.py`)
- Pipeline Runner → Source Transparency: adds transparency (evidence: `main.py`)
- Pipeline Runner → WordPress Uploader: publishes result (evidence: `main.py`)
- WordPress Uploader → WordPress: uploads posts (evidence: `wordpress_uploader.py`)
- WordPress Uploader → Auto Categorization: selects category (evidence: `wordpress_uploader.py`)
- WordPress Uploader → SEO Validation: checks SEO (evidence: `wordpress_uploader.py`)
- WordPress Uploader → Token Tracking: tracks usage (evidence: `wordpress_uploader.py`)
