Medium Agent Ecosystem

A comprehensive system for scraping and processing Medium articles with three interfaces:

1. Apify Actor - Cloud scraping
2. MCP Server - Claude Desktop integration
3. Gradio UI - Web interface

🎯 Quick Start

See component-specific READMEs:

• Medium-Scraper - Apify Actor for cloud scraping
• medium-mcp-server - MCP server for Claude Desktop

📋 Recent Improvements

🚀 Major v3.0 Update (Dec 2025)

• ⚡ 15x Faster Scraping: New GraphQL-first architecture reduces scrape time from ~30s to ~2s.
• 🎨 HTML Export: Full-fidelity HTML output with syntax highlighting, images, and author cards.
• 🧠 Analyst Intelligence: Deep content analysis reports with PDF export and TTS generation.
• 🧪 Comprehensive Testing: Unified test suite for end-to-end verification.
• 🛡️ Enhanced Resilience: Shared configuration, rate limiting, and circuit breakers.

For details, see:

• Implementation Summary
• Verification Report

⚙️ Configuration

Both components share a centralized configuration system. Create .env from .env.example:

cp .env.example .env
# Edit .env with your settings

Key configuration options:

• API Keys: GEMINI_API_KEY, OPENAI_API_KEY, ELEVENLABS_API_KEY
• Rate Limiting: RATE_LIMIT_RPM=60 (requests per minute)
• Workers: MAX_WORKERS=5 (parallel processing)
• Resilience: CIRCUIT_BREAKER_THRESHOLD=5 (failure threshold)

See .env.example for all 30+ configuration options.

📚 Documentation

• Implementation Guide: IMPLEMENTATION_SUMMARY.md
• Environment Setup: .env.example
• Verification: VERIFICATION_REPORT.md
• Testing: Run python test_implementation.py

🏗️ Architecture

┌─────────────────────────────────────────┐
│      Medium Agent Ecosystem             │
├─────────────────────────────────────────┤
│                                         │
│  ┌─────────────┐  ┌──────────────────┐ │
│  │   Shared    │  │   Shared Error   │ │
│  │   Config    │  │    Handling      │ │
│  └─────┬───────┘  └────────┬─────────┘ │
│        │                   │           │
│   ┌────┴──────────┬────────┴─────┐     │
│   │               │              │     │
│   ▼               ▼              ▼     │
│ ┌────────┐  ┌──────────┐  ┌────────┐  │
│ │ Scraper│  │   MCP    │  │Gradio │  │
│ │ (Apify)│  │  Server  │  │  UI   │  │  
│ └────────┘  └──────────┘  └────────┘  │
│                                         │
└─────────────────────────────────────────┘

🔒 Zero Breaking Changes

All improvements are 100% backward compatible:

• ✅ Existing Apify Actors work unchanged
• ✅ Claude MCP integration unchanged
• ✅ Gradio UI unchanged
• ✅ No migration required

📝 License

MIT

👤 Author

T0X1N

---

For detailed component documentation, see individual README files in each directory.