Apify Actors MCP — Claude Code MCP 서버

Apify Store의 수천 개 스크래퍼/크롤러(Actor)를 호출해 소셜·검색·지도·이커머스 등 데이터를 추출하는 공식 Apify MCP 서버.

Apify Actors MCP는 Apify Store에 공개된 수천 개의 스크래퍼·크롤러(이들을 Apify에서는 "Actor"라 부른다)를 Claude Code 같은 MCP 클라이언트에서 직접 호출할 수 있게 해주는 공식 Apify MCP 서버입니다. 별도의 스크래핑 코드를 직접 작성하지 않아도, 에이전트가 자연어 요청을 받아 적절한 Actor를 찾고 입력값을 구성해 실행한 뒤, 추출된 구조화 데이터를 받아오는 흐름을 제공합니다.

해결하는 문제는 명확합니다. 웹 데이터 추출은 페이지 구조 파싱, 페이지네이션, 봇 차단·캡차 우회, 프록시 로테이션 등 손이 많이 가는 작업입니다. Apify는 이런 기능을 갖춘 검증된 Actor들을 마켓플레이스 형태로 제공하고, 이 MCP 서버는 그 카탈로그를 에이전트 도구로 노출합니다. 그 결과 소셜 미디어 게시물·프로필, 검색엔진 결과, 지도/장소 정보, 이커머스 상품·가격, 일반 웹 크롤링 등 다양한 소스에서 데이터를 끌어올 수 있습니다.

핵심 기능은 (1) 사용 가능한 Actor 탐색·검색, (2) 특정 Actor의 입력 스키마 확인, (3) Actor 실행과 결과(데이터셋) 회수입니다. 실제로 노출되는 도구 구성과 기본 동작은 버전에 따라 달라질 수 있으므로 정확한 도구 목록과 옵션은 공식 문서(github.com/apify/apify-mcp-server) 확인을 권장합니다.

누가 쓰면 좋은가: 리서치·시장조사·가격 모니터링·리드 수집·콘텐츠 수집처럼 반복적인 웹 데이터 추출이 필요한 사용자, 그리고 스크래퍼를 매번 직접 구현하기보다 검증된 Actor를 에이전트 워크플로에 끼워 넣고 싶은 개발자·분석가에게 적합합니다. Node(npx) 환경에서 동작하며 Apify 계정과 토큰만 있으면 빠르게 붙일 수 있습니다.

언제 쓰나

소셜·검색·지도·이커머스·일반 웹 등에서 구조화된 데이터를 반복적으로 추출해야 할 때, 그리고 매번 스크래퍼를 직접 구현하기보다 Apify Store의 검증된 Actor를 에이전트 워크플로에 바로 끼워 쓰고 싶을 때 적합합니다. 시장조사, 가격·재고 모니터링, 리서치 데이터 수집, 리드/콘텐츠 수집 같은 작업에 유용합니다. 단순한 한 페이지 추출이나 공식 API가 따로 있는 데이터라면 굳이 필요하지 않을 수 있습니다.

설치

claude mcp add apify-actors -e APIFY_TOKEN=<APIFY_TOKEN> -- npx -y @apify/actors-mcp-server

Node 환경이 필요하며 npx로 패키지를 받아 실행하는 방식입니다(첫 실행 시 다운로드 발생). 사전에 Apify 계정을 만들고 콘솔에서 API 토큰(APIFY_TOKEN)을 발급해 환경변수로 전달해야 합니다. 사용하려는 Actor마다 입력 스키마와 출력 형식, 과금 단위가 다르므로 실행 전 해당 Actor 문서를 확인하는 것이 좋습니다. 노출되는 도구 구성·기본 옵션은 서버 버전에 따라 달라질 수 있어, 정확한 사양은 공식 문서(github.com/apify/apify-mcp-server) 확인을 권장합니다.

필요 키(직접 발급, 플레이스홀더): APIFY_TOKEN

보안 주의

APIFY_TOKEN은 본인 Apify 계정에 대한 인증 키이므로 유출 시 계정의 Actor 실행·과금이 가능해집니다. 토큰은 환경변수로만 주입하고 코드·로그·커밋에 노출하지 마세요(.env는 gitignore 권장). Apify는 사용량 기반 과금이므로 에이전트가 무분별하게 Actor를 반복 실행하면 비용이 빠르게 누적될 수 있어, 대상 Actor와 실행 횟수를 통제하는 것이 안전합니다. 또한 스크래핑으로 들어온 외부 웹 콘텐츠에는 프롬프트 인젝션 위험이 있으므로, 추출 결과를 그대로 신뢰해 후속 명령으로 실행하지 말고 검토 후 사용하세요. 대상 사이트의 이용약관·robots·개인정보 규정 준수 책임은 사용자에게 있습니다.

자주 묻는 질문

APIFY_TOKEN은 어디서 발급하나요?

Apify 계정을 만든 뒤 Apify 콘솔의 계정/Integrations 영역에서 API 토큰을 발급해 APIFY_TOKEN 환경변수로 전달합니다. 정확한 경로와 권한 범위는 공식 문서 확인을 권장합니다.

사용 비용이 드나요?

Apify는 사용량 기반 과금이라 Actor 실행이 늘수록 비용이 발생할 수 있습니다. Actor마다 과금 단위가 다르므로 실행 전 해당 Actor 문서를 확인하고, 에이전트의 반복 실행을 통제하는 것이 좋습니다.

어떤 종류의 데이터를 추출할 수 있나요?

Apify Store의 Actor에 따라 소셜 미디어, 검색 결과, 지도/장소, 이커머스 상품·가격, 일반 웹 크롤링 등 다양합니다. 사용 가능한 Actor 목록과 입력 스키마는 서버를 통해 탐색하거나 공식 문서에서 확인할 수 있습니다.