Claude Marketplace Browser

npx claude-marketplace-browser /path/to/your-marketplace

Generates a fully static site from your marketplace.json — searchable plugin gallery, per-plugin detail pages with rendered docs, one-click install commands. Deploy anywhere: GitHub Pages, GitLab Pages, S3.

Features

• Searchable and filterable plugin gallery (by name, description, category) — client-side, no server required
• Plugin detail pages with rendered README and per-component documentation
• Support for all Claude plugin component types: skills, commands, agents, hooks, MCP servers, LSP servers
• One-click install: each plugin detail page shows the exact claude plugin install command, copied to clipboard on click
• Add marketplace banner: the list page shows the claude plugin marketplace add command to register this marketplace in Claude Code
• Color-coded badges per component type

Table of Contents

• Features

• Static Site (GitHub Pages / GitLab Pages)

• Local Dev Server

• Marketplace Format

• Stack

• Contributing

• License

Static Site (GitHub Pages / GitLab Pages)

npx claude-marketplace-browser /path/to/your-marketplace

This generates a dist/ directory in the current working directory:

dist/
  index.html
  styles.css
  search.js
  agents/
    {plugin-name}/
      index.html

With marketplace URL (for install commands)

npx claude-marketplace-browser /path/to/marketplace https://github.com/myorg/my-plugins

Or with named flags:

npx claude-marketplace-browser --marketplace-path /path/to/marketplace --marketplace-url https://github.com/myorg/my-plugins

Deploy to GitHub Pages

Add this workflow to .github/workflows/pages.yml:

name: Deploy to GitHub Pages

on:
  push:
    branches: [main]

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: true  # if your marketplace is a submodule
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx claude-marketplace-browser ./your-marketplace-dir
      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - uses: actions/deploy-pages@v4
        id: deployment

Deploy to GitLab Pages

Add this to .gitlab-ci.yml:

pages:
  image: node:20
  script:
    - npx claude-marketplace-browser ./your-marketplace-dir
    - mv dist public
  artifacts:
    paths:
      - public
  only:
    - main

Local Dev Server

An alternative to npx for browsing your marketplace locally without generating static files.

npm install
MARKETPLACE_PATH=/path/to/marketplace npm run dev

Open http://localhost:3000 in your browser. The --watch flag reloads automatically on file changes.

# CLI flags
node scripts/dev-server.js --marketplace-path /path/to/marketplace

# Environment variables
MARKETPLACE_PATH=/path/to/marketplace npm start

The target directory must contain a .claude-plugin/marketplace.json file.

Marketplace URL

node scripts/dev-server.js --marketplace-path /path/to/marketplace --marketplace-url https://github.com/myorg/my-plugins
MARKETPLACE_URL=https://github.com/myorg/my-plugins npm start

Without this option, the banner shows a <path-or-url> placeholder.

Marketplace Format

See the official plugin marketplace documentation.

Stack

• Runtime: Node.js (no framework, built-in http module)
• Frontend: Vanilla ES2020 — client-side search/filter via data-* attributes
• Templating: Server-side HTML string rendering
• Styles: Tailwind CSS compiled at build time (no CDN, no runtime overhead)
• Markdown: marked for plugin README and component docs

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.