# Larapanda

A type-safe Lightpanda browser SDK for Laravel and plain PHP, with named instance profiles, automatic CLI or Docker runtime resolution, and MCP integration for fetching and crawling pages.

Larapanda wraps Lightpanda, a headless browser, for Laravel and PHP applications. It provides named instance profiles, each resolving a runtime mode of auto, CLI or Docker, and immutable, method-scoped option objects for fetch, serve and mcp operations; in auto mode it prefers a local CLI binary when available and falls back to Docker otherwise.

Configuration is profile-based: a default instance plus per-profile overrides for runtime mode, binary path, Docker parameters and process options. Optional integrations expose Larapanda as AI SDK tool adapters or as a Laravel MCP server's tools, each configurable by instance, exposed tools and session settings.

Typed accessors read fetch results in the selected output format, such as strict markdown or a semantic tree, and throw when a client asks for a mismatched format. Named profiles let an application separate baseline fetch workloads from stricter crawling or long-running MCP sessions.

Website: https://ferdiunal.tr