如何将现有软件转换为 Apify Serverless Actor #

解决本地脚本云端化难题：通过 Actorization 流程，将现有软件封装为兼容 Apify 平台的 Serverless 应用（Actor），使其支持标准 JSON 输入、结构化输出并可在云端按需运行。

为什么需要这个技能 #

许多开发者编写了强大的爬虫、自动化脚本或 CLI 工具，但这些工具通常只能在本地运行，缺乏便捷的触发机制、输入管理和结果存储方案。

Apify 的 Actor 模式将程序封装在 Docker 镜像中，通过标准的 SDK 处理生命周期。这意味着你可以将任何代码转化为一个“云端 API”，无需手动维护服务器，且能通过 JSON Schema 快速定义输入参数，极大降低了部署和分发自动化工具的成本。

适用场景 #

• 需要将本地 Python/JS 爬虫项目迁移到 Apify 云平台运行。
• 想将一个复杂的 CLI 工具包装成一个可配置的 Serverless 任务。
• 需要为现有的 Crawlee 项目集成 Apify 的存储（KV Store）和队列管理。
• 计划将开发的自动化工具发布到 Apify Store 进行商业化变现。

核心工作流 #

1. 项目分析：识别语言（JS/TS 或 Python）、程序入口、必要的输入参数（环境变量/命令行参数）以及最终的输出结果。
2. 初始化结构：在项目根目录执行 apify init，生成 .actor/ 配置文件夹及 Dockerfile。
3. SDK 适配：
   • JS/TS：安装 apify 库，使用 await Actor.init() 和 await Actor.exit() 包裹主逻辑。
   • Python：安装 apify 库，使用 async with Actor: 上下文管理器。
4. 定义 Schema：配置 .actor/input_schema.json 定义输入界面，配置 .actor/output_schema.json 定义结果格式。
5. 本地验证与部署：
   • 使用 apify run --input '{"key": "value"}' 进行本地模拟运行。
   • 执行 apify push 将镜像上传并部署至 Apify 云端。

# 快速启动指令参考
apify init
apify run --input '{"startUrl": "https://example.com"}'
apify push

下载和安装 #

下载 apify-actorization 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要 #

暂无推荐