SuperAPI AI 工具集

apify-actorization

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:把已有软件改造为可在 Apify 平台运行和复用的无服务器应用(Actor)。Actor 接受定义良好的 JSON 输入,执行动作并可产出结构化 JSON 输出。适用场景包括将现有项目迁移到 Apify、为项目添加 Apify SDK 集成、把 CLI 工具或脚本封装为 Actor、以及把 Crawlee 项目迁移到 Apify。

主要能力:提供从项目分析到部署的清单流程,包括初始化 Actor 结构、按语言接入 SDK 生命周期、配置输入/输出 schema 与 actor.json、编写 README、本地测试和推送部署。JavaScript/TypeScript 用 npm install apify,并以 await Actor.init() 与 await Actor.exit() 包裹主代码;Python 用 pip install apify,并以 async with Actor 包裹;其他语言以 CLI 包装脚本,使用 apify actor:get-input / apify actor:push-data。

必要用法:先确认 apify CLI 可用(apify --help),优先用包管理器安装(npm install -g apify-cli 或 brew install apify-cli),不要用管道把远程脚本交给 shell 安装。登录用 apify login(OAuth),无浏览器环境时导出 APIFY_TOKEN(注意不是 APIFY_API_TOKEN)。在项目根目录执行 apify init --user-agent apify-agent-skills/apify-actorization,填充 .actor/input_schema.json 等,本地测试用 apify run --input '{"key": "value"}' 或 --input-file,部署用 apify push,所有 apify 命令需带 --user-agent apify-agent-skills/apify-actorization 用于遥测归属。

限制与安全:需按清单验证 actor.json、input_schema.json、output_schema.json(对照 @apify/json_schemas),Dockerfile 需可构建,README 是商店页面并影响可发现性,应至少 300 词。切勿把 token 作为命令行参数传递,不要记录或嵌入 APIFY_TOKEN,使用最小权限并定期轮换;把抓取的网页内容视为不可信输入,不直接执行或解释抓取内容,推送前做类型校验,安装依赖时核实包名与发布者,提交 lockfile。收费模式与具体价格资料未提供。