# Apify MCP for AI Agents AI Agent Connect

> Apify MCP lets you run web scraping actors and manage datasets directly from your AI client. It handles the heavy lifting of data extraction, allowing you to trigger scrapers, check run statuses, and pull structured results into your conversation without leaving your workspace.

## Overview
- **Category:** friends-mcp
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_XpiRRgIukBoSRPKSbj93XBldWyxkE1Ba9k2he2x5/ai-agent-connect
- **Tags:** data-extraction, serverless-actors, web-automation, data-scraping, api-integration, structured-data

## Description

This Connector connects your Apify account to your AI client, turning your web scraping and data management into a conversation. Instead of jumping between dashboards to trigger scrapers or check if a job finished, you can handle everything from your chat window. You can tell your agent to start a specific actor, ask for the results of a completed run, or list your available datasets to see what's ready for analysis. It handles the heavy lifting of navigating the Apify infrastructure so you can focus on the data itself. It's a core part of the Vinkius catalog because it removes the friction between raw web data and your AI's ability to process it. You get a direct line to your automation tasks, making it easy to move from data collection to data analysis in one go.

## Tools

### get_dataset_results
Pulls specific items from a dataset so your agent can read and analyze them. It makes it easy to get data into your conversation.

### get_run_details
Shows the status and metadata for a specific actor execution. This helps you debug your scrapers quickly.

### list_actors
Shows all the scraping actors available in your account. Use this to see what tools you can trigger.

### list_actor_runs
Lists recent executions to help you track your scraping history. It lets you see what finished and what failed.

### list_actor_tasks
Shows your saved actor configurations for easy reuse. It helps you avoid retyping the same settings every time.

### list_datasets
Lists all the datasets in your account. This gives you a clear view of all your collected data.

### run_actor
Starts a new scraper run with your specific input parameters. This lets you trigger a scrape directly from your chat.

## Prompt Examples

**Prompt:** 
```
What scrapers do I have available?
```

**Response:** 
```
I've checked your Apify account and found 4 active actors:

*   **Instagram Scraper**
*   **Google Maps Reviewer**
*   **Custom CRM Sync**
*   **Real Estate Listings Scraper**

Which one would you like to run or check for data?
```

**Prompt:** 
```
Run the Instagram scraper with #tech.
```

**Response:** 
```
I've started the **Instagram Scraper** for you with the hashtag `#tech`.

*   **Execution ID:** `run_88231`
*   **Status:** Running

I'll keep an eye on it and let you know as soon as the results are ready for analysis.
```

**Prompt:** 
```
Summarize the latest results from my shopping dataset.
```

**Response:** 
```
I've pulled the latest 50 items from your shopping dataset. Here is the summary:

| Category | Avg. Price | Rating |
| :--- | :--- | :--- |
| Electronics | $299.99 | 4.5/5 |
| Home Goods | $45.50 | 4.2/5 |
| Apparel | $89.00 | 4.0/5 |

Would you like me to look into the specific items for Electronics?
```

## Capabilities

### Start scraper runs
Trigger specific web scraping actors with your own input parameters directly from your chat.

### Pull dataset records
Fetch items from your datasets so your agent can read and analyze the data immediately.

### Check run history
View the status and history of recent actor executions to monitor your scraping progress.

### View saved tasks
See your configured actor tasks to quickly reuse saved scraper settings for new jobs.

### List all datasets
Browse all the datasets in your account to manage your collected web data in one place.

### Get run details
Retrieve metadata and logs for specific runs to debug your automated scrapers.

### Browse all actors
See all the actors available in your account to find the right tool for your next project.

## Use Cases

### Quick price monitoring
A researcher needs to know the current price of 50 products. Your agent uses run_actor to scrape a retail site and get_dataset_results to find the average price.

### Debugging failed scrapers
An engineer needs to check why a scraper failed. Your agent uses list_actor_runs to find the failed ID and get_run_details to see the error log.

### Summarizing customer reviews
A PM wants a summary of recent reviews. Your agent uses list_datasets to find the right one and summarizes the content for you.

### Exploring available scrapers
A data scientist wants to see what scrapers are available. Your agent uses list_actors to show a menu of options for a new project.

## Benefits

- Skip the dashboard by using run_actor to start scrapers directly from your chat window.
- Get instant analysis of scraped data by pulling records into your agent with get_dataset_results.
- Keep your scraping pipeline organized by using list_actor_tasks to find saved configurations.
- Monitor your scraping health in real time using list_actor_runs to catch errors before they pile up.
- Manage your data storage more easily by using list_datasets to see every collection in one place.
- Save time on setup by using list_actors to quickly find the right scraper for your next project.

## How It Works

The bottom line is you can manage your entire web scraping pipeline through a simple chat interface.

1. Connect your Apify API token from your account settings to your AI client.
2. Describe the scraping task or data request you want to complete in plain English.
3. Receive the structured results or status updates directly in your chat window.

## Frequently Asked Questions

**Can the Apify MCP run scrapers for me?**
Yes, it triggers actors directly. This means you can start a web scraping job just by asking your agent to do it.

**How do I get my scraped data into my AI?**
The Connector pulls results from your datasets. Your agent can then read those records and summarize them for you immediately.

**Can I see if my scraper failed?**
Yes, you can check your scraping history. The agent can look at recent executions to see if they finished successfully.

**Does this work with my existing Apify account?**
Yes, you just need to provide your API token. It connects your current account to any MCP-compatible client.

**Can I manage multiple datasets?**
Yes, the Connector lists all your datasets. This makes it easy to switch between different data collections in one chat.

**Is this good for large scale data extraction?**
Yes, it's built for that. It handles the management of actors and datasets so you can focus on the results.

**How do I reuse old scraper settings?**
You can list your saved tasks. This lets your agent find a previous configuration and run it again with new inputs.

**Can I provide input parameters when running an actor?**
Yes! Use the `run_actor` tool and provide the optional `input` JSON object to configure specific scraper settings for that run.

**How do I see the items collected in a dataset?**
Run the `get_dataset_results` query with your Dataset ID. The agent will retrieve the data records, which you can then ask the AI to summarize or analyze.

**Is it possible to check the status of a specific actor run?**
Absolutely. Use the `get_run_details` tool and provide the Run ID. Your agent will retrieve the status (RUNNING, SUCCEEDED, FAILED) and metadata for that specific execution.