diff --git a/sources/platform/agents/skills.md b/sources/platform/agents/skills.md index 956245fb93..5185fe888f 100644 --- a/sources/platform/agents/skills.md +++ b/sources/platform/agents/skills.md @@ -44,7 +44,7 @@ Agents that discover skills on their own can read the index at [`apify.com/.well | `apify-actorization` | Converts an existing JavaScript, TypeScript, Python, or CLI project into an Apify Actor. | Plugins and skills CLI | | `apify-generate-output-schema` | Generates dataset and key-value store schemas for an existing Actor. | Plugins | | `apify-sdk-integration` | Integrates Actor execution into an application using the `apify-client` package. | Plugins | -| `apify-integration-development` | Designs and builds an official Apify integration for another product, such as a workflow-automation app, an agent plugin, or an AI framework package. | Skills CLI | +| `apify-integration-development` | Designs and builds an official Apify integration for another product, such as a workflow-automation app, an agent plugin, or an AI framework package. See [Build with the integration skill](/integrations/integrate#build-with-the-integration-skill). | Skills CLI | Plugins ship `apify-generate-output-schema` and `apify-sdk-integration`. In the skills CLI, `apify-actor-development` now generates output schemas itself, and `apify-integration-development` takes the place of the SDK integration skill. @@ -69,4 +69,5 @@ The Actor development, actorization, and integration skills write to your projec - [Apify plugin](/agents/plugins) - The skills, the MCP server, and the routing agent in one install - [Apify MCP server](/mcp) - The live connection that pairs with skills - [Build Actors with AI](/actors/development/quick-start/build-with-ai) - The Actor lifecycle driven from a coding agent +- [Build with the integration skill](/integrations/integrate#build-with-the-integration-skill) - Build an official Apify integration from a coding agent - [Apify skills registry](https://skills.sh/apify/agent-skills) - The source of every published skill diff --git a/sources/platform/integrations/index.mdx b/sources/platform/integrations/index.mdx index ae2e5040c6..2f84b3674b 100644 --- a/sources/platform/integrations/index.mdx +++ b/sources/platform/integrations/index.mdx @@ -205,6 +205,6 @@ Trigger Apify Actors from workflow automation platforms (n8n, Make, and Zapier), ## Create a new integration -If you're building a service or platform and want your users to be able to connect it with Apify, [create a new integration](/integrations/integrate). The page walks through both routes - building an integration-ready Actor that other Apify users can plug into their workflows, or connecting your service to Apify externally via the API. +If you're building a service or platform and want your users to be able to connect it with Apify, [create a new integration](/integrations/integrate). The page walks through both routes - building an integration-ready Actor that other Apify users can plug into their workflows, or connecting your service to Apify externally via the API. If your team uses an AI coding agent, that page also covers the `apify-integration-development` skill, which guides the agent through the build. If your tool isn't listed above, you can also browse [Apify Store](https://apify.com/store) for community-built integration Actors like [MongoDB Import](https://apify.com/drobnikj/mongodb-import) or [MySQL Insert](https://apify.com/petr_cermak/mysql-insert). diff --git a/sources/platform/integrations/integrate-with-apify.md b/sources/platform/integrations/integrate-with-apify.md index 06631862a9..f398031153 100644 --- a/sources/platform/integrations/integrate-with-apify.md +++ b/sources/platform/integrations/integrate-with-apify.md @@ -8,6 +8,10 @@ slug: /integrations/integrate If you are building a service and your users could benefit from integrating with Apify or vice versa, we would love to hear from you! Contact us at [integrations@apify.com](mailto:integrations@apify.com) to discuss potential collaboration. We are always looking for ways to make the Apify platform more useful and powerful for users. +:::tip Build with an AI coding agent +If your team uses an AI coding agent, the `apify-integration-development` skill can guide it through building your integration. See [Build with the integration skill](#build-with-the-integration-skill). +::: + ## Why integrate with Apify Apify is the leading platform for web scraping, AI agents, and automation tools. By integrating Apify into your platform, you enable users to incorporate real-time, structured data from the web with zero scraping infrastructure on your side. @@ -170,6 +174,17 @@ To help Apify monitor and support your integration, every API request should ide These identifiers enable better analytics and support for your integration. +### Build with the integration skill + +The `apify-integration-development` skill (see [Apify Agent Skills](/agents/skills)) guides your AI coding agent through designing and building an official Apify integration. To install it, follow the [installation instructions on GitHub](https://github.com/apify/agent-skills/tree/main#installation). It covers four integration shapes - read the reference file that matches your product: + +- Workflow automation platforms - Zapier, n8n, Make, Pipedream, Activepieces. +- AI agent plugins - coding-agent bundles for Cursor, Claude Code, Codex, and GitHub Copilot, or harness plugins for OpenClaw and Hermes. +- AI framework packages - LangChain, LlamaIndex, Haystack, Vercel AI SDK. +- Application integrations - a backend service or product feature calling Actors via `apify-client` or REST. + +The skill enforces the cross-cutting rules every Apify integration needs: [asynchronous run flow](/api/v2/actors-runs-post) with bounded polling, [cost controls](/get-started/agent-onboarding#run-your-first-actor) (`maxTotalChargeUsd`, `maxItems`), [attribution headers](#monitor-and-track), [OAuth2 and API-token authentication](#authentication-methods), and [webhooks](/integrations/webhooks) over polling. Once you publish your integration, contact [integrations@apify.com](mailto:integrations@apify.com) so the Apify team can review and validate it before it reaches users. + ## Technical resources ### Apify API