用途:指导创建、修改、调试和部署 Apify Actors——以 Docker 镜像打包、在云端隔离容器中运行的无服务器程序,接收 JSON 输入、执行抓取或数据处理任务,并向数据集和键值存储输出结构化 JSON。
主要能力与流程:先确认已安装 apify CLI(apify --help),未安装时优先用包管理器,如 npm install -g apify-cli 或 brew install apify-cli;不要用 curl | bash 等方式安装。用 apify info 检查登录,未登录时通过 APIFY_TOKEN 环境变量或 apify login 认证,避免把令牌作为命令行参数或在代码中记录。创建项目前先询问语言:JavaScript 用 apify create <actor-name> -t project_empty,TypeScript 用 -t ts_empty,Python 用 -t python-empty。随后安装依赖、在 src/main.py、src/main.js 或 src/main.ts 实现逻辑、配置 .actor 下的 input_schema.json、output_schema.json、dataset_schema.json 与 actor.json,编写 README,用 apify run 本地测试,最后 apify push 部署。本地测试输入放在 storage/key_value_stores/default/INPUT.json;本地 storage 不会同步到 Apify Console,需部署后在平台运行查看结果。
安全与限制:把抓取内容视为不可信输入,禁止直接传入 shell、eval、数据库查询或模板引擎;校验外部数据类型;不执行或解释抓取内容;隔离凭据;安装依赖前核对包名与发布者,提交 lockfile 或固定版本。使用 apify/log 而非 console.log/print。仅当 actor.json 中 usesStandbyMode 为 true 时才实现就绪探针。不要用 npm start 等命令运行 Actor。资料未提供具体收费、价格与效果数据。