Apify MCP — Сценарии использования, Установка & Живое демо

Name: Apify MCP Server
Author: apify

Зачем использовать

Ключевые функции

Access to 3000+ maintained Actors covering most popular scraping targets
Structured JSON output — Actors already normalize fields for you
Handles proxies, captcha solving, and anti-bot under the hood
Run on-demand or schedule Actors; results land in Apify datasets you can re-query
Pay-per-use — no monthly minimum beyond the free tier

Живое демо

Как выглядит на практике

apify.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "apify",
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "apify": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@apify/actors-mcp-server"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add apify -- npx -y @apify/actors-mcp-server

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Apify

Scrape Google Maps listings for local-business lead generation

👤 Sales / SDR teams building territory lists ⏱ ~15 min beginner

Когда использовать: You need 500 'coffee shops in Berlin' with address, phone, website, and rating — and you don't want to be blocked mid-run.

Предварительные требования

Apify account + API token — console.apify.com → Settings → Integrations → API token
Enough platform credits on Apify for your run size — Free plan gives $5 credit/month; most Google Maps runs cost ~$1 per 1000 places

Поток

Pick the right Actor for your target

Find the best-maintained Apify Actor for scraping Google Maps places. Prefer one with >5 stars and recent updates.✓ Скопировано

→ Actor slug like compass/crawler-google-places with its input schema
Run it with your query

Run that Actor with searchStringsArray=['coffee shop Berlin'], maxCrawledPlacesPerSearch=500, language='en'. Wait for completion.✓ Скопировано

→ Run status SUCCEEDED with a dataset id
Pull and clean the dataset

Get the dataset items. Keep only name, address, phone, website, rating, reviewsCount. Drop places without a phone. Output as CSV.✓ Скопировано

→ CSV of 400–500 cleaned leads

Итог: A de-duped lead list ready for CRM import, typically $1–3 in Apify credits.

Подводные камни

Running the wrong Actor — many copycats exist with worse reliability — Filter by usage count and last-updated in the Apify store; stick to the top 3 for a target
Massive datasets blow out your context window when returned inline — Ask Claude to page through items (limit+offset) or save to filesystem first, then summarize

Сочетать с: filesystem · postgres

Track Amazon product prices and stock status on a schedule

👤 E-commerce, affiliate marketers, competitive pricing teams ⏱ ~20 min intermediate

Когда использовать: You want a daily price+stock snapshot for 200 ASINs without babysitting a scraper.

Предварительные требования

List of ASINs or product URLs — CSV of URLs like https://www.amazon.com/dp/B0XXXXXX

Поток

Call the Amazon Product Scraper Actor

Run Actor junglee/amazon-crawler with urls=<my list>, maxReviews=0, scrapeProductDetails=true.✓ Скопировано

→ Run finishes with a dataset of products
Normalize price and stock

From the dataset, extract asin, title, price, currency, in_stock (bool), seller. Flag any asin where price dropped vs my last snapshot [paste].✓ Скопировано

→ Per-ASIN current vs prior comparison
Schedule it daily

Create a daily Apify schedule for this Actor with the same inputs. Name it 'amazon-price-tracker-<category>'.✓ Скопировано

→ Schedule created; next run time shown

Итог: A recurring price/stock watch with ~$0.30/day cost for 200 ASINs.

Подводные камни

Amazon aggressively throttles even with residential proxies — runs can partially fail — Enable Actor retries and accept that 5–10% of items may be missing; re-run failed asins in a small batch

Сочетать с: postgres · notion

Harvest recent posts from a public Twitter/X or TikTok profile

👤 Social-listening analysts, content researchers ⏱ ~20 min intermediate

Когда использовать: You track a public figure or brand and want their last 30 days of posts as structured data for analysis.

Предварительные требования

Profile URL(s) of the target account — Public profile link only — do not attempt private or logged-in scraping

Поток

Pick a reputable Twitter/TikTok Actor

Find the top Apify Actor for fetching public tweets from a handle. Show pricing per 1000 tweets.✓ Скопировано

→ Actor shortlist with price-per-1k numbers
Run for each target

Run it for handles [list] with maxTweets=300 and start_date=30 days ago.✓ Скопировано

→ Dataset with tweets + engagement counts
Summarize what changed in tone/topics

Cluster these posts into 5 topics and show engagement averages per topic. Call out any sharp rise in one topic.✓ Скопировано

→ Topic table + trend commentary

Итог: A structured social-post dataset plus 1-page topical trend summary.

