athina-ai/site-content-catalog

Site Content Catalog

Crawl a website's sitemap and blog to build a complete content inventory — every page cataloged with URL, title, date, content type, and topic cluster. Groups content by category, identifies publishing patterns, and optionally deep-analyzes top pages.

Quick Start

# Basic content inventory
python3 scripts/catalog_content.py --domain "example.com"

# With deep analysis of top 20 pages
python3 scripts/catalog_content.py --domain "example.com" --deep-analyze 20

# Output to specific file
python3 scripts/catalog_content.py --domain "example.com" --output content-inventory.json

Inputs

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | domain | Yes | — | Domain to catalog (e.g., "example.com") | | deep-analyze | No | 0 | Number of top pages to deep-read for content analysis | | output | No | stdout | Path to save JSON output | | include-non-blog | No | true | Also catalog landing pages, docs, etc. (not just blog) |

Cost

• Sitemap/RSS crawling: Free (direct HTTP requests)
• Apify sitemap extractor (fallback): ~$0.50 per site
• Deep analysis: Free (WebFetch on individual pages)

Process

Phase 1: Discover All Pages

The script attempts multiple methods to find all pages on a site, in order:

A) Sitemap.xml

1. Fetch https://[domain]/sitemap.xml
2. If it's a sitemap index, recursively fetch all child sitemaps
3. Common alternate locations: /sitemap_index.xml, /sitemap-index.xml, /wp-sitemap.xml
4. Check robots.txt for Sitemap: directives

B) RSS/Atom Feeds

1. Check /feed, /rss, /atom.xml, /blog/feed, etc.
2. Extract posts with titles, dates, and URLs
3. RSS typically only surfaces recent content (last 10-50 posts)

C) Blog Index Crawl

1. Fetch /blog, /resources, /insights, /news, /articles
2. Extract links from the page
3. Follow pagination if present (/blog/page/2, ?page=2, etc.)

D) Site: Search (fallback)

1. WebSearch: site:[domain] to estimate total indexed pages
2. WebSearch: site:[domain]/blog to find blog content
3. WebSearch: site:[domain] intitle: to discover page title patterns

E) Apify Sitemap Extractor (fallback for JS-heavy sites)

• Actor: onescales/sitemap-url-extractor
• Use when sitemap.xml is missing and the site is JS-rendered

Phase 2: Classify Each Page

For each discovered URL, classify by:

Content Type

Classify based on URL patterns and page titles:

| Type | URL Patterns | Examples | |------|-------------|----------| | blog-post | /blog/, /posts/, /articles/ | How-to guides, opinion pieces | | case-study | /case-study/, /customers/, /success-stories/ | Customer stories | | comparison | /vs/, /compare/, /alternative/ | X vs Y pages | | landing-page | /solutions/, /use-cases/, /for-/ | Product marketing pages | | docs | /docs/, /help/, /documentation/, /api/ | Technical documentation | | changelog | /changelog/, /releases/, /whats-new/ | Product updates | | pricing | /pricing/ | Pricing page | | about | /about/, /team/, /careers/ | Company pages | | legal | /privacy/, /terms/, /security/ | Legal/compliance | | resource | /resources/, /guides/, /ebooks/, /webinars/ | Gated/downloadable content | | glossary | /glossary/, /dictionary/, /terms/ | SEO glossary pages | | integration | /integrations/, /apps/, /marketplace/ | Integration pages | | other | — | Anything else |

Topic Cluster

Group by extracting topic signals from URL slugs and titles:

• Extract keywords from URL path segments
• Group similar keywords into clusters (e.g., "aws-cost", "cloud-spending", "finops" → "Cloud Cost Management")
• Use simple keyword co-occurrence for clustering

Phase 3: Analyze Publishing Patterns

From the dated content (primarily blog posts):

• Total content pieces by type
• Publishing frequency: Posts per month over last 12 months
• Trend: Increasing, decreasing, or stable output
• Recency: Date of most recent publish
• Author diversity: Unique authors (if extractable from RSS)

Phase 4: Deep Analysis (Optional)

If --deep-analyze N is specified, fetch the top N pages (prioritizing blog posts) and extract:

• Word count (approximate)
• Target keyword (inferred from title + H1 + URL)
• Funnel stage: TOFU (awareness), MOFU (consideration), BOFU (decision)
• Content depth: Shallow (<500 words), Medium (500-1500), Deep (1500+)
• Has images/video: Boolean
• Has CTA: Boolean (detected by common CTA patterns)
• Internal links count

Phase 5: Output

JSON Output (default)

{
  "domain": "example.com",
  "crawl_date": "2026-02-25",
  "total_pages": 347,
  "discovery_methods": ["sitemap.xml", "rss"],
  "pages": [
    {
      "url": "https://example.com/blog/reduce-aws-costs",
      "title": "How to Reduce Your AWS Bill by 40%",
      "date": "2025-11-15",
      "type": "blog-post",
      "topic_cluster": "Cloud Cost Optimization",
      "deep_analysis": {
        "word_count": 2100,
        "target_keyword": "reduce aws costs",
        "funnel_stage": "TOFU",
        "content_depth": "deep",
        "has_images": true,
        "has_cta": true
      }
    }
  ],
  "summary": {
    "by_type": {"blog-post": 89, "landing-page": 23, "case-study": 12, ...},
    "by_topic": {"Cloud Cost Optimization": 34, "FinOps": 18, ...},
    "publishing_cadence": {
      "posts_per_month_avg": 4.2,
      "trend": "increasing",
      "most_recent": "2026-02-20"
    }
  }
}

Markdown Summary (also generated)

# Content Inventory: example.com
**Crawled:** 2026-02-25 | **Total pages:** 347

## Content by Type
| Type | Count | % |
|------|-------|---|
| Blog Posts | 89 | 25.6% |
| Landing Pages | 23 | 6.6% |
| ...

## Content by Topic Cluster
| Topic | Posts | Most Recent |
|-------|-------|-------------|
| Cloud Cost Optimization | 34 | 2026-02-20 |
| ...

## Publishing Cadence
- Average: 4.2 posts/month
- Trend: Increasing (3.1 → 5.4 over last 6 months)
- Most recent: 2026-02-20

## Full Catalog
| # | Date | Type | Topic | Title | URL |
|---|------|------|-------|-------|-----|
| 1 | 2026-02-20 | blog-post | Cloud Cost | How to Reduce... | https://... |

Tips

• Sitemap.xml is the best source. Most well-maintained sites have one. If missing, it's itself an SEO signal (negative).
• RSS only shows recent content. If you need the full catalog, sitemap is essential. RSS is supplementary.
• Deep analysis is optional but valuable. Use it when feeding into brand-voice-extractor or when you need funnel stage mapping.
• JS-rendered sites may need the Apify fallback. Signs: sitemap.xml returns HTML, or blog page returns mostly JavaScript.
• Combine with seo-domain-analyzer to overlay traffic data on the content inventory — see which content actually performs.

Dependencies

• Python 3.8+
• requests library (pip install requests)
• APIFY_API_TOKEN env var (only for Apify fallback mode)