파이썬 기반 구글 제미나이 X 노션 API 연동, 자동화의 기초 환경 설정
- 목표 : 노션 토큰 비번, 노션 데이터베이스로 활용할 32자리 ID
- 용도 : 파이썬으로 자동 수집한 투자 데이터(DART 공시, 텔레그램 뉴스)를 내 노션 페이지에 실시간으로 전송 및 자동 기록하기 위함이다.
토큰, API, 데이터베이스 ID 용어 정리
여기서 용어를 정리하고 가자. 쌩초보이고, 제미나이를 이용해 시도하므로 이 과정을 해보고 나니 조금은 알겠다.
** API 연동
제미나이와 노션을 연동하기 위해서는, 파이썬 코드를 통해 '노션 API'와 데이터를 주고받는 과정이 필요하다.
** 노션 토큰
'토큰' 이라는 것은 비밀번호와 비슷한 맥락이라고 보면 된다. 노션의 내 통합(My Integrations)' 관리 화면으로 이동해 토큰을 만들고, 파이썬(DART/텔레그램)과 노션을 연결할 때 비밀번호처럼 사용한다.
** 노션 데이터베이스로 활용할 32자리 ID
제미나이가 코드를 이용해 자동으로 자료를 전송해 기록할 때 정확히 노션의 어느 페이지에 기록할 것인지 좌표를 알려줘야 한다. 이 좌표라는 게 데이터베이스 ID로 불리는 것 같은데 그리 어려운 개념은 아니다. 노션의 해당 페이지 상단 주소창의 32자리 문자+숫자를 말한다.
노션 AI 플러스 월 구독의 불필요?
왼쪽 메뉴 -> 설정 -> 요금제 살펴보기 -> 플러스 매월 16800원 결제
위 과정으로 노션 월 결제를 했는데, 이건 노션 안에서 사용하는 AI인가보다. 노션의 제미나이를 사용한다고 해서 결제를 덤벙대고 해버렸는데 내가 지금 사용하는 구글 제미나이와 노션의 제미나이는 별개이다. 이미 구글 제미나이에서 대화량이 쌓여있는데 두 개가 연동이 되지 않는다면 무쓸모 아닐까? 결제를 했으나 몇 일 동안 사용할 일이 없음이 확인이 되어 환불요청을 해버렸다.
자! 이제 노션 토큰부터 만들어보자.
1. 노션 토큰 만들기
(1) 왼쪽 메뉴 하단 '설정' ➡ 왼쪽 메뉴 '연결' 클릭 ➡ '↗ 연결 개발 또는 관리' 클릭한다.
(2) '새 API 통합 만들기' 클릭 ➡ 'API 통합 이름' 입력 ➡ Installable in 아래 나의 '아이디' 선택 ➡ 우측 하단 파란 '생성하기' 버튼 클릭 ➡ 'API 통합이 생성되었습니다.' 라는 팝업창이 뜨면 아래 버튼 'API 통합 설정 구성' 클릭한다.
(3) '액세스 토큰 설치' 에서 '표시하기'를 클릭해 보이는 문자들을 복사해 안전한 곳에 붙여넣기 하여 저장, 보관해둔다.
(4) '콘텐츠 기능' 설정 : ✅ 콘텐츠 읽기, 콘텐츠 업데이트, 콘텐츠 입력, 이메일 주소를 포함하는 사용자 정보를 읽습니다. 이 부분을 체크 클릭한다.
(5) 왼쪽 하단 파란 '저장' 버튼 클릭한다.
- 이 페이지의 상단에 **구성 페이지에서 'API 통합은 아직 어떤 페이지에도 접근할 수 없습니다 API 통합을 사용하려면 에서 페이지와 데이터베이스를 추가하세요.' ⇾ 이런 문구가 보여도 상관없다.
- 왼쪽 메뉴에서 구축 아래 '내부 API 통합'을 클릭하면 어떤 워크스페이스가 만들어져있는지 확인가능하고, 여기서 관리와 삭제가 가능하다.
(6) 노션 페이지에 만든 API를 연결하자.
먼저 알아야 할 사항 : 페이지마다 API를 연결해야 하는 번거로움을 줄이고 싶다면 부모(상위) 페이지를 하나 만들고 여기에 하위 페이지를 나열해 놓고, 부모(상위) 페이지에 한 번만 연결해두면 된다.
적용할 노션 페이지 클릭 ➡ 우측 상단 '점 3개' 클릭 ➡ '연결' 클릭 ➡ 방금 만든 API 이름을 선택한다. 이렇게 하면 내가 적용하고 싶은 노션의 페이지에 적용이 된 것이다.
2. 노션 부모페이지에 자동 수신받을 표 만들기
용도 : 노션에서 하위페이지가 많은 경우 하위 페이지의 데이터베이스 아이디를 모두 관리하지 못한다. 그래서 데이터를 한 곳으로 수신할 수 있는 노션의 저장소가 필요하다.
그래서 부모 페이지에 표를 만들어 내용이 자동 수신되는지 확인해볼 생각이다. 하위페이지가 여러 개인데 이 문제는 사용해보면서 살펴봐야겠다.
(7) 노션에서 부모 페이지를 연다.
(8) '/표' ➡ '표보기, 데이터베이스'를 선택한다.
(9) 표 제목을 만든다. (나의 경우 자동 데이터 수신)
(10) 종목명, 날짜 (날짜), 출처 (다중선택), 출처 (URL) ⇾ 이렇게 칸을 만든다.
* (2)번 보충 설명 : 단순 표는 API로 데이터를 보낼 수 없기 때문에 '데이터베이스-인라인'이 적용된 표여야 한다.
3. 노션 데이터베이스 ID 알기
(11) API를 연결할 노션 페이지를 연다. (글이 써지길 원하는 노션 페이지)
(12) 브라우저 상단 주소창을 확인한다.
https://www.notion.so/ ➡ 여기 뒤에 붙는 32자리 영문+숫자 조합(데이터베이스 ID)을 안전한 곳에 복사해둔다.
4. 파이썬 설치 및 기본 환경 테스트
(13) 아래부터는 파이썬을 사용해야 하는데 나의 경우 잘 안되어서 파이썬을 다시 새로 다운로드 받아 설치했다. 설치 페이지는 아래 링크와 같다.
(14) 메인 페이지에 'Window용 최신 버전을 다운로드 하세요(Download the latest version for Windows)' 아래 'Pathon 설치자 다운로드(Download Python install manager)' 버튼을 클릭해 설치 파일을 다운로드 받는다.
(15) 다운로드 받아 설치를 하면 검은색 창이 하나 뜬다.
(16) 여기에 아래 문장이 나오는데. Y를 입력 후 엔터를 누른다.
If the items are already enabled, you may need to disable and re-enable them.
Open Settings now, so you can modify App execution aliases? [y/N] Y
(17) '앱 > 고급 앱 설정' 창이 열린다.
(18) '앱 실행 별칭' 부분을 클릭한다. 아래처럼 7가지 파이썬 관련 이름들이 나오는데 모두 켬 상태로 만들어 놓는다. 나의 경우는 아래 밑줄 친 두개가 끔으로 되어 있어서 켬으로 수정해놓았다.
Python (default windowed) ➡ 켬
Python (default) ➡ 켬
Python (default) ➡ 켬
Python install manager ➡ 켬
Python install manager ➡ 켬
Python install manager (windowed) ➡ 켬
Python install manager (windowed) ➡ 켬
파이썬 설치 확인
(20) 우선 파이썬 설치가 잘 되었는지 확인해보자. 아래 명령어를 복사해 붙여넣기 한다.
py --version
Python 3.14.5 ➡ 이렇게 맨 아랫줄에 버전 숫자가 한 줄로 출력되면 성공이다.
파이썬 PATH 확인 : 위치 확인
(21) 파이썬이 설치된 위치를 확인해보는 과정이다. 아래 코드를 복사해 붙여넣기 후 엔터를 누른다.
where py
C:\Users\사용자이\AppData\Local\Microsoft\WindowsApps\py.exe ⇾ 성공이다.
5. 노션연동 위한 라이브러리 설치, 외부통신 연결 확인
노션 연동 필수 라이브러리(requests) 설치
(22) 아래 코드를 복사해 붙여넣기 후 엔터를 누른다.
py -m pip install requests
마지막 즈음에 Successfully installed..라고 나와 있으면 ⇾ 성공이다.
외부 통신 테스트 (네이버 연결 확인)
(23) 아래 코드를 복사해 붙여넣기 후 엔터를 누른다.
py -c "import requests; print('통신 테스트 성공! 네이버 응답 코드:', requests.get('https://finance.naver.com').status_code)"
통신 테스트 성공! 네이버 응답 코드: 200 ⇾ 성공이다.
글이 명료하지 않을 수 있다. 아무것도 모르는 상태에서 막무가내로 제미나이에게 물어보면서 하다 보니 그렇다. 위 사항들의 기반을 만들어놨으니 내가 원하는 것을 적용해보는 과정도 추후 남겨야겠다.
#파이썬노션연동 #노션API토큰만들기 #노션데이터베이스ID확인 #DART공시자동화 #텔레그램뉴스수집 #노션투자노트 #파이썬입문 #주식자동매매시스템 #노션표만들기
댓글
댓글 쓰기