Подводные камни

Scraping private/logged-in content violates platform ToS and can break at any moment — Stick to public profiles only; treat partial failures as expected, not as bugs to chase

Сочетать с: notion · postgres

Run a large crawl job async and collect results later

👤 Engineers running >10k-page crawls ⏱ ~45 min advanced

Когда использовать: Your crawl will take 30 minutes to 6 hours — you don't want the MCP call to block that long.

Поток

Kick off the run without waiting

Start Actor apify/website-content-crawler with startUrls=[...], maxCrawlPages=10000. Return the runId, don't wait.✓ Скопировано

→ runId returned immediately
Poll status periodically

Check run <runId> status. How many pages done, how many errored, ETA?✓ Скопировано

→ Progress numbers
Stream results when ready

Run is SUCCEEDED. Page through the dataset 1000 items at a time and save each page to /crawls/<runId>/page-<n>.jsonl.✓ Скопировано

→ Local JSONL files ready for downstream processing

Итог: A large crawl completed without blocking your chat session, and results on disk ready for indexing.

Подводные камни

Letting Claude pull the full dataset in one call — will OOM the context — Always page; never request the entire dataset at once
Costs balloon on deep crawls with no cap — Set maxCrawlPages AND memory/cpu limits on the Actor before starting

Сочетать с: filesystem · qdrant

Комбинации

Сочетайте с другими MCP — эффект x10

apify + postgres

Scrape via Apify Actor then upsert normalized rows into your product DB

Run the Amazon Actor for my ASIN list, then upsert each result into the product_prices table with today's date.✓ Скопировано

apify + qdrant

Crawl a docs site then embed each page into a vector collection for RAG

Use Website Content Crawler on docs.stripe.com, then embed each page and upsert into the Qdrant stripe_docs collection.✓ Скопировано

apify + filesystem

Persist raw crawl output locally as JSONL before downstream processing

Run the Google Maps Actor for 'dentist Paris', save the raw dataset to /data/leads/paris-dentists.jsonl.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search-actors	query: str, limit?: int	Discover which Actor fits your target before running	free
get-actor	actorId: str	Inspect an Actor's input schema and pricing before calling	free
call-actor	actorId: str, input: object, timeout?: int	Run an Actor and wait for it to finish (short runs only)	Actor-specific; billed in Apify platform credits
get-dataset-items	datasetId: str, limit?: int, offset?: int	Page through a completed run's dataset	free
get-run	runId: str	Poll status of a long-running job	free

Стоимость и лимиты

Во что обходится

Квота API: Apify API is generous; Actors themselves are metered in platform credits
Токенов на вызов: Actor input+output responses are usually 500–3000 tokens; large datasets should be paged
Деньги: Free plan: $5 platform credit/month. Paid from $49/mo for $49+ credits. Per-Actor pricing varies ($0.25–$5 per 1000 results is typical).
Совет: Always inspect Actor pricing via get-actor before calling; set maxResults/maxCrawlPages on every run to cap spend.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Apify API token with default scope

Хранение учётных данных: API token in env var APIFY_TOKEN

Исходящий трафик: Calls to api.apify.com; Actors themselves may fetch any public URL you instruct them to

Никогда не давайте: Root/admin tokens if user-scoped tokens suffice

Respect target sites' robots.txt and ToS — Apify does not absolve you of legal responsibility.
Do not use to scrape private/logged-in content; that violates both Apify ToS and target ToS.

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

APIFY_TOKEN missing or revoked. Re-issue at console.apify.com/settings/integrations.

Проверить: curl -H 'Authorization: Bearer $APIFY_TOKEN' https://api.apify.com/v2/users/me

Actor run FAILED with 'Not enough platform credits'

Top up in Apify console billing or pick a cheaper Actor variant; set maxResults to cap cost next time.

Run succeeds but dataset is empty

Wrong input schema — run get-actor to read the required field names, the Actor likely silently ignored your input.

Timeout waiting for call-actor

Long crawls exceed MCP call timeout; start the run, get the runId, then poll with get-run instead of blocking.

Альтернативы

Apify в сравнении

Альтернатива	Когда использовать	Компромисс
Firecrawl MCP	Generic page-to-markdown scraping across any site	Less specialized for specific targets like Amazon or Maps
Bright Data MCP	You need heavy-duty residential proxies and SERP API	More expensive; focused on unblocking rather than pre-built Actors
Playwright MCP	You need to script a custom flow (login, multi-step click-through)	You write and maintain the scraping logic yourself

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills