apify/agent-skills

Apify Agent Skills – 무엇인가요

Claude Code, Cursor, Windsurf, Codex 또는 Gemini와 같은 대규모 언어 모델(Large Language Model, LLM) 에이전트가 직접 Apify 플랫폼을 호출할 수 있도록 해주는 "스킬"(플러그인 형식의 명령 패키지) 모음입니다. 단일 설치만으로 에이전트는 Apify Actors(서버리스 웹 스크래핑/자동화 작업)를 선택하고 실행하며, 필요 시 즉시 새로운 Actors를 생성할 수도 있습니다.

핵심 기능 (5개 내장 스킬)

스킬	기능
apify-ultimate-scraper	요청된 사이트에 적합한 Apify Actor를 선택(Instagram, TikTok, Google Maps, Amazon 등 130개 이상의 커스터마이즈된 Actors)하고, 필요 시 전체 Apify 스토어(30,000개 이상의 Actors)로 백업합니다. 구조화된 데이터(CSV, JSON 등)를 반환합니다.
apify-actor-development	JavaScript, TypeScript 또는 Python으로 새로운 Apify Actors를 생성, 디버그 및 배포하며 `actor.json`, 입력/출력 스키마, 로깅, 대기 모드를 처리합니다.
apify-actorization	기존 스크립트, 라이브러리 또는 CLI 도구를 Apify Actor로 래핑하며, JS/TS SDK, Python async 매니저, 또는 기타 언어용 일반 래퍼를 지원합니다.
apify-generate-output-schema	Actor의 소스 코드를 분석하고 자동으로 `dataset_schema.json`, `output_schema.json`, `key_value_store_schema.json`을 생성합니다.
apify-integration-development	제품용 공식 Apify 통합을 구축하는 과정을 안내합니다(예: Zapier/n8n 스타일 워크플로우, LangChain/LlamaIndex 스타일 플러그인, 또는 직접 API 클라이언트).

보조적인 apify-actor-commands 팩은 /create-actor와 같은 슬래시 명령어를 추가하여 인터랙티브한 스크래핑을 가능하게 합니다.

일반적인 사용 사례 프롬프트

시나리오	AI 에이전트에게 줄 수 있는 예시 프롬프트
리드 생성	"Google Maps에서 브루클린의 이탈리아 음식점 중 4점 만점에 4점 미만인 곳을 찾아, 리뷰와 웹사이트를 스크래핑하여 소유자 이메일을 추출하고 CRM용 순위 기준 CSV로 내보내주세요."
경쟁사 정보 수집	"경쟁사 A–C의 가격 페이지, G2 리뷰, 최근 채용 공고, 소셜 게시물을 가져와 포지셔닝 격차를 요약해 주세요."
시장 조사	"Amazon과 Walmart에서 무선 이어버드의 가격, 리뷰 수, 베스트셀러 순위를 스크래핑하고, 부정적 리뷰 문제를 표시하며 가격 최적점 제안해 주세요."
브랜드 평판 분석	"지난 30일간 Instagram, LinkedIn, X, YouTube에서 Acme에 대한 언급을 수집하고 감성 분석을 수행한 후, 상위 5개의 불만 및 칭찬 주제를 나열해 주세요."
인플루언서 검증	"Instagram과 TikTok에서 팔로워 수 5만~50만 사이의 피트니스 인플루언서 20명을 찾아, 참여율과 과거 브랜드 협업을 스크래핑하고 참여율 대 팔로워 수 비율로 순위 매겨 주세요."
위치 인텔리전스	"Google Maps에서 5개 주소 주변 2마일 내의 모든 카페를 스크래핑하고, 평점, 가격 수준, 영업 시간을 비교하여 최적의 장소를 추천해 주세요."

빠른 시작 (Claude Code 예제)

npx skills add https://github.com/apify/agent-skills --skill apify-ultimate-scraper

그런 다음 에이전트에게 다음과 같이 요청하세요:

"Google Maps에서 'AI 코딩 툴'에 대한 상위 50개 결과를 스크래핑하여 CSV로 저장해 주세요." 이 스킬은 Actor 선택, 입력 형식화, 실행 모니터링, 결과 포맷팅을 모두 자동으로 처리합니다.

다양한 에이전트용 설치 방법

Claude Code – 리포지토리를 플러그인으로 추가하고 /plugin install … 명령어로 각 스킬을 설치 (README 참조).
Cursor / Windsurf – 동일한 Claude 플러그인 형식; 리포지토리를 워크스페이스 설정에 추가.
Codex CLI / Gemini CLI – 리포지토리를 클론하고 에이전트를 agents/AGENTS.md (자동 생성된 인덱스) 또는 gemini-extension.json 매니페스트에 지정.
모든 마크다운 인식 에이전트 – 스킬 파일을 직접 참조 (skills/<skill>/SKILL.md).

사전 요구 사항

Apify 계정 (무료 티어 제공).
Apify CLI (npm install -g apify-cli 또는 brew install apify-cli) 및 apify login을 통한 로그인.
헤드리스/CI 사용을 위한 API 토큰 (APIFY_TOKEN 환경 변수).
Node.js 20.6+ (CLI 및 Ultimate Scraper 스킬에서 필수).

가격 및 라이선스

Apify의 Actors는 결과 또는 이벤트 단위로 요금이 부과되며, 각 Actor는 자체 가격을 설정합니다. 모든 계정에 무료 크레딧이 포함되어 있습니다.
이 리포지토리의 코드는 Apache-2.0 라이선스 하에 배포됩니다.

도움 받기 / 더 알아보기

문서 – https://docs.apify.com
Discord 커뮤니티 – https://discord.gg/jyEM2PRvMU
블로그 게시물 – Apify Agent Skills 소개 (README 내 링크).
커뮤니티 스킬 컬렉션 – https://github.com/apify/awesome-skills
이슈 – GitHub 리포지토리에서 열기.

결론: Apify Agent Skills는 LLM 기반 코딩 에이전트를 인프라 코드를 전혀 작성하지 않고도 수천 개의 완성된 Apify Actors를 호출하거나 새로운 것을 만들 수 있는 완전한 기능의 웹 스크래핑 및 자동화 개발자로 전환시켜 줍니다.

apify/agent-skills