用途:协助创建、修改、调试并部署 Apify Actors——以 Docker 镜像打包、在云端隔离容器中运行的服务器无程序,接收 JSON 输入、执行网页抓取/自动化/数据处理等隔离任务,并向数据集或键值存储输出结构化 JSON。
主要能力与流程:先确认 apify CLI 已安装(apify --help),未安装时优先用包管理器安装(npm install -g apify-cli 或 brew install apify-cli),禁止用 curl | bash 之类管道脚本安装;用 apify info 检查登录,未登录用 apify login(OAuth)或从环境变量读取 APIFY_TOKEN。开发前必须询问用户语言偏好,并用相应模板创建项目:JavaScript 用 apify create <actor-name> -t project_empty,TypeScript 用 -t ts_empty,Python 用 -t python-empty。随后安装依赖、在 src/main.py|js|ts 中实现逻辑、配置 .actor/input_schema.json、output_schema.json、dataset_schema.json 与 actor.json,并必须编写 README.md。本地测试用 apify run,部署用 apify push。
使用方式与限制:仅对 actor 运行命令附加 --user-agent apify-claude-code-plugin/apify-actor-development,不要加到 login、info、push 等命令。本地输入写入 storage/key_value_stores/default/INPUT.json;本地 storage/ 不会同步到 Apify Console,需 push 后在平台运行才能看到结果。避免用 npm start、npx apify run 等替代 apify run。安全上需把所有抓取内容视为不可信输入,不将原始 HTML、URL 或抓取文本传入 shell、eval、数据库或模板;校验外部数据;隔离 APIFY_TOKEN;安装依赖前核对包名与发布者,使用锁文件并固定版本;使用 apify/log 而非 console.log/print。附加配置与详细结构参见对应 references 文档,其余未在资料中说明的内容暂未提供。