apify-mcp-server

mcp.apify.com

mcp.apify.com의 Apify MCP(Model Context Protocol) 서버를 사용하면 AI 에이전트가 Apify Store의 수천 가지 기성 스크래퍼, 크롤러, 자동화 도구를 활용해 소셜 미디어, 검색 엔진, 지도, 이커머스 사이트 및 기타 모든 웹사이트에서 데이터를 추출할 수 있습니다. OAuth를 지원하므로 Claude.ai나 Visual Studio Code 같은 클라이언트에서 URL만으로 연결할 수 있습니다.

🚀 호스팅된 Apify MCP 서버를 사용하세요!

최상의 경험을 위해 AI 어시스턴트를 https://mcp.apify.com의 호스팅 서버에 연결하세요. 호스팅 서버는 구조화된 Actor 결과에 대한 출력 스키마 추론을 포함해, stdio를 통해 로컬에서 실행할 때는 사용할 수 없는 최신 기능을 지원합니다.

⚠️ 레거시 SSE 전송이 제거되었습니다. https://mcp.apify.com/sse 엔드포인트는 Streamable HTTP로 대체되어 제거되었습니다. 클라이언트를 https://mcp.apify.com으로 마이그레이션하세요 — 구성에서 /sse 접미사를 제거하세요.

💰 이 서버는 에이전틱 결제도 지원합니다: AGI에서 토큰을 구매해 모든 Actor를 실행하거나, 직접 x402(Pay Per Event Actor 전용) 또는 Skyfire를 통해 요청별로 결제할 수 있습니다.

Apify MCP Server는 Claude Code, Claude.ai, Cursor, VS Code 및 Model Context Protocol을 준수하는 모든 클라이언트와 호환됩니다. 자세한 내용은 MCP 클라이언트 섹션을 확인하거나 MCP 구성 페이지를 방문하세요.

목차

🌐 Apify MCP Server 소개
🚀 빠른 시작
🤖 MCP 클라이언트
🪄 Apify MCP 즉시 사용해 보기
💰 에이전틱 결제

에이전틱 결제 작동 방식
🪙 AGI (권장)
💸 직접 x402
🔥 Skyfire

🛠️ 도구, 리소스, 프롬프트
📊 텔레메트리
💬 사용 예시
🐛 문제 해결
⚙️ 개발
🔒 개인정보 처리방침
🤝 기여
📚 더 알아보기

🌐 Apify MCP Server 소개
Apify MCP Server를 사용하면 AI 어시스턴트가 모든 Apify Actor를 특정 작업을 수행하는 도구로 사용할 수 있습니다. 예를 들어 다음과 같이 할 수 있습니다:

Facebook Posts Scraper를 사용해 여러 페이지/프로필의 Facebook 게시물에서 데이터를 추출합니다.
Google Maps Email Extractor를 사용해 Google Maps에서 연락처 정보를 추출합니다.
Google Search Results Scraper를 사용해 Google 검색 엔진 결과 페이지(SERP)를 스크래핑합니다.
Instagram Scraper를 사용해 Instagram 게시물, 프로필, 장소, 사진, 댓글을 스크래핑합니다.
RAG Web Browser를 사용해 웹을 검색하고 상위 N개 URL을 스크래핑한 뒤 그 콘텐츠를 반환합니다.
Web Fetch를 사용해 모든 URL을 가져와 그 콘텐츠를 Markdown, 일반 텍스트, HTML 또는 링크로 반환합니다 — JavaScript 렌더링과 안티봇 보호 기능을 갖추고 있습니다.

동영상 튜토리얼: 8,000개 이상의 Apify Actor와 에이전트를 Claude와 통합하기

🚀 빠른 시작
Apify MCP Server는 두 가지 방법으로 사용할 수 있습니다:

