# apify-integration-development

Guides the design of Apify integrations for workflow automation, AI agent harnesses, and SDK clients with proper polling and budget limits.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 450 installs · ★ 2461
- Author: apify
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/apify/agent-skills/tree/HEAD/skills/apify-integration-development/SKILL.md
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/skills/apify-integration-development

## What it does

This skill guides developers through creating official Apify integrations across workflow platforms like n8n or Zapier, AI framework packages, and custom agent harnesses. It aligns the agent on core Apify concepts: Actors, runs, datasets, and key-value stores, starting from the official model at `https://apify.com/agents.md`.

It enforces standard integration patterns: asynchronous execution via `POST /v2/actors/{actorId}/runs`, bounded polling with strict timeouts, and attribution headers like `x-apify-integration-platform`. If the Apify MCP server is available, the agent uses `search-actors` and `fetch-actor-details` to inspect live schemas without needing token credentials.

Passing cost limits such as `maxTotalChargeUsd` or `maxItems` inside the Actor input payload breaks execution: they must always be supplied as query parameters or execution options.

## Requirements
- Works with: n8n, Zapier

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add apify/agent-skills --skill apify-integration-development -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/apify-integration-development/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/apify-integration-development/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add apify/agent-skills --skill apify-integration-development -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/apify-integration-development/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add apify/agent-skills --skill apify-integration-development -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/apify-integration-development/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install apify/agent-skills apify-integration-development
```

2. **Manually: put the files in place**
- File: `.github/skills/apify-integration-development/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add apify/agent-skills --skill apify-integration-development -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/apify/agent-skills --path skills/apify-integration-development
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/apify-integration-development/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add apify/agent-skills --skill apify-integration-development -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/apify/agent-skills/tree/HEAD/skills/apify-integration-development/SKILL.md

## When to use it
- design an official Apify integration for automation tools or AI agents
- implement asynchronous Actor runs with bounded polling loops
- configure cost controls using `maxTotalChargeUsd` and `maxItems`
- attach required attribution headers to outgoing platform requests

## Example prompts
- Design an n8n integration that triggers an Apify Actor and reads its dataset
- Review my Apify client code for bounded polling and attribution headers
- Create a LangChain tool package that runs Actors with spending limits

## Similar
- [remotion-render](https://affpapa.org/en/nevibecode/skills/remotion-render.md) — skill · 3 installs
- [recipe-share-event-materials](https://affpapa.org/en/nevibecode/skills/recipe-share-event-materials.md) — skill · 29700 installs
- [blogwatcher](https://affpapa.org/en/nevibecode/skills/blogwatcher.md) — skill · 5400 installs
- [ego-browser](https://affpapa.org/en/nevibecode/skills/ego-browser.md) — skill · 12200 installs
- [composio](https://affpapa.org/en/nevibecode/skills/composio.md) — skill · 8100 installs
- [remote-browser](https://affpapa.org/en/nevibecode/skills/remote-browser.md) — skill · 4700 installs

From the same set: [apify/agent-skills](https://affpapa.org/en/nevibecode/by/apify/agent-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md