Skip to main content

Purpose

Creates AI-specific articles - SEO-optimized content pages designed to increase visibility in AI search results. Each page targets a specific topic related to the business.

Architecture

4-Step Pipeline

StepServicePurpose
1get_source_deploymentGet AI site URL and existing posts
2scrape_ai_siteScrape deployed AI site for content
3generate_article_contentUse LLM to create new page content
4generate_article_filesGenerate HTML, update sitemap, llms.txt

URL Structure

AI articles are published at root level for better AI SEO:
https://business.searchcompany.dev/topic-slug/
https://business.searchcompany.dev/another-topic/

Generated Files

FilePurpose
/{slug}/index.htmlThe AI article HTML
/sitemap.xmlUpdated with new page
/llms.txtUpdated with new page reference

Code Location

src/app/apis/cron/create_boosted_page/
├── routes.py              # HTTP endpoint
├── mini_orchestrator.py   # Main orchestrator
├── url_utils.py           # URL/slug utilities
└── children/
    ├── step_1_get_source.py
    ├── step_2_scrape_ai_site.py
    ├── step_3_generate_content.py
    ├── step_4_generate_files.py
    └── templates/
        ├── article_html.py
        ├── article_index.py
        ├── article_llms_txt.py
        ├── llms_txt_update.py
        └── sitemap_update.py

Response Format

{
  "status": "success",
  "files": [...],
  "article_url": "https://business.searchcompany.dev/topic-slug/",
  "article_path": "/topic-slug/",
  "article_id": "article_abc123",
  "title": "Topic Title",
  "project_name": "business-abc123",
  "ai_site_url": "https://business.searchcompany.dev",
  "faq_category": "business_article"
}
This endpoint generates files but does NOT deploy. Call deploy-to-vercel separately with the returned files.