Apify Market Intelligence

A powerful Apify Actor that scrapes the Apify Store to find Hot Niches and Trending Actors, then generates an interactive Market Intelligence Dashboard.

🎯 What It Does

1. Scrapes the Apify Store to collect actor data (runs, stars, publication date, categories)
2. Analyzes trends to identify top movers, competitive niches, and blue ocean opportunities
3. Generates a beautiful, self-contained HTML dashboard that you can view and share

🚀 Quick Start

Install Dependencies

$npm install

Build the Project

# Build dashboard (creates single HTML file)
npm run build:dashboard

# Build crawler (compiles TypeScript)
npm run build:crawler

# Build everything
npm run build

Run Locally

# Development mode (using tsx)
npm run start:dev

# Production mode (after build)
npm start

Preview Dashboard

$npm run dev:dashboard

Then open http://localhost:5173 to see the dashboard with demo data.

📊 Dashboard Features

• KPI Cards: Top Mover, Most Competitive Niche, Blue Ocean Opportunity
• Bar Chart: Top 10 actors by total runs with growth indicators
• Scatter Plot: Actor age vs. performance to spot viral launches
• Data Table: Sortable, searchable list of all scraped actors

🏗️ Architecture

Input → CheerioCrawler → Data Analysis → JSON → HTML Injection → Key-Value Store

The "Zero Hosting" trick:

1. Actor runs the crawler
2. Saves data to a JSON object
3. Loads pre-built React dashboard template
4. Injects JSON data into <script id="report-data">
5. Saves the final HTML to Apify Key-Value Store
6. Returns the public URL

📁 Project Structure

├── src/
│   ├── main.ts              # Actor entry point & crawler
│   ├── types.ts             # TypeScript interfaces
│   ├── analytics.ts         # Data analysis functions
│   ├── report-generator.ts  # HTML injection & output
│   └── dashboard/           # React dashboard
│       ├── App.tsx
│       └── components/
├── .actor/                  # Apify configuration
├── Dockerfile               # Multi-stage build
└── vite.config.ts           # Single-file HTML build

🔧 Configuration

The Actor accepts the following input:

Field	Type	Default	Description
maxActors	number	100	Maximum actors to scrape (0 = unlimited)
includeCategories	string[]	[]	Filter by categories
generateMockHistory	boolean	true	Generate demo growth data

📄 License

MIT