A RSS Feed Generator that creates RSS feeds for blogs that don't provide their own.

1. JSON Configuration: Define blogs and scraping rules in /blogs.json
2. Automated Scraping: Cron job runs hourly to scrape configured blogs
3. RSS Generation: Converts scraped posts to valid RSS XML
4. Feed Serving: Access feeds at /rss/<slug>.xml

flowchart TD
    %% Configuration
    A[blogs.json<br/>📋 Blog configurations] --> B[cron_generateFeeds.ts<br/>⏰ Hourly cron job]
    
    %% Scraping Flow
    B --> C[scraper.ts<br/>🕷️ CSS selector scraping]
    C --> D[rss.ts<br/>📄 RSS XML generation]
    D --> E[(Blob Storage<br/>💾 Val Town storage)]
    
    %% HTTP API Flow
    F[👤 User Request] --> G[index.ts<br/>🌐 HTTP API Server]
    G --> H{Request Type?}
    
    %% Different endpoints
    H -->|GET /| I[📊 Status Dashboard<br/>HTML page]
    H -->|GET /status| J[📈 JSON Status API]
    H -->|GET /rss/:slug.xml| K[📡 RSS Feed XML]
    
    %% Data retrieval
    I --> E
    J --> E
    K --> E
    
    %% Storage details
    E --> L[RSS Files<br/>rss_slug.xml]
    E --> M[Metadata<br/>meta_slug.json]
    
    %% External sources
    N[🌐 Blog Websites] --> C
    
    %% Styling
    classDef service fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    classDef storage fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    classDef config fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px
    classDef endpoint fill:#fff3e0,stroke:#e65100,stroke-width:2px
    
    class B,C,D,G service
    class E,L,M storage
    class A config
    class I,J,K endpoint

• HTTP API (/services/index.ts): Serves RSS feeds via Hono routing
• Cron Scraper (/services/cron_generateFeeds.ts): Hourly blog scraping and RSS generation
• Generic Scraper (/services/scraper.ts): CSS selector-based blog parsing
• RSS Generator (/services/rss.ts): Converts posts to RSS XML format

• Neynar Blog: /rss/neynar.xml - https://artivilla--442b5b3e6f9511f08f640224a6c84d84.web.val.run/rss/neynar.xml

1. Add a new entry to /blogs.json with CSS selectors
2. The cron job will automatically pick it up on the next run
3. Feed will be available at /rss/<your-slug>.xml

• GET / - Interactive status dashboard showing all feeds and their last successful generation times

• GET /rss/<slug>.xml - RSS feed for a specific blog

• GET /status - JSON status of all feeds with metadata

• Uses Val Town Blob Storage with single key per feed: rss_{slug}.xml
• Metadata stored as meta_{slug} with generation timestamps and post counts
• Feeds are updated only on successful scrapes
• Stale feeds are served indefinitely until next successful update