From 547eb00bcfa3d06a2d19bf6322945261898feb17 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Mar 2026 12:08:45 +0000 Subject: [PATCH 1/7] Add Agent Skills and MCPC documentation page New integration page documenting Apify Agent Skills and MCPC (universal MCP CLI client) for AI coding assistants. Covers installation, setup with Claude Code/Cursor/VS Code, MCPC commands, and session management. Co-Authored-By: Claude Opus 4.6 --- .../platform/integrations/ai/agent-skills.md | 270 ++++++++++++++++++ sources/platform/integrations/index.mdx | 6 + 2 files changed, 276 insertions(+) create mode 100644 sources/platform/integrations/ai/agent-skills.md diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md new file mode 100644 index 0000000000..b422a42c74 --- /dev/null +++ b/sources/platform/integrations/ai/agent-skills.md @@ -0,0 +1,270 @@ +--- +title: Agent Skills and MCPC +sidebar_label: Agent Skills + MCPC +description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP. +sidebar_position: 1.5 +slug: /integrations/agent-skills +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +[Apify Agent Skills](https://github.com/apify/agent-skills) give AI coding assistants pre-built capabilities for web scraping, data extraction, and automation. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other AI tools that support [MCP](https://modelcontextprotocol.io/). + +[MCPC](https://github.com/apify/mcp-cli) is a universal command-line client for MCP that connects your terminal and AI agents to any MCP server - including Apify's. + +Together, they let you add Apify's scraping and automation tools to any AI coding assistant with a single command. + +## Prerequisites + +- An [Apify account](https://console.apify.com/sign-up) with an [API token](https://console.apify.com/account#/integrations) +- [Node.js](https://nodejs.org/) version 20.6 or later +- An AI coding assistant that supports MCP (Claude Code, Cursor, VS Code with Copilot, Codex, Gemini CLI) + +## Install Agent Skills + +Agent Skills are pre-built skill files that AI coding assistants automatically discover and use for context. Install them in your project directory: + +```bash +npx skills add apify/agent-skills +``` + +This adds skill definitions to your project. No additional configuration is needed - your AI assistant picks them up automatically. + +### Available skills + +The [apify/agent-skills](https://github.com/apify/agent-skills) repository contains official Apify skills. The community-maintained [apify/awesome-skills](https://github.com/apify/awesome-skills) repository contains additional skills contributed by the community. + +:::note Skills consolidation +The official Agent Skills repository is being consolidated to two core skills. Check the [repository](https://github.com/apify/agent-skills) for the latest available skills. +::: + +### How skills work + +Each skill is a Markdown file (`SKILL.md`) that describes a capability and its tools. When an AI coding assistant opens your project, it reads these files and gains the ability to: + +- Search and run Actors from [Apify Store](https://apify.com/store) +- Extract data from websites, social media, and e-commerce platforms +- Export results as JSON, CSV, or display them in chat + +Skills use [MCPC](#install-mcpc) under the hood to communicate with MCP servers and execute Apify Actor calls. + +## Install MCPC + +MCPC is the command-line bridge between AI agents and MCP servers. Install it globally: + +```bash +npm install -g @apify/mcpc +``` + +### Connect to the Apify MCP server + +Authenticate and create a session: + +```bash +# Log in with OAuth (opens browser) +mcpc login mcp.apify.com + +# Create a named session +mcpc connect mcp.apify.com @apify +``` + +You can also authenticate with a bearer token: + +```bash +mcpc connect https://mcp.apify.com @apify \ + --header "Authorization: Bearer YOUR_APIFY_TOKEN" +``` + +### Explore available tools + +```bash +# List all tools in your session +mcpc @apify tools-list + +# Get details about a specific tool +mcpc @apify tools-get search-actors + +# Call a tool +mcpc @apify tools-call search-actors keywords:="website crawler" +``` + +### Use the interactive shell + +The interactive shell lets you explore tools and test calls: + +```bash +mcpc @apify shell +``` + +### JSON mode for scripting + +Add `--json` to any command for machine-readable output. This is useful for piping results into scripts or other tools: + +```bash +mcpc @apify tools-list --json +mcpc @apify tools-call search-actors keywords:="web scraper" --json +``` + +## Configure AI coding assistants + +Set up Agent Skills and MCPC with your preferred AI coding assistant. + + + + +1. Install Agent Skills in your project: + + ```bash + npx skills add apify/agent-skills + ``` + +1. Add the Apify MCP server: + + ```bash + claude mcp add apify "https://mcp.apify.com" -t http + ``` + +1. Start using skills by asking your assistant to scrape data, extract information, or run Actors. + + + + +1. Install Agent Skills in your project: + + ```bash + npx skills add apify/agent-skills + ``` + +1. Create or open `.cursor/mcp.json` and add: + + ```json + { + "mcpServers": { + "apify": { + "url": "https://mcp.apify.com" + } + } + } + ``` + +1. Restart Cursor to load the new MCP configuration. + + + + +1. Install Agent Skills in your project: + + ```bash + npx skills add apify/agent-skills + ``` + +1. Install an MCP-compatible extension (GitHub Copilot, Cline, or Roo Code). +1. Open the extension's MCP configuration and add: + + ```json + { + "mcpServers": { + "apify": { + "url": "https://mcp.apify.com" + } + } + } + ``` + + + + +For Codex, Gemini CLI, and other tools: + +1. Install Agent Skills in your project: + + ```bash + npx skills add apify/agent-skills + ``` + +1. Reference skill files directly. Most AI tools automatically discover `AGENTS.md` or `SKILL.md` files in your project directory. + +1. If your tool supports MCP, configure it to connect to `https://mcp.apify.com`. + + + + +## MCPC features + +### Session management + +MCPC maintains persistent sessions that survive across commands: + +```bash +# List active sessions +mcpc + +# Create a session +mcpc connect mcp.apify.com @apify + +# Restart a session +mcpc restart @apify + +# Close a session +mcpc close @apify +``` + +### OAuth authentication + +MCPC stores credentials securely in your OS keychain: + +```bash +# Log in (opens browser for OAuth flow) +mcpc login mcp.apify.com + +# Create a named profile for multiple accounts +mcpc login mcp.apify.com --profile work + +# Use a specific profile +mcpc connect mcp.apify.com @session --profile work + +# Log out +mcpc logout mcp.apify.com +``` + +### MCP proxy + +Expose authenticated sessions as local proxy servers without revealing credentials. This is useful for sandboxing AI agents: + +```bash +# Start a proxy on port 8080 +mcpc connect mcp.apify.com @relay --proxy 8080 + +# Connect through the proxy +mcpc connect localhost:8080 @sandboxed +``` + +### Argument syntax + +Pass arguments to tool calls using `key:=value` syntax: + +| Input | Parsed type | +|-------|------------| +| `count:=10` | Number | +| `enabled:=true` | Boolean | +| `greeting:=hello` | String | + +You can also pass inline JSON or pipe from stdin: + +```bash +# Inline JSON +mcpc @apify tools-call search-actors '{"keywords":"web scraper"}' + +# Pipe from stdin +echo '{"keywords":"web scraper"}' | mcpc @apify tools-call search-actors +``` + +## Resources + +- [Agent Skills repository](https://github.com/apify/agent-skills) - Official Apify skills +- [Awesome Skills repository](https://github.com/apify/awesome-skills) - Community-contributed skills +- [MCPC repository](https://github.com/apify/mcp-cli) - MCPC source code and documentation +- [Introducing MCPC](https://blog.apify.com/introducing-mcpc-universal-mcp-cli-client/) - Blog post with detailed walkthrough +- [Apify MCP server](/integrations/mcp) - Full MCP server documentation +- [Build Actors with AI](/actors/development/quick-start/build-with-ai) - Guide to AI-assisted Actor development diff --git a/sources/platform/integrations/index.mdx b/sources/platform/integrations/index.mdx index 6e8d8246b9..95f00e7623 100644 --- a/sources/platform/integrations/index.mdx +++ b/sources/platform/integrations/index.mdx @@ -247,6 +247,12 @@ These integrations allow you to use Apify Actors as tools and data sources. imageUrlDarkTheme="/img/platform/integrations/mcp-logo-white.png" smallImage /> + Date: Mon, 16 Mar 2026 13:04:51 +0000 Subject: [PATCH 2/7] docs: Fix style guide issues in Agent Skills and MCPC page Address 7 style guide violations: expand meta description to meet 140-char minimum, expand MCP acronym on first use, remove sales language, fix passive voice, add Tabs groupId, improve tone and link text. Co-Authored-By: Claude Opus 4.6 (1M context) --- sources/platform/integrations/ai/agent-skills.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index b422a42c74..5ca35c8f4b 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -1,7 +1,7 @@ --- title: Agent Skills and MCPC sidebar_label: Agent Skills + MCPC -description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP. +description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP servers. sidebar_position: 1.5 slug: /integrations/agent-skills --- @@ -9,9 +9,9 @@ slug: /integrations/agent-skills import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -[Apify Agent Skills](https://github.com/apify/agent-skills) give AI coding assistants pre-built capabilities for web scraping, data extraction, and automation. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other AI tools that support [MCP](https://modelcontextprotocol.io/). +[Apify Agent Skills](https://github.com/apify/agent-skills) give AI coding assistants pre-built capabilities for web scraping, data extraction, and automation. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other AI tools that support [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). -[MCPC](https://github.com/apify/mcp-cli) is a universal command-line client for MCP that connects your terminal and AI agents to any MCP server - including Apify's. +[MCPC](https://github.com/apify/mcp-cli) is a command-line client for MCP that connects your terminal and AI agents to any MCP server - including Apify's. Together, they let you add Apify's scraping and automation tools to any AI coding assistant with a single command. @@ -36,7 +36,7 @@ This adds skill definitions to your project. No additional configuration is need The [apify/agent-skills](https://github.com/apify/agent-skills) repository contains official Apify skills. The community-maintained [apify/awesome-skills](https://github.com/apify/awesome-skills) repository contains additional skills contributed by the community. :::note Skills consolidation -The official Agent Skills repository is being consolidated to two core skills. Check the [repository](https://github.com/apify/agent-skills) for the latest available skills. +The Apify team is consolidating the official Agent Skills repository into two core skills. Check the [repository](https://github.com/apify/agent-skills) for the latest available skills. ::: ### How skills work @@ -110,7 +110,7 @@ mcpc @apify tools-call search-actors keywords:="web scraper" --json Set up Agent Skills and MCPC with your preferred AI coding assistant. - + 1. Install Agent Skills in your project: @@ -230,7 +230,7 @@ mcpc logout mcp.apify.com ### MCP proxy -Expose authenticated sessions as local proxy servers without revealing credentials. This is useful for sandboxing AI agents: +Expose authenticated sessions as local proxy servers to sandbox AI agents without revealing credentials: ```bash # Start a proxy on port 8080 @@ -265,6 +265,6 @@ echo '{"keywords":"web scraper"}' | mcpc @apify tools-call search-actors - [Agent Skills repository](https://github.com/apify/agent-skills) - Official Apify skills - [Awesome Skills repository](https://github.com/apify/awesome-skills) - Community-contributed skills - [MCPC repository](https://github.com/apify/mcp-cli) - MCPC source code and documentation -- [Introducing MCPC](https://blog.apify.com/introducing-mcpc-universal-mcp-cli-client/) - Blog post with detailed walkthrough +- [Read the MCPC introduction](https://blog.apify.com/introducing-mcpc-universal-mcp-cli-client/) - Blog post with detailed walkthrough - [Apify MCP server](/integrations/mcp) - Full MCP server documentation - [Build Actors with AI](/actors/development/quick-start/build-with-ai) - Guide to AI-assisted Actor development From 58e3c53aafaf0bdfb812ab11bee1ecddc50021af Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Tue, 17 Mar 2026 10:21:44 +0100 Subject: [PATCH 3/7] docs: Update descriptions in Agent Skills and MCPC documentation --- sources/platform/integrations/ai/agent-skills.md | 4 ++-- sources/platform/integrations/index.mdx | 8 +------- 2 files changed, 3 insertions(+), 9 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index 5ca35c8f4b..083c3d5060 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -1,7 +1,7 @@ --- title: Agent Skills and MCPC sidebar_label: Agent Skills + MCPC -description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP servers. +description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and browser automation capabilities through MCP servers. sidebar_position: 1.5 slug: /integrations/agent-skills --- @@ -45,7 +45,7 @@ Each skill is a Markdown file (`SKILL.md`) that describes a capability and its t - Search and run Actors from [Apify Store](https://apify.com/store) - Extract data from websites, social media, and e-commerce platforms -- Export results as JSON, CSV, or display them in chat +- Export results as JSON or CSV, or display them in chat Skills use [MCPC](#install-mcpc) under the hood to communicate with MCP servers and execute Apify Actor calls. diff --git a/sources/platform/integrations/index.mdx b/sources/platform/integrations/index.mdx index 95f00e7623..a70db40ffc 100644 --- a/sources/platform/integrations/index.mdx +++ b/sources/platform/integrations/index.mdx @@ -247,13 +247,7 @@ These integrations allow you to use Apify Actors as tools and data sources. imageUrlDarkTheme="/img/platform/integrations/mcp-logo-white.png" smallImage /> - - Date: Tue, 17 Mar 2026 10:32:07 +0100 Subject: [PATCH 4/7] docs: Update sidebar label and description in Agent Skills and MCPC documentation --- sources/platform/integrations/ai/agent-skills.md | 4 ++-- sources/platform/integrations/index.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index 083c3d5060..3babcf737d 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -1,7 +1,7 @@ --- title: Agent Skills and MCPC -sidebar_label: Agent Skills + MCPC -description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and browser automation capabilities through MCP servers. +sidebar_label: Agent Skills and MCPC +description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP servers. sidebar_position: 1.5 slug: /integrations/agent-skills --- diff --git a/sources/platform/integrations/index.mdx b/sources/platform/integrations/index.mdx index a70db40ffc..6e8d8246b9 100644 --- a/sources/platform/integrations/index.mdx +++ b/sources/platform/integrations/index.mdx @@ -247,7 +247,7 @@ These integrations allow you to use Apify Actors as tools and data sources. imageUrlDarkTheme="/img/platform/integrations/mcp-logo-white.png" smallImage /> - Date: Tue, 24 Mar 2026 10:58:35 +0100 Subject: [PATCH 5/7] docs: apply review feedback on Agent Skills and MCPC page Apply 10 suggestions from PR review: - Update description and intro text for accuracy - Add MCPC blog post link and token efficiency note - Remove skills consolidation admonition - Clarify slash-command invocation and dynamic loading - Replace export bullet with Actor development link - Fix terminology (AI agents, Apify MCP server) Co-Authored-By: Claude Opus 4.6 (1M context) --- .../platform/integrations/ai/agent-skills.md | 22 ++++++++----------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index 3babcf737d..f2b8777bd4 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -1,7 +1,7 @@ --- title: Agent Skills and MCPC sidebar_label: Agent Skills and MCPC -description: Use Apify Agent Skills and MCPC to give AI coding assistants web scraping, data extraction, and automation capabilities through MCP servers. +description: Use Apify Agent Skills with MCP CLI (mcpc) to give AI agents web scraping, data extraction, and automation capabilities. sidebar_position: 1.5 slug: /integrations/agent-skills --- @@ -9,17 +9,17 @@ slug: /integrations/agent-skills import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -[Apify Agent Skills](https://github.com/apify/agent-skills) give AI coding assistants pre-built capabilities for web scraping, data extraction, and automation. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other AI tools that support [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). +[Apify Agent Skills](https://github.com/apify/agent-skills) give AI agents pre-built capabilities for web scraping, data extraction, and building Apify Actors. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other coding agents that support [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). -[MCPC](https://github.com/apify/mcp-cli) is a command-line client for MCP that connects your terminal and AI agents to any MCP server - including Apify's. +[MCPC](https://github.com/apify/mcp-cli) is a universal command-line client for MCP that connects your AI agents to any MCP server - including Apify's. This CLI utility enables more token efficient tool calling, and less context bloat while working with MCP servers. -Together, they let you add Apify's scraping and automation tools to any AI coding assistant with a single command. +Together, they let you add Apify's scraping and automation tools to any AI agent with a single command. ## Prerequisites - An [Apify account](https://console.apify.com/sign-up) with an [API token](https://console.apify.com/account#/integrations) - [Node.js](https://nodejs.org/) version 20.6 or later -- An AI coding assistant that supports MCP (Claude Code, Cursor, VS Code with Copilot, Codex, Gemini CLI) +- An AI coding agent that supports MCP (Claude Code, Cursor, VS Code with Copilot, Codex, Gemini CLI etc.) ## Install Agent Skills @@ -35,23 +35,19 @@ This adds skill definitions to your project. No additional configuration is need The [apify/agent-skills](https://github.com/apify/agent-skills) repository contains official Apify skills. The community-maintained [apify/awesome-skills](https://github.com/apify/awesome-skills) repository contains additional skills contributed by the community. -:::note Skills consolidation -The Apify team is consolidating the official Agent Skills repository into two core skills. Check the [repository](https://github.com/apify/agent-skills) for the latest available skills. -::: - ### How skills work -Each skill is a Markdown file (`SKILL.md`) that describes a capability and its tools. When an AI coding assistant opens your project, it reads these files and gains the ability to: +Each skill is a Markdown file (`SKILL.md`) that describes a domain-specific capability and tools the agent should use to execute the desired task. Skills can be invoked directly by `/slash-commands` and agents can also load them dynamically based on your prompt. Apify Agent Skills give AI coding assistants the ability to: - Search and run Actors from [Apify Store](https://apify.com/store) - Extract data from websites, social media, and e-commerce platforms -- Export results as JSON or CSV, or display them in chat +- [Develop, test & publish Actors](https://docs.apify.com/platform/actors/development/quick-start/build-with-ai) in Apify Store -Skills use [MCPC](#install-mcpc) under the hood to communicate with MCP servers and execute Apify Actor calls. +Skills use [MCPC](#install-mcpc) under the hood to communicate with Apify MCP server and execute Actor calls. ## Install MCPC -MCPC is the command-line bridge between AI agents and MCP servers. Install it globally: +[MCP CLI (mcpc)](https://blog.apify.com/introducing-mcpc-universal-mcp-cli-client/) is the command-line bridge between AI agents and MCP servers. Install it globally: ```bash npm install -g @apify/mcpc From 82c5aa315a5fd165950c4caec9030c899f51d1f1 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Thu, 2 Apr 2026 14:36:21 +0200 Subject: [PATCH 6/7] apply review --- .../platform/integrations/ai/agent-skills.md | 92 +++++++------------ 1 file changed, 33 insertions(+), 59 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index f2b8777bd4..22c89af778 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -43,7 +43,21 @@ Each skill is a Markdown file (`SKILL.md`) that describes a domain-specific capa - Extract data from websites, social media, and e-commerce platforms - [Develop, test & publish Actors](https://docs.apify.com/platform/actors/development/quick-start/build-with-ai) in Apify Store -Skills use [MCPC](#install-mcpc) under the hood to communicate with Apify MCP server and execute Actor calls. +Skills include bundled scripts that communicate with the Apify API to execute Actor calls. They use your `APIFY_TOKEN` from the [`.env` file](#set-up-your-api-token). + +## Set up your API token + +Agent Skills need your Apify API token to run Actors. Create a `.env` file in your project root: + +```bash +APIFY_TOKEN=your_api_token +``` + +Get your token from the [Integrations](https://console.apify.com/account/integrations) section in Apify Console. + +:::caution Keep your token private +Don't commit the `.env` file to version control. Add it to your `.gitignore` file. +::: ## Install MCPC @@ -104,88 +118,48 @@ mcpc @apify tools-call search-actors keywords:="web scraper" --json ## Configure AI coding assistants -Set up Agent Skills and MCPC with your preferred AI coding assistant. +After [installing Agent Skills](#install-agent-skills) and setting up your [API token](#set-up-your-api-token), configure your AI coding assistant to use them. -1. Install Agent Skills in your project: - - ```bash - npx skills add apify/agent-skills - ``` +Add skills from the plugin marketplace: -1. Add the Apify MCP server: +```bash +# Add the marketplace +/plugin marketplace add https://github.com/apify/agent-skills - ```bash - claude mcp add apify "https://mcp.apify.com" -t http - ``` +# Install a skill +/plugin install apify-ultimate-scraper@apify-agent-skills +``` -1. Start using skills by asking your assistant to scrape data, extract information, or run Actors. +Start using skills by asking your assistant to scrape data, extract information, or run Actors. -1. Install Agent Skills in your project: - - ```bash - npx skills add apify/agent-skills - ``` - -1. Create or open `.cursor/mcp.json` and add: - - ```json - { - "mcpServers": { - "apify": { - "url": "https://mcp.apify.com" - } - } - } - ``` - -1. Restart Cursor to load the new MCP configuration. +Cursor automatically discovers skill files (`SKILL.md`) in your project directory after running `npx skills add apify/agent-skills`. No additional configuration is needed. -1. Install Agent Skills in your project: - - ```bash - npx skills add apify/agent-skills - ``` - -1. Install an MCP-compatible extension (GitHub Copilot, Cline, or Roo Code). -1. Open the extension's MCP configuration and add: - - ```json - { - "mcpServers": { - "apify": { - "url": "https://mcp.apify.com" - } - } - } - ``` +VS Code with an AI extension (GitHub Copilot, Cline, or Roo Code) automatically discovers skill files in your project directory after running `npx skills add apify/agent-skills`. No additional configuration is needed. For Codex, Gemini CLI, and other tools: -1. Install Agent Skills in your project: - - ```bash - npx skills add apify/agent-skills - ``` - -1. Reference skill files directly. Most AI tools automatically discover `AGENTS.md` or `SKILL.md` files in your project directory. - -1. If your tool supports MCP, configure it to connect to `https://mcp.apify.com`. +1. Run `npx skills add apify/agent-skills` to add skill files to your project. +1. Most AI tools automatically discover `AGENTS.md` or `SKILL.md` files in your project directory. +:::tip Connect the Apify MCP server for extra capabilities +For additional MCP-based tools like documentation search, you can optionally connect the [Apify MCP server](/integrations/mcp). This is not required for Agent Skills to work. +::: + ## MCPC features ### Session management @@ -241,7 +215,7 @@ mcpc connect localhost:8080 @sandboxed Pass arguments to tool calls using `key:=value` syntax: | Input | Parsed type | -|-------|------------| +| ----- | ---------- | | `count:=10` | Number | | `enabled:=true` | Boolean | | `greeting:=hello` | String | From f8a20ea252415d9f79ed85f7f52558bfa1b889a0 Mon Sep 17 00:00:00 2001 From: Marcel Rebro Date: Thu, 2 Apr 2026 22:17:35 +0200 Subject: [PATCH 7/7] docs: fix style guide violations in Agent Skills and MCPC page Fix description length, grammar (etc. comma, ampersand), informal language, internal link prefixes, redundancy, and heading style. Co-Authored-By: Claude Opus 4.6 (1M context) --- .../platform/integrations/ai/agent-skills.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/sources/platform/integrations/ai/agent-skills.md b/sources/platform/integrations/ai/agent-skills.md index 22c89af778..d74931eb25 100644 --- a/sources/platform/integrations/ai/agent-skills.md +++ b/sources/platform/integrations/ai/agent-skills.md @@ -1,7 +1,7 @@ --- title: Agent Skills and MCPC sidebar_label: Agent Skills and MCPC -description: Use Apify Agent Skills with MCP CLI (mcpc) to give AI agents web scraping, data extraction, and automation capabilities. +description: Use Apify Agent Skills with MCP CLI (mcpc) to give AI coding agents web scraping, data extraction, and automation capabilities through any MCP-compatible tool. sidebar_position: 1.5 slug: /integrations/agent-skills --- @@ -11,7 +11,7 @@ import TabItem from '@theme/TabItem'; [Apify Agent Skills](https://github.com/apify/agent-skills) give AI agents pre-built capabilities for web scraping, data extraction, and building Apify Actors. Skills work with Claude Code, Cursor, Codex, Gemini CLI, and other coding agents that support [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). -[MCPC](https://github.com/apify/mcp-cli) is a universal command-line client for MCP that connects your AI agents to any MCP server - including Apify's. This CLI utility enables more token efficient tool calling, and less context bloat while working with MCP servers. +[MCPC](https://github.com/apify/mcp-cli) is a universal command-line client for MCP that connects your AI agents to any MCP server - including Apify's. This CLI utility reduces token usage and context size when working with MCP servers. Together, they let you add Apify's scraping and automation tools to any AI agent with a single command. @@ -19,7 +19,7 @@ Together, they let you add Apify's scraping and automation tools to any AI agent - An [Apify account](https://console.apify.com/sign-up) with an [API token](https://console.apify.com/account#/integrations) - [Node.js](https://nodejs.org/) version 20.6 or later -- An AI coding agent that supports MCP (Claude Code, Cursor, VS Code with Copilot, Codex, Gemini CLI etc.) +- An AI coding agent that supports MCP (Claude Code, Cursor, VS Code with Copilot, Codex, Gemini CLI, etc.) ## Install Agent Skills @@ -33,15 +33,15 @@ This adds skill definitions to your project. No additional configuration is need ### Available skills -The [apify/agent-skills](https://github.com/apify/agent-skills) repository contains official Apify skills. The community-maintained [apify/awesome-skills](https://github.com/apify/awesome-skills) repository contains additional skills contributed by the community. +The [apify/agent-skills](https://github.com/apify/agent-skills) repository contains official Apify skills. The community-maintained [apify/awesome-skills](https://github.com/apify/awesome-skills) repository contains additional skills. -### How skills work +### Skill mechanics Each skill is a Markdown file (`SKILL.md`) that describes a domain-specific capability and tools the agent should use to execute the desired task. Skills can be invoked directly by `/slash-commands` and agents can also load them dynamically based on your prompt. Apify Agent Skills give AI coding assistants the ability to: - Search and run Actors from [Apify Store](https://apify.com/store) - Extract data from websites, social media, and e-commerce platforms -- [Develop, test & publish Actors](https://docs.apify.com/platform/actors/development/quick-start/build-with-ai) in Apify Store +- [Develop, test, and publish Actors](/platform/actors/development/quick-start/build-with-ai) in Apify Store Skills include bundled scripts that communicate with the Apify API to execute Actor calls. They use your `APIFY_TOKEN` from the [`.env` file](#set-up-your-api-token). @@ -133,7 +133,7 @@ Add skills from the plugin marketplace: /plugin install apify-ultimate-scraper@apify-agent-skills ``` -Start using skills by asking your assistant to scrape data, extract information, or run Actors. +Ask your assistant to scrape data, extract information, or run Actors. @@ -157,7 +157,7 @@ For Codex, Gemini CLI, and other tools: :::tip Connect the Apify MCP server for extra capabilities -For additional MCP-based tools like documentation search, you can optionally connect the [Apify MCP server](/integrations/mcp). This is not required for Agent Skills to work. +For additional MCP-based tools like documentation search, you can optionally connect the [Apify MCP server](/platform/integrations/mcp). This is not required for Agent Skills to work. ::: ## MCPC features @@ -236,5 +236,5 @@ echo '{"keywords":"web scraper"}' | mcpc @apify tools-call search-actors - [Awesome Skills repository](https://github.com/apify/awesome-skills) - Community-contributed skills - [MCPC repository](https://github.com/apify/mcp-cli) - MCPC source code and documentation - [Read the MCPC introduction](https://blog.apify.com/introducing-mcpc-universal-mcp-cli-client/) - Blog post with detailed walkthrough -- [Apify MCP server](/integrations/mcp) - Full MCP server documentation -- [Build Actors with AI](/actors/development/quick-start/build-with-ai) - Guide to AI-assisted Actor development +- [Apify MCP server](/platform/integrations/mcp) - Full MCP server documentation +- [Build Actors with AI](/platform/actors/development/quick-start/build-with-ai) - Guide to AI-assisted Actor development