Kernel TypeScript SDK：浏览器自动化与Playwright远程执行开发工具

kernel-typescript-sdk by kernel/skills

192 周安装量

3 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/kernel/skills --skill kernel-typescript-sdk

自动化 TypeScript 测试

🇨🇳中文介绍

何时使用此技能

当您需要时，请使用 Kernel TypeScript SDK：

构建浏览器自动化脚本 - 创建控制远程浏览器的 TypeScript 程序
执行服务器端自动化 - 直接在浏览器虚拟机中运行 Playwright 代码，无需本地依赖
以编程方式管理浏览器会话 - 通过代码创建、配置和控制浏览器
构建可扩展的抓取/测试工具 - 使用浏览器池和配置文件进行大规模自动化
将自动化部署为动作 - 将脚本打包为 Kernel 动作，以便通过 API 调用

何时不应使用：

对于 CLI 命令（例如 kernel browsers create），请改用 kernel-cli 技能
对于快速的一次性任务，CLI 可能比编写代码更简单

核心概念

SDK 架构

SDK 按基于资源的模块组织：

kernel.browsers - 浏览器会话管理（创建、列出、删除）
kernel.browsers.playwright - 服务器端 Playwright 执行
kernel.browsers.computer - 操作系统级控制（鼠标、键盘、截图）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

两种自动化方法

1. 服务器端执行（推荐）

使用 kernel.browsers.playwright.execute() 直接在浏览器虚拟机中执行 Playwright 代码
通过 response.result 访问响应 - 必须在代码中使用 return 来获取数据
最适合：大多数用例、生产自动化、并行执行、动作

2. CDP 连接（客户端）

通过 CDP WebSocket URL (browser.cdp_ws_url) 将 Playwright/Puppeteer 连接到浏览器
代码在本地运行，浏览器在远程运行；需要本地安装 Playwright
最适合：复杂调试、特定的本地开发需求

import { Kernel } from "@onkernel/sdk";
const kernel = new Kernel();  // 从环境变量读取 KERNEL_API_KEY

属性访问：使用 snake_case（例如 browser.session_id, browser.cdp_ws_url）

二进制数据处理

二进制数据无法通过 playwright.execute 序列化（返回 undefined）。请使用专用 API：

// 对于截图：
const response = await kernel.browsers.computer.captureScreenshot(browser.session_id);
// 对于文件：
const response = await kernel.browsers.filesystem.readFile(browser.session_id, { path: '/path/to/file' });

// 转换为 buffer：
const blob = await response.blob();
const buffer = Buffer.from(await blob.arrayBuffer());

注意： 这与 Python SDK 不同，在 Python SDK 中，二进制数据可以通过 playwright.execute 作为 Buffer 对象返回。在 TypeScript 中，请始终使用专用 API。

Kernel 文档：https://www.kernel.sh/docs
快速入门指南：https://www.kernel.sh/docs/quickstart
模板：https://www.kernel.sh/docs/reference/cli/create#available-templates
TypeScript 类型：在 @onkernel/sdk 包中可用
示例：examples

🇺🇸English

When to Use This Skill

Use the Kernel TypeScript SDK when you need to:

Build browser automation scripts - Create TypeScript programs that control remote browsers
Execute server-side automation - Run Playwright code directly in the browser VM without local dependencies
Manage browser sessions programmatically - Create, configure, and control browsers from code
Build scalable scraping/testing tools - Use browser pools and profiles for high-volume automation
Deploy automation as actions - Package scripts as Kernel actions for invocation via API

When NOT to use:

For CLI commands (e.g., kernel browsers create), use the kernel-cli skill instead
For quick one-off tasks, the CLI may be simpler than writing code

Core Concepts

SDK Architecture

The SDK is organized into resource-based modules:

kernel.browsers - Browser session management (create, list, delete)
kernel.browsers.playwright - Server-side Playwright execution
kernel.browsers.computer - OS-level controls (mouse, keyboard, screenshots)
kernel.browserPools - Pre-warmed browser pool management
kernel.profiles - Persistent browser profiles (auth state)
kernel.auth.connections - Managed auth (create, login, submit, follow, retrieve, delete)
kernel.credentialProviders - External credential providers (1Password)
kernel.proxies - Proxy configuration
kernel.extensions - Chrome extension management
kernel.deployments - App deployment
kernel.invocations - Action invocation

Two Automation Approaches

1. Server-side Execution (RECOMMENDED)

Execute Playwright code directly in browser VM using kernel.browsers.playwright.execute()
Response accessed via response.result - MUST usereturn in code to get data back
Best for: Most use cases, production automation, parallel execution, actions

2. CDP Connection (Client-side)

Connect Playwright/Puppeteer to browser via CDP WebSocket URL (browser.cdp_ws_url)
Code runs locally, browser runs remotely; requires local Playwright installation
Best for: Complex debugging, specific local development needs

Patterns Reference

SDK Initialization

import { Kernel } from "@onkernel/sdk";
const kernel = new Kernel();  // Reads KERNEL_API_KEY from environment

Attribute Access : Use snake_case (e.g., browser.session_id, browser.cdp_ws_url)

Binary Data Handling

Binary data does not serialize through playwright.execute (returns undefined). Use dedicated APIs:

// For screenshots:
const response = await kernel.browsers.computer.captureScreenshot(browser.session_id);
// For files:
const response = await kernel.browsers.filesystem.readFile(browser.session_id, { path: '/path/to/file' });

// Convert to buffer:
const blob = await response.blob();
const buffer = Buffer.from(await blob.arrayBuffer());

Note: This differs from the Python SDK where binary data CAN be returned via playwright.execute as a Buffer object. In TypeScript, always use dedicated APIs.

References

Kernel Documentation : https://www.kernel.sh/docs
Quickstart Guide : https://www.kernel.sh/docs/quickstart
Templates : https://www.kernel.sh/docs/reference/cli/create#available-templates
TypeScript Types : Available in @onkernel/sdk package
Examples : examples

Weekly Installs

143

Repository

kernel/skills

GitHub Stars

First Seen

Jan 30, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn

Installed on

cursor138

claude-code137

codex137

opencode23

gemini-cli23

github-copilot20

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

40,000 周安装