Changelog
All notable changes to the Puppeteer MCP Actor will be documented in this file.
The format is based on Keep a Changelog ,
and this project adheres to Semantic Versioning .
1.2.3 (2025-11-24)
Bug Fixes
listen to apify-specified port on standby mode (12eb63c )
1.2.2 (2025-11-24)
Bug Fixes
CI: do not change actor definition (3cfae77 )
1.2.1 (2025-11-24)
Bug Fixes
1.2.0 (2025-11-24)
Features
docs: Simplify README for end-user focus (#30 ) (8fe9f7c )
security: implement least privilege with limited permissions (#31 ) (25d17af )
Bug Fixes
1.1.0 (2025-11-24)
⚠ BREAKING CHANGES
Documented major architectural shift from single-page reuse to browser pooling implementation.
Features
dev: optimize browser with pooling (187fc53 )
Bug Fixes
CI: pass the docker build (b6fb298 )
dev: add my custom tooling (9326358 )
dev: do not track ignore dir (2675fe5 )
Documentation
update CLAUDE.md with browser pooling architecture (#27 ) (2c388ce )
0.1.1 (2025-11-14)
Bug Fixes
CI: release to apify with MAJOR.MINOR (#13 ) (6044128 )
0.1.0 (2025-11-14)
Features
add comprehensive CI/CD workflow (#5 ) (f1bacc7 )
Initial implementation of Puppeteer MCP Actor for Apify Store (#1 ) (219508f )
optimize Dockerfile with comprehensive caching strategies (#11 ) (db5a25c )
push edge docker to ghcr.io (#10 ) (d3af725 )
Bug Fixes
correct jsonschema tag format for required fields (#4 ) (8ada1d2 )
correct MCP tool parameter struct tags format (#12 ) (a08dfd9 )
syntax error (#3 ) (42fb2a4 )
Miscellaneous Chores
deps: update dependency go to v1.25.4 (#7 ) (07eda00 )
[Unreleased]
Fixed
Fixed memory leak where MustPage() created new browser pages on every navigation
Fixed health check in Dockerfile by ensuring wget is available in runtime image
Fixed variable shadowing in screenshot function that prevented proper error handling
Changed
BrowserManager now maintains a single page instance that is reused across all tool calls
All browser automation tools now use the managed page instance instead of creating new pages
Improved page lifecycle management with proper cleanup on shutdown
1.0.0 - 2025-11-13
Added
Initial release of Puppeteer MCP Actor
Model Context Protocol (MCP) server implementation using official Go SDK
Rod browser automation integration for high-performance web control
7 comprehensive browser automation tools:
navigate - URL navigation with wait conditions
click - Element interaction via CSS selectors
type - Text input with configurable delays
screenshot - Page and element screenshot capture
evaluate - JavaScript execution in page context
waitForSelector - Smart element waiting
extract - Data extraction from page elements
Streamable HTTP/SSE transport for AI assistant connections
Configurable input schema for Actor customization
Docker containerization with Chrome/Chromium
Comprehensive error handling and logging
Headless and headed browser mode support
Graceful shutdown handling
Health check endpoint
Production-ready Dockerfile with multi-stage build
Detailed README with examples and use cases
Apify platform integration
Technical Details
Built with Go 1.23
MCP Go SDK v0.8.0
Rod v0.116.2
Debian Bookworm base image
Non-root container execution for security
Optimized for Apify platform deployment
Documentation
Comprehensive README with 2000+ words
SEO-optimized content for Apify Store
Integration examples for Claude, Python, and cURL
Architecture documentation
Troubleshooting guide
Security best practices