SerpCrypto SERP API로 n8n AI 에이전트에서 웹 검색하기

커스텀 노드 대신 HTTP Request 노드를 쓰는 이유는 무엇인가요?

n8n 문서에 따르면 HTTP Request 노드는 일반 노드로 실행하거나 AI agent에 연결해 도구로 사용할 수 있습니다. 이는 헤더 하나와 몇 개의 검색 쿼리 파라미터로 GET 요청 하나를 보내는 SerpCrypto 같은 REST API에 적용됩니다. 설치하거나 최신 상태로 유지할 커뮤니티 노드가 없고, credential은 n8n의 암호화된 credential 저장소에 그대로 남습니다.

AI Agent 노드에는 chat model과 최소 하나의 tool 서브 노드가 필요합니다. n8n 1.82.0부터 모든 AI Agent는 Tools Agent로 동작하므로, agent가 검색 도구를 언제 호출할지 스스로 결정합니다.

API 키는 어떻게 저장하나요?

Header Auth credential을 만드세요. n8n의 credential 문서는 헤더 Name과 Value 두 필드를 설명하며, bearer 토큰은 이름이 Authorization, 값이 Bearer <token>인 header auth라고 안내합니다. Name에 Authorization를, Value에 Bearer 와 SerpCrypto 키를 넣으세요.

n8n에는 일반 Bearer auth 유형도 있는데, 둘 중 어느 것을 써도 같은 헤더를 보냅니다. n8n에 전용 API 키를 발급하면 다른 스크립트와 별도로 사용량을 확인하고 필요할 때 그것만 폐기할 수 있습니다. 대시보드에서 언제든지 생성하고 폐기할 수 있는 API 키.

모델이 검색 쿼리를 어떻게 채우나요?

모델이 q를 정의하도록 두세요. 대상 파라미터 필드 옆에 n8n은 값을 모델에 넘기는 별 버튼을 표시합니다. $fromAI() 표현식을 직접 입력할 수도 있는데, 이는 key, description, type, default value를 받으며 description이 모델에게 무엇을 넣을지 알려줍니다. n8n 문서에 따르면 $fromAI()는 AI Agent 노드에 연결된 도구에서만 동작합니다.

agent가 하나의 시장만 담당한다면 gl과 hl를 고정하세요. 사용자가 여러 국가를 물어본다면 모델이 이것도 설정하도록 하고, gb나 de 같은 예상 코드를 설명해 주세요.

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

Optimize Response를 켜는 이유는 무엇인가요?

JSON으로 된 전체 결과 페이지는 길고, 도구가 반환하는 모든 것이 모델의 context로 들어갑니다. Optimize Response는 HTTP Request 노드의 도구 전용 옵션으로 모델에 전달되는 데이터를 줄이며, n8n은 비용을 절감할 수 있다고 안내합니다. JSON 응답 유형에서는 Field Containing Data를 organic_results로 설정하고 title, link, snippet만 선택하세요.

그러면 agent는 페이지의 모든 블록 대신 검색당 약 열 개의 짧은 항목을 읽습니다. agent가 지역 관련 질문에 답한다면 두 번째 도구에서 Field Containing Data를 local_results로 지정하세요.

일반 워크플로에서 같은 API를 어떻게 쓰나요?

agent 없이 HTTP Request 노드를 고정된 q를 가진 일반 노드로 사용하세요. 예를 들어 매일 아침 키워드를 확인하는 Schedule Trigger 워크플로에서 쓸 수 있습니다. 그다음 Split Out 노드를 추가하고 Field to Split Out을 organic_results로 설정하세요. 그러면 목록이 결과당 하나의 항목으로 바뀌어 스프레드시트나 데이터베이스 노드에 바로 쓸 수 있습니다.

실행할 때마다 키워드당 검색 한 번이므로, 하루 50개 키워드는 한 달에 약 1,500 크레딧을 사용합니다. 검색 25,000회 팩(US$18.75)이면 이를 열 배 이상 커버하며, 선불 검색 크레딧은 만료되지 않습니다: 사용하지 않은 검색은 사용할 때까지 계정에 남아 있습니다.

n8n 밖에서 요청을 어떻게 테스트하나요?

터미널에서 같은 요청을 실행하세요. 거기서 된다면 n8n의 문제는 노드 설정에서 비롯된 것이고, 실패한다면 오류 응답 본문에 원인이 나옵니다(errors 페이지에 정리된 대로). 오류는 청구되지 않습니다.

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'