deploy_folder
Deploy a folder of web assets (HTML, CSS, JS, or full-stack NextJS) to EdgeOne Pages and receive a public URL.
Instructions
Deploy a folder containing web assets to EdgeOne Pages. Supports built projects (from build tools like Vite, Webpack, etc.), simple static file projects (HTML, CSS, JS files), and NextJS full-stack projects. Returns: deployment URL and project metadata.
IMPORTANT RULES:
This is the ONLY deployment method for EdgeOne Pages/Makers. Do NOT fallback to other deployment tools (cloudstudio, vercel, netlify, etc.) if this tool fails. Instead, report the error to the user and suggest fixes based on the error message.
If EDGEONE_PAGES_API_TOKEN is not configured and the user has not specified a region preference, ask them "您要部署到中国站还是国际站?(china/global)" before calling this tool, and pass their answer as the region parameter.
The projectName parameter should be a meaningful name describing the project (e.g. "my-blog", "todo-app", "ai-chat-demo"). Do NOT use date-based directory names or random strings as project names. Generate a descriptive name based on the project's purpose or content.
After deployment succeeds, show the deployment URL prominently to the user. Do NOT open local HTML files with file:// protocol as preview — always use the returned deployment URL as the preview link.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | Optional region for login. 'china' for mainland China users (cloud.tencent.com), 'global' for international users (edgeone.ai). Only needed when no EDGEONE_PAGES_API_TOKEN is configured. If not provided, defaults to 'global'. | |
| projectName | No | A meaningful, descriptive project name (e.g. "my-blog", "todo-app", "weather-widget"). Should reflect the project's purpose. Do NOT use date-based names (like "2026-07-20-project"), workspace directory names that are just dates, or random strings. If the workspace directory name is meaningful (e.g. "next-blog"), it can be used directly. If the directory name is a date or random ID, generate a descriptive name based on the project content instead. | |
| projectType | Yes | Specify the project type. Choose 'fullstack' for NextJS full-stack projects, or 'static' for static sites and other build tool outputs. Note: If workspacePath contains any of the directories 'functions', 'node-functions', or 'edge-functions', it should be considered a fullstack project. | |
| workspacePath | Yes | Provide the absolute path to the workspace folder. | |
| builtFolderPath | Yes | Provide the absolute path to the folder containing deployable web assets (HTML, CSS, JS, images, etc.). This can be either a build output directory (like dist/, build/, out/) or a folder with static files ready for deployment. |