crx3

🤖 AI-ready Chrome extension tooling via Model Context Protocol (MCP)
A modern, comprehensive toolset for CRX3 Chrome extension management — pack, unpack, download, analyze, and automate with AI.

👉 MCP Configuration Guide — Setup instructions for Cursor, Claude Desktop, Opencode, Crush & more.

---

✨ Features

Feature	Description
📦 Pack & Unpack	Create and extract signed CRX3 packages with key management
🗜️ Zip & Unzip	Handle extension archives with flexible output paths
⬇️ Download	Fetch extensions from Chrome Web Store by ID or URL
🔑 ID Generation	Generate extension IDs from public keys (SHA-256)
🔍 Analyze	Inspect manifest, permissions, and extension metadata
🤖 MCP Support	Native AI integration via Model Context Protocol

---

🤖 MCP Integration

This tool is AI-compatible through Model Context Protocol (MCP), enabling seamless interaction with:

• ✅ Cursor IDE — Chat with your extensions, auto-generate packs
• ✅ Claude Desktop — Natural language CRX3 operations
• ✅ Opencode — Automated extension workflows
• ✅ Crush — AI-assisted extension management
• ✅ Any MCP client — HTTP/SSE or stdio transport

Automate CRX3 operations through natural language commands powered by AI.

# Start MCP server (stdio mode for local AI clients)
crx3 mcp

# Or run over HTTP/SSE for remote clients 
crx3 mcp --listen=locahost:3000
crx3 mcp --listen=localhost:3000 --sse 

📖 See MCP.md for detailed setup instructions.

---

🛠️ Command Reference

Tool	Purpose
crx3 pack	Pack directory/zip into signed .crx extension
crx3 unpack	Extract .crx file contents to directory
crx3 download	Download .crx extension by ID or Chrome Web Store URL
crx3 search	Search Chrome Web Store by name/keywords (via DuckDuckGo)
crx3 zip	Create .zip archive from directory
crx3 unzip	Extract .zip archive contents
crx3 base64	Encode file to Base64 string
crx3 getid	Extract Chrome Extension ID from .crx or directory
crx3 scan	List/filter downloaded extensions in workspace
crx3 workspace	Get absolute path to workspace root
crx3 version	Show CRX3 tool version
crx3 mcp	Start MCP server for AI integration

💡 All commands support --help for detailed usage: crx3 pack --help

---

📦 Installation

Via Homebrew (macOS/Linux)

brew tap mmadfox/tap https://github.com/mmadfox/homebrew-tap
brew install mmadfox/tap/crx3

Via install.sh (Linux/macOS)

sudo curl -sSfL https://raw.githubusercontent.com/mmadfox/go-crx3/master/install.sh | bash -s

Via Go

go install github.com/mediabuyerbot/go-crx3/crx3@latest

Via Release Binary

Download pre-built binaries from Releases.

Verify Installation

crx3 version
# Output: crx3 version x.y.z

---

🚀 Quick Start Examples

Pack an extension

# Basic pack (auto-generates key if missing)
crx3 pack ./my-extension -o ./build/extension.crx3

# Pack with existing private key
crx3 pack ./my-extension -p ./keys/private.pem -o ./build/extension.crx3

Unpack and inspect

# Extract CRX3 to directory
crx3 unpack ./extension.crx3 -o ./extracted 


... [View full README on GitHub](https://github.com/mmadfox/go-crx3#readme)