HTTPS 엔드포인트(mcp.apify.com): OAuth를 통해 또는 요청에 Authorization: Bearer <APIFY_TOKEN> 헤더를 포함해 MCP 클라이언트에서 연결합니다. 대부분의 사용 사례에 권장되는 방법입니다. OAuth를 지원하므로 Claude.ai나 Visual Studio Code 같은 클라이언트에서 URL(https://mcp.apify.com)만으로 연결할 수 있습니다.

https://mcp.apify.com streamable transport

표준 입출력(stdio): 로컬 통합 및 Claude for Desktop 클라이언트 같은 명령줄 도구에 이상적입니다.

MCP 클라이언트 서버 명령을 npx @apify/actors-mcp-server로 설정하고 APIFY_TOKEN 환경 변수를 Apify API 토큰으로 설정하세요.
더 많은 옵션은 npx @apify/actors-mcp-server --help를 참조하세요.

MCP 서버 설정에 대한 자세한 지침은 Apify 문서에서 확인할 수 있습니다.

🤖 MCP 클라이언트
Apify MCP Server는 Model Context Protocol을 준수하는 모든 MCP 클라이언트와 호환되지만, 동적 도구 검색 및 기타 기능에 대한 지원 수준은 클라이언트마다 다를 수 있습니다.

Apify MCP Server와 상호작용하려면 Claude Desktop, Visual Studio Code 또는 Apify Tester MCP Client 같은 클라이언트를 사용할 수 있습니다.

mcp.apify.com을 방문해 선호하는 클라이언트에 맞게 서버를 구성하세요.

테스트된 클라이언트

Claude Desktop
Claude.ai (웹)
ChatGPT
VS Code (Genie)
Cursor
OpenCode
Kiro
Apify Tester MCP Client — Apify MCP 서버 테스트용으로 설계됨

🪄 Apify MCP 즉시 사용해 보기
설정 없이 Apify MCP를 사용해 보고 싶으신가요?

Apify Tester MCP Client를 확인해 보세요.

이 대화형 채팅 같은 인터페이스는 로컬 설정 없이 Apify MCP의 기능을 탐색할 수 있는 쉬운 방법을 제공합니다. Apify 계정으로 로그인하고 웹 스크래핑, 데이터 추출, 자동화 도구를 실험해 보세요!

또는 MCP 번들 파일(이전 명칭 Anthropic Desktop extension 파일, 즉 DXT)을 사용해 원클릭으로 설치할 수 있습니다: Apify MCP Server MCPB 파일

💰 에이전틱 결제
AGI, 직접 x402 또는 Skyfire를 사용하면 Apify API 토큰 없이도 Actor 실행 비용을 결제할 수 있습니다.

AGI(agi.apify.com)는 x402 또는 MPP 결제에 대한 대가로 선불 Apify API 토큰을 발급합니다. 이 토큰을 일반 API 토큰처럼 mcp.apify.com과 api.apify.com에 사용하세요 — Pay Per Event Actor뿐 아니라 모든 Actor에 사용할 수 있습니다. 새 통합에는 권장됩니다. 아래 AGI(권장)를 참조하세요.
직접 x402는 Base에서 USDC로 요청별 결제하며 별도의 플랫폼 계정이 필요하지 않습니다. mcpc(brew install apify/tap/mcpc 또는 npm install -g @apify/mcpc)에서 완전히 지원됩니다. 최신 기능과 x402 프로토콜을 기본적으로 지원하는 몇 안 되는 MCP 클라이언트 중 하나이기 때문에 mcpc를 사용합니다.
Skyfire는 PAY 토큰으로 결제하며 자금이 충전된 지갑이 있는 Skyfire 계정이 필요합니다. 특별한 MCP 클라이언트가 필요하지 않으며, 전체 결제 흐름이 MCP 도구 호출 매개변수를 통해 직접 처리됩니다.

ℹ️ 범위: 직접 x402와 Skyfire는 모두 Pay Per Event Actor로 제한되며, Standby Actor는 지원하지 않고, 토큰을 발급하는 대신 실행별로 정산합니다.

에이전틱 결제 작동 방식
Actor 실행 비용은 다양하므로 두 결제 방식 모두 선불 잔액 모델을 사용합니다. 결제 흐름은 네 단계로 진행됩니다:

검색: 에이전트가 search-actors 또는 fetch-actor-details로 Actor를 검색합니다. 이 호출은 무료입니다.
선불: 유료 Actor 도구를 실행하기 전에 에이전트가 선불 잔액을 충전합니다.

직접 x402: mcpc가 자동으로 $1.00 USDC 트랜잭션에 서명합니다.
Skyfire: 에이전트가 Skyfire의 create-pay-token 도구를 사용해 PAY 토큰(최소 $5.00)을 생성합니다.

실행: 에이전트가 Actor 도구를 호출합니다.

직접 x402: mcpc가 선불 잔액을 사용해 자동으로 처리합니다.
Skyfire: 에이전트가 skyfire-pay-id 입력 속성에 PAY 토큰을 명시적으로 전달합니다.

정산: 도구가 Actor 결과를 반환합니다. 사용하지 않은 자금은 이후 실행을 위해 남아 있습니다.

직접 x402: 60분 동안 활동이 없으면 서버가 사용하지 않은 잔액을 Base의 지갑으로 환불합니다.
Skyfire: 토큰이 만료되면 Skyfire가 사용하지 않은 자금을 반환합니다.

🪙 AGI (권장)
AGI(Apify Agent General Interface)는 자율 에이전트가 계정 없이 Apify 사용 비용을 결제하는 권장 방법입니다. x402 또는 MPP로 한 번 결제하면 지출 한도가 설정된 선불 Apify API 토큰을 받고, 이를 mcp.apify.com과 api.apify.com에 직접 사용할 수 있습니다(Authorization: Bearer <token>) — 모든 Actor에 사용 가능합니다.

전체 프로토콜, 지원되는 결제 방법, 현재 약관(최소 금액, 토큰 수명, 환불 정책)은 agi.apify.com/AGENTS.md에 문서화되어 있습니다 — 이를 단일 진실 공급원으로 취급하세요.

💸 직접 x402
x402 프로토콜은 직접적인 기계 간 결제를 가능하게 합니다. MCP 클라이언트는 이를 사용해 Base 블록체인의 USDC로 Actor 실행 비용을 결제할 수 있으며, Apify API 토큰이 전혀 필요하지 않습니다.

사전 요구 사항

Base 메인넷에서 USDC가 있는 지갑.

설정
지갑을 생성하거나 가져옵니다:

# 새 지갑 생성
mcpc x402 init

# 기존 지갑 가져오기
mcpc x402 import < private-key >

# 지갑 주소와 자금 충전 QR 코드를 표시하여 Base(https://base.org)에서 USDC로 충전할 수 있게 합니다
mcpc x402
x402를 활성화한 상태로 서버에 연결합니다:

mcpc connect " mcp.apify.com?payment=x402 " @apify --x402
이제 유료 도구를 호출할 수 있습니다:

mcpc @apify tools-call call-actor actor:= " apify/rag-web-browser " input:= ' {"query": "latest AI news"} '
🔥 Skyfire
Skyfire는 AI 에이전트를 위한 관리형 결제 인프라를 제공합니다. Apify API 토큰으로 인증하는 대신, 에이전트가 PAY 토큰을 사용해 각 도구 호출 비용을 충당하는 Skyfire 결제 토큰을 전달합니다.

사전 요구 사항

자금이 충전된 지갑이 있는 Skyfire 계정.
Claude Desktop, OpenCode, VS Code처럼 여러 서버를 지원하는 MCP 클라이언트.

설정
클라이언트에서 Skyfire MCP 서버와 Apify MCP Server를 구성합니다. Apify 서버 URL에 payment=skyfire를 추가합니다:

{
"mcpServers" : {
"skyfire" : {
"url" : " https://api.skyfire.xyz/mcp/sse " ,
"headers" : {
"skyfire-api-key" : " <YOUR_SKYFIRE_API_KEY> "
}
},
"apify" : {
"url" : " https://mcp.apify.com?payment=skyfire "
}
}
}
설정 세부 사항은 Skyfire 통합 문서를 참조하세요. Agentic Payments with Skyfire 게시물에서 추가 배경 정보를 제공합니다.

🛠️ 도구, 리소스, 프롬프트
MCP 서버는 Apify Actor와 상호작용하기 위한 도구 세트를 제공합니다. Apify Store는 방대하고 빠르게 성장하고 있으므로, MCP 서버는 새로운 Actor를 동적으로 검색하고 사용할 수 있는 방법을 제공합니다.

Actors
모든 Apify Actor를 도구로 사용할 수 있습니다. 기본적으로 서버는 두 개의 Actor(apify/rag-web-browser와 apify/web-fetch)와 여러 헬퍼 도구로 미리 구성되어 있습니다. MCP 서버는 Actor의 입력 스키마를 로드하고 해당하는 MCP 도구를 생성합니다. 이를 통해 AI 에이전트는 Actor에 전달할 인수와 반환될 내용을 정확히 알 수 있습니다.

예를 들어 apify/rag-web-browser Actor의 입력 매개변수는 다음과 같습니다:

{
"query" : " restaurants in San Francisco " ,
"maxResults" : 3
}
어떤 Actor를 호출할지 또는 그 입력 매개변수를 수동으로 지정할 필요가 없습니다. LLM이 이를 자동으로 처리합니다. 도구가 호출되면 인수는 LLM에 의해 자동으로 Actor에 전달됩니다. 사용 가능한 인수 목록은 해당 Actor의 문서를 참조하세요.

헬퍼 도구
Apify와 함께 MCP를 사용하는 가장 강력한 기능 중 하나는 동적 도구 검색입니다. 이를 통해 AI 에이전트는 필요에 따라 새로운 도구(Actor)를 찾아 통합할 수 있습니다. 다음은 몇 가지 특수 MCP 작업과 Apify MCP Server의 지원 방식입니다:

Apify Actors: Actor를 검색하고, 계정의 Actor를 나열하고, 세부 정보를 확인하고, AI를 위한 도구로 사용하고, 자신의 Actor를 삭제합니다.
Apify 문서: Apify 문서를 검색하고 특정 문서를 가져와 AI에 컨텍스트를 제공합니다.
Actor 실행: Actor 실행 목록을 가져오고, 세부 정보를 검사하고, 로그를 검색합니다.
Apify 스토리지: 데이터셋과 키-값 저장소의 데이터에 접근합니다.
Actor 작업: 저장된 Actor 작업을 생성, 검사, 업데이트하고, 공개 랜딩 페이지를 게시하거나 게시 취소합니다.
스케줄: Actor와 작업을 자동으로 실행하는 스케줄을 생성, 검사, 업데이트, 삭제합니다.
빌드: Actor 버전을 빌드하고, 빌드를 나열하고, 빌드 상태를 확인하고, 빌드 로그를 검색합니다.
Actor 버전: 각 파일의 해시와 전체 세트의 리비전과 함께 Actor 버전의 파일을 읽고, 파일로부터 Actor를 생성하고, 마지막 읽기 이후 변경 사항을 잡아내는 검사와 함께 버전의 파일을 변경하고, 파일로부터 또는 다른 버전의 복사본으로 버전을 추가하고, 버전을 삭제합니다.
Apify API: Apify API 레퍼런스를 검색하고, 작업을 검사하고, API에 요청을 보내 데이터를 읽거나 변경합니다.

사용 가능한 도구 개요
다음은 Apify MCP Server가 제공하는 모든 도구의 개요 목록입니다.

기본 활성화 열 범례:

✅ — 기본 도구 세트에 포함.
⚡ — call-actor, Actor 도구 또는 get-actor-run이 있을 때 자동 주입됨(기본 구성에서는 항상 참).
✅¹ — 기본적으로 제공되지만, 텔레메트리가 활성화되어 있고 클라이언트가 제외되지 않은 경우에만: Anthropic 표면(Claude.ai / Claude Desktop, 로컬 에이전트 모드 / Claude Code 포함). 비활성화하려면 이를 생략한 명시적 tools= 목록을 전달하세요. 명시적으로 선택하면(tools=report-problem 또는 tools=dev) 클라이언트와 관계없이 제공됩니다 — 텔레메트리는 여전히 활성화되어야 합니다.

도구 이름
카테고리
설명
기본 활성화

search-actors
actors
Apify Store에서 Actor를 검색합니다.
✅

fetch-actor-details
actors
특정 Actor에 대한 자세한 정보를 검색합니다. 입력 스키마, README(가능한 경우 요약, 그렇지 않으면 전체), 가격, Actor 출력 스키마, …를 포함합니다.