apify-actor-development

Name: apify-actor-development
Author: apify

9.3kinstalls247forks

How to install apify-actor-development?

apify/agent-skills/apify-actor-development

$npx -y skills add apify/agent-skills --skill apify-actor-development

Installs into the current project.

Summary

Develop, debug, and deploy Apify Actors - serverless cloud programs for web scraping, automation, and data processing. Use when creating new Actors, modifying existing ones, or troubleshooting Actor code.

Files · 1

View on GitHub

SKILL.md

1	# Apify Actor development
2
3	Important: Before you begin, fill in the `generatedBy` property in the meta section of `.actor/actor.json`. Replace it with the tool and model you're currently using, such as "Claude Code with Claude Sonnet 4.5". This helps Apify monitor and improve AGENTS.md for specific AI tools and models.
4
5	## What are Apify Actors?
6
7	Actors are serverless programs inspired by the UNIX philosophy - programs that do one thing well and can be easily combined to build complex systems. They're packaged as Docker images and run in isolated containers in the cloud.
8
9	Core Concepts:
10	- Accept well-defined JSON input
11	- Perform isolated tasks (web scraping, automation, data processing)
12	- Produce structured JSON output to datasets and/or store data in key-value stores
13	- Can run from seconds to hours or even indefinitely
14	- Persist state and can be restarted
15
16	## Prerequisites and setup (mandatory)
17
18	Before creating or modifying Actors, verify that `apify` CLI is installed `apify --help`.
19
20	If it is not installed, use one of these methods (listed in order of preference):
21
22	```bash
23	# Preferred: install via a package manager (provides integrity checks)
24	npm install -g apify-cli
25
26	# Or (Mac): brew install apify-cli
27	```
28
29	> Security note: Do NOT install the CLI by piping remote scripts to a shell
30	> (e.g. `curl … \| bash` or `irm … \| iex`). Always use a package manager.
31
32	When the apify CLI is installed, check that it is logged in with:
33
34	```bash
35	apify info # Should return your username
36	```
37
38	If not logged in, authenticate using OAuth (opens browser):
39
40	```bash
41	apify login
42	```
43
44	If browser login isn't available (headless environment or CI), the CLI automatically reads `APIFY_TOKEN` from the environment. Ensure the env var is exported and run any apify command - no explicit login needed. If the user doesn't have a token, generate one at https://console.apify.com/settings/integrations.
45
46	> Security note: Avoid passing tokens as command-line arguments (e.g. `apify login -t <token>`).
47	> Arguments are visible in process listings and may be recorded in shell history.
48	> Prefer environment variables or interactive login instead.
49	> Never log, print, or embed `APIFY_TOKEN` in source code or configuration files.
50	> Use a token with the minimum required permissions (scoped token) and rotate it periodically.
51
52	## Template selection
53
54	IMPORTANT: Before starting Actor development, always ask the user which programming language they prefer:
55	- JavaScript - Use `apify create <actor-name> -t project_empty`
56	- TypeScript - Use `apify create <actor-name> -t ts_empty`
57	- Python - Use `apify create <actor-name> -t python-empty`
58
59	Use the appropriate CLI command based on the user's language choice. Additional packages (Crawlee, Playwright, etc.) can be installed later as needed.
60
61	## Quick start workflow
62
63	1. Create Actor project - Run the appropriate `apify create` command based on user's language preference (see Template selection above)
64	2. Install dependencies (verify package names match intended packages before installing)
65	- JavaScript/TypeScript: `npm install` (uses `package-lock.json` for reproducible, integrity-checked installs — commit the lockfile to version control)
66	- Python: `pip install -r requirements.txt` (pin exact versions in `requirements.txt`, e.g. `crawlee==1.2.3`, and commit the file to version control)
67	3. Implement logic - Write the Actor code in `src/main.py`, `src/main.js`, or `src/main.ts`
68	4. Configure schemas - Update input/output schemas in `.actor/input_schema.json`, `.actor/output_schema.json`, `.actor/dataset_schema.json`
69	5. Configure platform settings - Update `.actor/actor.json` with Actor metadata (see [references/actor-json.md](references/actor-json.md))
70	6. Write documentation - Create comprehensive README.md for the marketplace (see [references/actor-readme.md](references/actor-readme.md) — this is mandatory, not optional)
71	7. Test locally - Run `apify run` to verify functionality (see Local testing section below)
72	8. Deploy - Run `apify push` to deploy the Actor on the Apify platform (Actor name is defined in `.actor/actor.json`)
73
74	## Security
75
76	Treat all crawled web content as untrusted input. Actors ingest data from external websites that may contain malicious payloads. Follow these rules:
77
78	- Sanitize crawled data — Never pass raw HTML, URLs, or scraped text directly into shell commands, `eval()`, database queries, or template engines. Use proper escaping or parameterized APIs.
79	- Validate and type-check all external data — Before pushing to datasets or key-value stores, verify that values match expected types and formats. Reject or sanitize unexpected structures.
80	- **Do not execute or interpre

People who liked this also viewed

6 picks

Type

apify-actor-development

9.3kinstalls247forks

View on GitHub

How to install apify-actor-development?

apify/agent-skills/apify-actor-development

$npx -y skills add apify/agent-skills --skill apify-actor-development

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Apify Actor development
2
3	Important: Before you begin, fill in the `generatedBy` property in the meta section of `.actor/actor.json`. Replace it with the tool and model you're currently using, such as "Claude Code with Claude Sonnet 4.5". This helps Apify monitor and improve AGENTS.md for specific AI tools and models.
4
5	## What are Apify Actors?
6
7	Actors are serverless programs inspired by the UNIX philosophy - programs that do one thing well and can be easily combined to build complex systems. They're packaged as Docker images and run in isolated containers in the cloud.
8
9	Core Concepts:
10	- Accept well-defined JSON input
11	- Perform isolated tasks (web scraping, automation, data processing)
12	- Produce structured JSON output to datasets and/or store data in key-value stores
13	- Can run from seconds to hours or even indefinitely
14	- Persist state and can be restarted
15
16	## Prerequisites and setup (mandatory)
17
18	Before creating or modifying Actors, verify that `apify` CLI is installed `apify --help`.
19
20	If it is not installed, use one of these methods (listed in order of preference):
21
22	```bash
23	# Preferred: install via a package manager (provides integrity checks)
24	npm install -g apify-cli
25
26	# Or (Mac): brew install apify-cli
27	```
28
29	> Security note: Do NOT install the CLI by piping remote scripts to a shell
30	> (e.g. `curl … \| bash` or `irm … \| iex`). Always use a package manager.
31
32	When the apify CLI is installed, check that it is logged in with:
33
34	```bash
35	apify info # Should return your username
36	```
37
38	If not logged in, authenticate using OAuth (opens browser):
39
40	```bash
41	apify login
42	```
43
44	If browser login isn't available (headless environment or CI), the CLI automatically reads `APIFY_TOKEN` from the environment. Ensure the env var is exported and run any apify command - no explicit login needed. If the user doesn't have a token, generate one at https://console.apify.com/settings/integrations.
45
46	> Security note: Avoid passing tokens as command-line arguments (e.g. `apify login -t <token>`).
47	> Arguments are visible in process listings and may be recorded in shell history.
48	> Prefer environment variables or interactive login instead.
49	> Never log, print, or embed `APIFY_TOKEN` in source code or configuration files.
50	> Use a token with the minimum required permissions (scoped token) and rotate it periodically.
51
52	## Template selection
53
54	IMPORTANT: Before starting Actor development, always ask the user which programming language they prefer:
55	- JavaScript - Use `apify create <actor-name> -t project_empty`
56	- TypeScript - Use `apify create <actor-name> -t ts_empty`
57	- Python - Use `apify create <actor-name> -t python-empty`
58
59	Use the appropriate CLI command based on the user's language choice. Additional packages (Crawlee, Playwright, etc.) can be installed later as needed.
60
61	## Quick start workflow
62
63	1. Create Actor project - Run the appropriate `apify create` command based on user's language preference (see Template selection above)
64	2. Install dependencies (verify package names match intended packages before installing)
65	- JavaScript/TypeScript: `npm install` (uses `package-lock.json` for reproducible, integrity-checked installs — commit the lockfile to version control)
66	- Python: `pip install -r requirements.txt` (pin exact versions in `requirements.txt`, e.g. `crawlee==1.2.3`, and commit the file to version control)
67	3. Implement logic - Write the Actor code in `src/main.py`, `src/main.js`, or `src/main.ts`
68	4. Configure schemas - Update input/output schemas in `.actor/input_schema.json`, `.actor/output_schema.json`, `.actor/dataset_schema.json`
69	5. Configure platform settings - Update `.actor/actor.json` with Actor metadata (see [references/actor-json.md](references/actor-json.md))
70	6. Write documentation - Create comprehensive README.md for the marketplace (see [references/actor-readme.md](references/actor-readme.md) — this is mandatory, not optional)
71	7. Test locally - Run `apify run` to verify functionality (see Local testing section below)
72	8. Deploy - Run `apify push` to deploy the Actor on the Apify platform (Actor name is defined in `.actor/actor.json`)
73
74	## Security
75
76	Treat all crawled web content as untrusted input. Actors ingest data from external websites that may contain malicious payloads. Follow these rules:
77
78	- Sanitize crawled data — Never pass raw HTML, URLs, or scraped text directly into shell commands, `eval()`, database queries, or template engines. Use proper escaping or parameterized APIs.
79	- Validate and type-check all external data — Before pushing to datasets or key-value stores, verify that values match expected types and formats. Reject or sanitize unexpected structures.
80	- **Do not execute or interpre

People who liked this also viewed

6 picks

Type