n8n 통합

Scavio는 n8n에서 검증된 공식 커뮤니티 노드인 n8n-nodes-scavio를 제공합니다. HTTP 노드를 작성하거나 사용자 인증 헤더를 유지 관리할 필요 없이 모든 n8n 워크플로우에 추가하여 Google, Amazon, Walmart, YouTube, Reddit에서 실시간 검색을 실행할 수 있습니다. 이 노드는 usableAsTool로 등록되어 있어 n8n AI Agent 노드에 직접 연결할 수 있습니다.

검증 상태

• npm 패키지: n8n-nodes-scavio
• n8n 팀의 승인을 받았으며 다음 n8n 릴리스 배치에서 검증된 커뮤니티 노드로 제공될 예정입니다.
• 소스 코드: github.com/scavio-ai/n8n-nodes-scavio
• 라이선스: MIT

전제 조건

1. n8n 버전 1.0 이상(클라우드 또는 자체 호스팅).
2. dashboard.scavio.dev에서 Scavio API 키.

설치 (n8n Cloud 및 자체 호스팅)

n8n 내에서 Settings → Community Nodes → Install을 열고 패키지 이름을 입력하세요:

n8n-nodes-scavio

Install을 클릭하세요. n8n이 npm에서 최신 검증 버전을 가져와 워크플로우 편집기에 Scavio 노드를 등록합니다. n8n Cloud에서는 재시작이 필요하지 않으며, 자체 호스팅의 경우 새로고침이 필요할 수 있습니다.

설치 (수동 / Docker)

패키지를 직접 고정하려는 자체 호스팅 인스턴스의 경우:

# n8n 컨테이너 또는 호스트 내에서
npm install n8n-nodes-scavio

# 그런 다음 n8n을 재시작하여 노드를 로드합니다.
n8n start

Docker 배포의 경우 설치된 패키지를 포함하는 볼륨을 마운트하거나 n8n 이미지를 확장하고 빌드의 일부로 npm install n8n-nodes-scavio를 실행하세요.

자격 증명 구성

1. n8n에서 Credentials → New를 열고 Scavio API를 선택하세요.
2. Scavio API 키를 API Key 필드에 붙여넣으세요. 키는 n8n에 의해 암호화되어 저장됩니다.
3. Test를 클릭하세요. 자격 증명 테스트는 Scavio API의 GET /api/v1/usage를 호출하므로(무료 엔드포인트) 크레딧을 소비하지 않고 키가 유효한지 즉시 확인할 수 있습니다.

Scavio 노드 사용

1. 워크플로우에 새 노드를 추가하고 Scavio를 검색하세요.
2. 리소스를 선택하세요:
   • Google — 유기적 SERP 검색.
   • Amazon — 12개 마켓플레이스에서 ASIN별 제품 검색 및 제품 세부 정보.
   • Walmart — 배송 및 가격 필터가 포함된 제품 검색 및 제품 세부 정보.
   • YouTube — 동영상 검색 및 메타데이터.
   • Reddit — 게시물 검색 및 ID별 전체 게시물 + 댓글 트리.
   • Account — API 사용량 및 남은 크레딧 확인.
3. 해당 리소스에 대한 작업을 선택하세요(예: Search, Get Product, Get Post).
4. 작업 매개변수(쿼리 문자열, 국가, ASIN, 게시물 ID 등)를 입력하세요.
5. 노드를 실행하세요. 출력은 구조화된 JSON으로, 다운스트림 노드가 직접 읽을 수 있습니다.

n8n AI Agent 노드 내에서 도구로 사용

Scavio 노드는 usableAsTool: true로 등록되어 있으므로 n8n AI Agent 노드가 다단계 추론 내에서 도구로 호출할 수 있습니다. Scavio 노드를 에이전트의 도구 입력에 연결하면 에이전트가 실행 중 필요에 따라 Scavio: Google Search, Scavio: Amazon Search Products 등을 호출합니다.

사용 가능한 작업

예제 워크플로우

Scavio 노드가 깔끔하게 들어맞는 일반적인 패턴:

• 리드 자격 평가 — 인바운드 웹훅 → Scavio (Google · site:linkedin.com/company COMPANY) → LLM 점수 매기기 → CRM 쓰기.
• Amazon 가격 하락 알림 — Cron → Scavio (Amazon · Get Product by ASIN) → 이전 가격과 비교 → Slack 알림. 작동하는 예제 워크플로우가 리포지토리에 workflows/amazon-price-drop.json으로 포함되어 있습니다.
• Reddit 감정 모니터링 — Cron → Scavio (Reddit · Search Posts) → LLM 요약 → 일일 요약 이메일.
• 현지화된 콘텐츠 자동화 — 일일 Cron → Scavio (Google + Reddit)로 실시간 현지 컨텍스트 수집 → LLM이 게시물 작성 → Google 시트에 고객 승인.
• 근거 기반 WhatsApp/Slack 봇 — 메시지 트리거 → Scavio (Google)로 실시간 답변 근거 수집 → LLM이 답변 작성 → 채널 응답.

노드 업데이트

n8n은 검증된 노드의 새 버전을 npm에서 모니터링하고 빠른 재검토 후 자동으로 전파합니다. 자체 호스팅 n8n에서 수동 업데이트를 강제하려면:

npm install n8n-nodes-scavio@latest
n8n start

문제 해결

• 자격 증명 테스트 실패: API 키가 dashboard.scavio.dev 의 전체 sk_live_ 접두사 키인지, 네트워크가 https://api.scavio.dev에 도달할 수 있는지 확인하세요.
• 설치 후 편집기에 노드가 나타나지 않음: 자체 호스팅의 경우 n8n 프로세스를 다시 시작하여 커뮤니티 노드를 다시 등록하세요.
• 429 / 속도 제한 오류: 재시도 지침은 속도 제한 문서와 오류 참조를 확인하세요.

리소스

• npm의 n8n-nodes-scavio
• GitHub 소스
• n8n 커뮤니티 노드 설치 가이드
• Scavio API 빠른 시작
• Google Search API 참조