가이드

JSON Parser (JSON 파서) 노드 가이드

작성일 2026.03.20 | 수정일 2026.03.20

JSON Parser (JSON 파서) 노드 가이드

문자열 형태의 JSON 데이터를 파싱하여 사용 가능한 JSON 객체로 변환하는 노드입니다. AI 모델의 응답이나 외부 API에서 받은 JSON 문자열을 후속 노드에서 활용할 수 있도록 구조화합니다.

주요 기능

  • JSON 문자열을 JSON 객체로 파싱

  • 마크다운 코드 블록(```json ... ```) 자동 제거

  • 파싱 오류 시 계속 실행 옵션

설정 항목

필드

설명

기본값

JSON 문자열

파싱할 JSON 형식의 문자열. 표현식 사용 가능

(빈 값)

오류 시 계속

파싱 오류가 발생해도 워크플로우를 계속 실행할지 여부

false

사용 예시

AI 모델 응답 파싱

AI 모델이 JSON 형식의 텍스트를 반환했을 때 이를 파싱합니다.

입력 데이터:

{ "response": "{\"title\": \"제목\", \"summary\": \"요약 내용\"}" }

설정:

  • JSON 문자열: {{ $json.response }}

출력:

{ "title": "제목", "summary": "요약 내용" }

마크다운 코드 블록 자동 처리

AI 모델이 마크다운 코드 블록으로 감싸서 JSON을 반환하는 경우에도 자동으로 처리됩니다.

입력 (AI 응답):

```json
{ "name": "홍길동", "age": 30 }
```

코드 블록(```json ... ``` 또는 ``` ... ```)이 자동으로 제거된 후 내부 JSON이 파싱됩니다.

오류 시 계속 실행

불안정한 외부 소스의 데이터를 파싱할 때, 파싱 실패 시에도 워크플로우를 중단하지 않습니다.

설정:

  • 오류 시 계속: true

파싱 실패 시 출력:

{
  "error": "JSON 파싱 오류: Unexpected token ...",
  "originalString": "잘못된 JSON 문자열"
}

참고 사항

  • 빈 문자열이 입력되면 오류가 발생합니다. 오류 시 계속 옵션을 활성화하면 오류 메시지가 포함된 결과가 출력됩니다.

  • 마크다운 코드 블록 제거는 json 언어 지정자가 있는 경우와 없는 경우 모두 지원합니다.

  • AI 모델의 출력을 후속 노드에서 필드별로 접근하려면 이 노드로 먼저 파싱해야 합니다.

  • 이미 객체인 데이터는 이 노드를 사용할 필요가 없습니다. 문자열 형태의 JSON만 파싱 대상입니다.