Claude Marketplace Aggregator

An automated, open-source aggregator that discovers and curates Claude Code marketplaces and plugins from across GitHub. Zero infrastructure — runs entirely on GitHub Actions and Pages as a self-updating artifact.

🌐 Live Demo · 📖 Documentation · 🤝 Contributing · 🐛 Report Issues

How It Works

Every day at midnight UTC, GitHub Actions scans the GitHub API for Claude Code plugin repositories, validates their manifests, generates data files, and publishes the results — fully automated, no servers required.

┌──────────────────────────────────────────────────────────────────┐
│                    GitHub Actions (Daily)                         │
│                                                                  │
│  Scan GitHub API  →  Validate Plugins  →  Generate Data          │
│                                                                  │
│  Create PR  →  Auto-approve (data-only check)  →  Merge to main  │
│                                                                  │
│  Build Static Site  →  Deploy to GitHub Pages                    │
└──────────────────────────────────────────────────────────────────┘

Data updates happen automatically — the pipeline creates PRs, verifies they only modify data files, and merges them without manual work. Code changes always require human review.

Features

🔍 Automated Discovery — Multi-strategy GitHub search finds Claude Code marketplaces and plugins daily
📊 Quality Scoring — Repositories scored by stars, activity, manifest completeness, and more
🔄 Self-updating — Scan → validate → PR → auto-merge → deploy, fully automated
🔒 Security Gates — Auto-merge only fires for data-only changes on the automated/* branch
🌐 Static Site — Next.js static generation on GitHub Pages, fast and free
🎯 Search & Filter — Browse by language, category, tags, and quality metrics
📱 Responsive — Works on desktop, tablet, and mobile

Quick Start

BASH

git clone https://github.com/shrwnsan/claude-marketplace-registry.git
cd claude-marketplace-registry
npm install
cp .env.example .env.local   # Add your GITHUB_TOKEN
npm run dev                  # http://localhost:3000

Prerequisites: Node.js 20+, npm 8+, and a GitHub Personal Access Token.

See the Setup Guide for detailed configuration including environment variables, GitHub Pages deployment, and favicon assets.

Available Scripts

Script	Description
`npm run dev`	Start development server
`npm run build`	Build for production
`npm run lint`	Run ESLint
`npm run test`	Run test suite
`npm run scan:full`	Run complete scanning pipeline
`npm run scan:marketplaces`	Scan GitHub for marketplaces
`npm run validate:plugins`	Validate discovered plugins
`npm run generate:data`	Generate website data files

Architecture

GitHub API  →  Scan  →  Validate  →  Generate  →  Build  →  Deploy
   ↓            ↓          ↓           ↓           ↓          ↓
Repositories  data/     data/      public/     .next/    GitHub
              marketplaces/ plugins/   data/      out/      Pages

For details, see Architecture and Workflow Architecture.

Documentation

	Guide	Description
📖	Setup Guide	Installation, configuration, deployment
👤	User Guide	Using the marketplace browser
🔌	Developer API	Data endpoints and response formats
🏗️	Architecture	System design and data models
⚙️	Workflow Architecture	CI/CD pipeline and automation
🔒	Security	Security measures and threat model
🔧	Maintenance Guide	Operations and troubleshooting
🤝	Contributing	Development workflow and guidelines
📋	Changelog	Version history and release notes

Contributing

We welcome contributions! See the Contributing Guide for details.

Fork the repository
Create a feature branch
Make your changes and add tests
Submit a pull request

License

MIT — see LICENSE.

Acknowledgments

Anthropic for creating Claude
GitHub for hosting, Actions, and Pages
Next.js and Tailwind CSS for the frontend

Made with ❤️ for the Claude Community

⭐ Star this repository · 🐛 Report issues · 💬 Suggest features