[n8n] 한글 주소 영문 변환기 표준 워크플로우 JSON | 가나투데이

지금까지 설계한 [한글 주소 → 영문 변환 에이전트]의 내부 로직을 완벽하게 구현한 n8n JSON 코드를 생성해 드립니다. 이 코드는 데이터 정제, AI 변환(구조화된 출력), 그리고 최종 시트 업데이트로 이어지는 표준 아키텍처를 따르고 있습니다.

아래 코드를 복사하여 n8n 빈 화면에 Ctrl + V로 붙여넣으세요.

JSON

{
  "nodes": [
    {
      "parameters": {
        "pollTimes": {
          "item": [
            {
              "mode": "everyMinute"
            }
          ]
        },
        "documentId": {
          "__rl": true,
          "mode": "id"
        },
        "sheetName": {
          "__rl": true,
          "mode": "name"
        },
        "options": {}
      },
      "id": "trigger-google-sheets",
      "name": "Google Sheets Trigger",
      "type": "n8n-nodes-base.googleSheetsTrigger",
      "typeVersion": 1,
      "position": [400, 300]
    },
    {
      "parameters": {
        "fields": {
          "values": [
            {
              "name": "korean_address",
              "stringValue": "={{ $json.주소 }}"
            }
          ]
        },
        "options": {}
      },
      "id": "data-refinement",
      "name": "Data Refinement",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3,
      "position": [620, 300]
    },
    {
      "parameters": {
        "model": "gpt-4o",
        "prompt": {
          "messages": [
            {
              "content": "=당신은 주소 변환 전문가입니다. 다음 한글 주소를 대한민국 도로명 주소 체계에 맞는 영문 주소로 변환하세요.\n\n한글 주소: {{ $json.korean_address }}\n\n반드시 영문 주소 문자열만 응답하세요."
            }
          ]
        }
      },
      "id": "ai-translation",
      "name": "AI Address Translator",
      "type": "n8n-nodes-base.openAi",
      "typeVersion": 1,
      "position": [840, 300],
      "credentials": {
        "openAiApi": {
          "id": "YOUR_OPENAI_CREDENTIAL_ID",
          "name": "OpenAI account"
        }
      }
    },
    {
      "parameters": {
        "operation": "update",
        "documentId": {
          "__rl": true,
          "mode": "id"
        },
        "sheetName": {
          "__rl": true,
          "mode": "name"
        },
        "columns": {
          "mappingMode": "defineBelow",
          "value": [
            {
              "column": "영문주소",
              "value": "={{ $json.message.content }}"
            }
          ]
        }
      },
      "id": "sheet-update",
      "name": "Update Sheet",
      "type": "n8n-nodes-base.googleSheets",
      "typeVersion": 4,
      "position": [1060, 300]
    }
  ],
  "connections": {
    "Google Sheets Trigger": {
      "main": [
        [
          {
            "node": "Data Refinement",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Data Refinement": {
      "main": [
        [
          {
            "node": "ai-translation",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "ai-translation": {
      "main": [
        [
          {
            "node": "sheet-update",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

---

코드를 적용할 때 우리가 꼭 챙겨야 할 포인트 (꼼꼼히!)

1. AI 노드 선택: 위 코드는 OpenAI를 기준으로 작성되었지만, n8n에서 제공하는 Gemini 노드나 Anthropic 노드로 교체해서 사용해도 로직은 동일합니다.

2. 데이터 이름표(Mapping): 구글 시트의 한글 주소가 들어있는 열 이름이 주소가 맞는지 확인하세요. 만약 도로명주소라면 Data Refinement 노드에서 매핑을 수정해야 합니다.

3. 영문 주소 열 생성: 구글 시트에 미리 영문주소라는 이름의 빈 열(Column)을 만들어 두어야 에이전트가 결과를 정확히 배달할 수 있습니다.

4. Credential: 각 노드에서 본인의 Google 계정과 AI API 키를 연결하는 루틴을 잊지 마세요!

#가나 투데이 #ganatoday

그린아프로