Google 스프레드시트로 ISBN 검색이 되는 독서 기록장 만들기

Piotr Grudzień
게시일 읽는 시간 약 7분
Google 스프레드시트에서 끝낸 Pride and Prejudice 행 옆에 그 메모를 기억해 답한 Quickchat AI 응답이 보입니다.

Pride and Prejudice를 다 읽었을 때 뭐라고 적으셨나요? 이 독서 기록장에서는 그 답이 “I kept noticing who misunderstood whom.” (누가 누구를 오해하는지가 자꾸 눈에 들어왔다)입니다. 이 문장은 Penguin 페이퍼백판, ISBN 9780141439518에 대한 기록으로 11월 8일에 완독했습니다. 새 채팅을 열어도 그 문장은 그대로 남아 있습니다.

이제 Google 스프레드시트의 비공개 독서 기록장 Shelf Notes를 만듭니다. Open Library가 판본 정보를 제공하고, 날짜와 남겨 두고 싶은 생각은 사용자가 직접 입력하면, Quickchat AI Agent가 확인 후 이를 같은 행에 기록합니다.

Google 스프레드시트의 끝낸 PAP-01 항목과 새 Quickchat AI 채팅에 표시된 독자의 정확한 메모.
Events 탭에는 PAP-01 항목이 두 개 있습니다. 두 번째 항목에는 11월 8일의 메모가 들어 있습니다. 새 Quickchat AI 채팅이 시트를 읽고 같은 문장을 돌려줍니다.

Shelf Notes 스타터 키트 다운로드. 완성된 예시는 Shelf Notes.xlsx에서 확인하세요. 두 개의 TSV 파일로 Google 스프레드시트에 나만의 독서 기록장을 만들 수 있습니다. 시작 시점은 한 항목 앞선 상태, 즉 아직 독서 중인 시점입니다. 키트에는 정확한 Action 설정과 Main Prompt도 들어 있습니다.

1. 책장에 있는 책은 어떤 판본인가요?

무언가를 연결하기 전에 먼저 조회해 보세요. ISBN 9780141439518의 판본을 여세요. 이것은 2003년에 Penguin Books에서 출판한 435쪽짜리 영문 페이퍼백입니다. 제인 오스틴의 이 소설은 처음 1813년에 출간되었습니다. 두 날짜 모두 Pride and Prejudice에 해당하지만, 책상 위 그 책을 설명하는 날짜는 하나뿐입니다.

Open Library 판 페이지와 같은 Penguin 페이퍼백에 대해 Shelf Notes가 Inbox에서 제안한 내용입니다.
Open Library에서 Penguin 페이퍼백을 찾은 다음, 저장하기 전에 Quickchat AI 제안에서 출판사와 출판 연도를 확인하세요.
  1. Quickchat AI 계정을 만들거나 로그인하세요. 비어 있는 Agent를 사용하거나 Add new AI Agent → Set up manually를 선택합니다. 이름은 Shelf Notes로 지정하세요. 기록장을 만들려면 Google 계정이 필요하고, 대화를 테스트하려면 사용 가능한 AI 크레딧이 있어야 합니다.
  2. 개인 메모를 추가하기 전에 Your Website → Install → Availability and access을 여세요. Widget & Embed access를 끄고 Chat Page Access를 Nobody로 설정한 뒤, 다른 채널은 연결하지 않은 상태로 둡니다. 로그인한 대시보드에서는 AI Preview를 사용하세요.
  3. Identity → Main Prompt 아래에 키트의 main-prompt.txt를 붙여 넣으세요. 이 프롬프트는 Agent가 제안된 항목을 먼저 보여주고, 별도의 확인을 기다리도록 지시합니다.
  4. Actions & MCPs → Add Action → API Action → Create manually에서 아래의 GET Action 두 개를 만드세요. 각 Action에서 When to run → AI decides를 사용하고, What to ask the user first 아래에 이름이 isbn인 필수 Text 파라미터를 하나 추가한 뒤, 본문은 비워 두세요. 번호에서는 공백과 하이픈을 제거하되, 맨 앞의 0과 ISBN-10 끝자리의 X는 유지합니다.
액션 이름API 엔드포인트결과에서 사용할 값
lookup_book_isbnhttps://openlibrary.org/search.jsonQuery Params에 isbn={{isbn}}, fields=key,title,author_name,first_publish_year, limit=1를 입력하세요. 이 작품 정보는 저자와 소설의 원래 출간 연도를 제공합니다.
lookup_editionhttps://openlibrary.org/isbn/{{isbn}}.json입력한 번호가 isbn_13 또는 isbn_10에 나타나는지 확인하세요. 있으면 출판사, 판본의 출간일, 언어를 읽어옵니다. 반환된 /books/ 키를 https://openlibrary.org에 이어 붙여 출처 링크를 만드세요.

Quickchat AI 액션 편집기에서 ISBN 파라미터와 Open Library 요청이 보이는 모습. 대화에 ISBN을 입력하세요. Action이 편집기에서 호스트가 고정된 URL에 이 값을 넣습니다.

첫 번째 검색에서는 작품의 판본 목록도 함께 요청했습니다. 이 ISBN 하나에 대해 판본 ID 4,042개가 돌아왔습니다. 그 필드를 빼니 저자와 원래 출간 연도만 담긴 짧은 응답이 남았습니다. 두 번째 요청에서도 우리가 원한 종이표지본 한 권은 그대로 반환되었습니다.

Headers에서 각 요청에 User-Agent를 ShelfNotes/1.0 (YOUR_CONTACT_EMAIL)으로 지정하고, 예시 연락처는 자신의 것으로 바꾸세요. action-recipes.md의 해당 API Action Description를 붙여 넣고 각 Action을 저장한 뒤 활성화하세요. “Look up ISBN 978-0-14-143951-8.”로 시험해 보세요. 독서 기록장 항목을 만들지 않아도 해당 판본이 보여야 합니다. 이 개인 조회에는 Open Library 계정이 필요하지 않습니다. 누군가 책에 대해 물을 때 이 기능을 사용하고, Open Library API 사용 지침도 따르세요.

2. 독서 기록장에는 무엇을 넣어야 할까요?

서지 정보와 자신의 관찰은 열을 나눠 따로 보관하세요. 이 정확한 판본을 누군가에게 빌려줄 수는 있지만, 등장인물에 대한 의견은 전부 다를 수 있습니다. ISBN은 그대로입니다. 메모는 자신의 독서에 속하며, 여기서는 PAP-01로 식별합니다.

  1. Actions & MCPs → Add Action → Google Sheets → Connect을 여세요. 독서 기록장을 소유할 Google 계정을 승인한 다음 Open sheet를 선택하세요. 이 연결은 drive.file 권한으로 Drive에 스프레드시트를 만듭니다. Google Sheets 연결 안내에서 승인 화면을 볼 수 있습니다. 개인 독서 일지라면 Google 스프레드시트에서 공유를 열고 일반 액세스를 제한됨으로 두세요.
  2. 활성화된 시작용 Action log_lead_to_google_sheet을 꺼 두세요. 이름은 그대로 유지하고, 이미 파일 ID가 채워져 있는 API Endpoint를 복사해 두세요. 시작용 Action은 꺼 둔 채로 두세요. 이 독서 기록장에는 별도의 Action을 만들 예정입니다.

Quickchat AI의 Google 스프레드시트 연결 화면과 Quickchat AI에서 사용할 계정을 고르는 Google 화면. 이 Agent용으로 만들어진 파일을 여세요. 시작용 Action에 필요한 스프레드시트 ID가 이미 들어 있습니다.

  1. Leads 탭 이름을 Events로 바꾸고, 내용을 A1부터 시작해 Events.tsv로 교체하세요. 붙여넣기 전에 B(ISBN) 열과 F(date) 열 서식을 Plain text로 지정하세요. Status라는 두 번째 탭도 추가하세요. 새 예시 시트에서는 아래 수식이 쉼표를 받도록 File → Settings → Locale → United States를 사용하세요.

Google 스프레드시트의 Shelf Notes Events 탭에 Pride and Prejudice의 첫 항목이 있고, 옆에 Status 탭이 보입니다. 2행에서 시작하세요. PAP-01은 아직 읽는 중이며 G2에는 “Started with the Netherfield visit.”가 있습니다. 확인하면 끝낸 항목이 3행에 나타납니다.

Events의 8개 열은 순서대로 reading_id, isbn, title, edition_url, status, reading_date, note, conversation입니다. 마지막 열에는 대화로 돌아가는 링크가 들어 있습니다. 시작용 데이터의 첫 번째 이벤트 상태는 11월 2일의 reading입니다. 메모는 “Started with the Netherfield visit.”입니다.

독서 기록장 행이 서지 필드, 독자 필드, 대화 링크로 나뉘어 있는 모습. 한 권의 상태가 reading에서 finished로 바뀌는 동안에는 같은 독서 ID를 유지하세요. 다시 읽으려고 그 책으로 돌아올 때는 새 ID를 선택하세요.

3. ISBN으로 독서 메모를 어떻게 저장할까요?

조회는 “어떤 책인가요?”에 답합니다. 저장은 “내가 기억하고 싶은 내용이 이것인가요?”라는 다른 질문에 답합니다. 확인된 행을 추가하는 Action 하나와, 스프레드시트에 실제로 무엇이 들어 있는지 확인하는 Action 하나를 설정하세요.

  1. API Action을 만들어 이름을 append_reading_event로 지정하세요. 시작용 Action의 Sheets URL을 복사하되, 실제 파일 ID까지는 그대로 유지하세요. 그 뒤 나머지는 /values/Events!A:H:append로 바꾸세요. POST를 설정하고 Query Params 항목 valueInputOption=RAW을 추가하세요. 원시 입력 모드는 ISBN을 그대로 보존하고, =로 시작하는 메모도 텍스트로 처리합니다.
  2. Headers에서 Authorization는 Bearer {{google_sheets_access_token}}으로, Content-Type는 application/json로 설정하세요. 요청 시점에 Quickchat AI가 토큰을 채워 넣습니다.
  3. 필수 Text 파라미터 6개를 추가하고 이름은 각각 reading_id, isbn, title, edition_url, status, reading_date로 지정하세요. 선택 사항인 Text 파라미터 하나도 추가하고 이름은 note로, 기본값은 빈칸으로 두세요. status에는 reading, finished, paused, abandoned 중 하나를 선택하세요. 독서 날짜는 YYYY-MM-DD 형식으로 사용합니다.
  4. API Endpoint → Body에 아래 JSON을 붙여 넣으세요. 대괄호가 두 겹인 것은 셀 8개로 이루어진 행 1개를 뜻합니다. conversation_url는 기본 제공됩니다. 키트의 append 설명을 API Action Description에 붙여 넣으세요.
  5. 같은 스프레드시트를 대상으로 read_reading_journal를 GET으로 만들고, 끝 경로는 /values/Events!A2:H1000로 설정합니다. bearer 헤더는 앞과 동일하게 두고, 키트의 history 설명을 붙여 넣고, parameters는 비워 두고, body도 빈 상태로 둡니다. 저장한 뒤 두 Action을 모두 활성화합니다.
{
  "values": [[
    "{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
    "{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
  ]]
}

append Action의 RAW input 설정과 JSON body 안의 여덟 개 셀. 이 배열은 A열부터 H열까지에 맞춰집니다. 메모를 일곱 번째 위치에 두면 독자의 문장이 G열에 들어갑니다.

시작 행을 넣었으면 AI Preview에서 다음 메시지를 보냅니다.

Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.

제안된 판본, ID, 날짜, 문장부호를 확인합니다. 이 시점에는 Events에 아직 첫 항목만 들어 있어야 합니다. 그런 다음 “Yes, that is my edition. Save PAP-01 with that status, date and note.”라고 말합니다. 그러면 두 번째 이벤트가 3행에 나타나야 합니다.

Shelf Notes가 판본, 날짜, 메모를 보여 주고 저장해도 되는지 묻습니다. 이 제안 단계에서 ISBN과 작성한 문장을 마지막으로 한 번 더 확인할 수 있습니다. 독서 기록장이 바뀌기 전에 둘 중 어느 쪽이든 수정할 수 있습니다.

실제 실행에서는 제안된 항목이 첫 행을 그대로 두었습니다. 확인 후 Shelf Notes는 기록장을 확인하고, ISBN을 다시 확인한 뒤 행을 한 번만 추가하고 새 행을 다시 읽어 확인했습니다. Inbox에서 append_reading_event를 펼치고 Google의 updates.updatedRange를 내 시트의 셀과 비교하세요. 요청 시간이 초과되면 다시 시도하기 전에 행이 생겼는지 먼저 확인하세요. Google Sheets 행 추가 참고 자료

Quickchat AI가 행을 성공적으로 추가했고 Google 스프레드시트 G3 셀에 확정된 독서 메모가 보입니다. Google은 Events!A3:H3에서 행 1개와 셀 8개가 업데이트되었다고 보고했습니다. G3를 선택해 그 텍스트를 승인한 메모와 비교하세요.

4. 새 대화에서는 무엇을 물어볼 수 있나요?

AI Preview에서 새 대화를 열고 “What was the last note I saved for PAP-01?”라고 요청하세요. 테스트에서 Agent는 Events를 다시 읽고 “I kept noticing who misunderstood whom.”를 돌려주었습니다. 2행에는 앞서 저장한 Netherfield 메모가 그대로 들어 있습니다. Google은 반환된 행의 끝에 있는 빈 셀을 생략할 수 있으므로, 시작 행의 대화 링크가 비어 있어도 정상입니다.

“Which books am I still reading?” 같은 질문에서는, 한 번의 독서에 이벤트가 두 개 있으면 각 행을 그대로 세었을 때 오해를 부르는 답이 나올 수 있습니다. Status 탭을 사용해 각 독서 ID별로 마지막으로 추가된 이벤트를 선택하세요.

  1. Status.tsv를 Status!A1에 붙여 넣습니다. A2의 수식은 각 독서 ID를 한 번씩만 나열합니다. B2는 Events의 아래쪽부터 시작하는 exact-match lookup을 사용합니다. 책 목록이 늘어나 새 ID가 생기면 B2를 아래로 채워 넣으세요. D2는 최신 상태가 finished인 ID 수를 셉니다.
  2. read_reading_status를 만듭니다. 같은 bearer 헤더를 쓰는 또 다른 GET이며, suffix는 /values/Status!A1:B1000를 사용합니다. 키트의 상태 설명을 붙여 넣고, 본문과 매개변수는 비워 둔 뒤 저장하고 활성화합니다.
  3. 완독한 책이 무엇인지 물어보세요. 이 예시에서는 Status에 완독한 독서가 하나 있고, 그것은 PAP-01입니다. 같은 소설을 두 번째로 읽을 때는 PAP-02를 부여하세요. 그러면 첫 번째에 눈에 띈 점과 두 번째에 눈에 띈 점을 구분할 수 있습니다.
Google 스프레드시트의 Status 탭에서 상태가 reading에서 finished로 바뀌고, 완독 횟수는 0회에서 1회가 됩니다. 새 채팅에서도 Shelf Notes는 finished라고 답합니다.
Status!B2에는 finished가 표시되고 D2는 독서 1건을 셉니다. 날짜가 지난 항목도 Events에는 추가된 순서대로 두세요. 필터 뷰로 살펴보세요.
Google 스프레드시트 수식 세 개 복사하기

Status!A2는 ID 목록을 나열합니다.

=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)

Status!B2는 A열의 ID에 대한 가장 최근 이벤트를 조회합니다.

=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))

Status!D2는 완독한 독서 수를 셉니다.

=COUNTIF(B2:B1000,"finished")

이 구성은 999개 이벤트까지 다룹니다. 새 항목이 1000행 아래로 들어가기 전에 읽기 범위와 수식 범위를 함께 늘리세요. 한 번의 대화에서 얼마나 많은 이력을 반환할지 정할 때는 긴 메모와 많은 책 수를 함께 고려해야 합니다. Google 스프레드시트 XLOOKUP 참고 문서

5. 책상 위에 있는 책으로도 작동하나요?

다른 책을 한 권 집어 들고 인쇄된 ISBN으로 시험해 보세요. 먼저 판본을 물어보고, 거기서 멈춥니다. 책을 추가하지 않고도 조회할 수 있는지가 첫 번째로 확인할 만한 지점입니다. 다음으로 독서 ID를 붙이고, 오직 본인만 쓸 수 있는 문장을 하나 적으세요. 이를 확인한 뒤 대화를 닫고 새로 시작해서, 그 문장을 다시 불러와 달라고 해 보세요.

반복 가능한 점검을 하려면 Testing → Simulation을 사용한 다음 Actions & MCPs → View logs와 대상 셀을 확인하세요. 인식되지 않는 ISBN을 넣어 보고, 제안된 항목을 거절한 뒤, =1+1로 시작하는 테스트 메모를 저장해 보세요. 앞의 두 경우에는 기록이 그대로 유지되어야 합니다. 마지막 경우에는 메모 셀에 그 문자열이 문자 그대로 표시되어야 합니다.

또 로컬 시트가 행을 저장한 뒤 응답 전에 시간 초과되도록 설정해 보기도 했습니다. Shelf Notes는 그 행을 다시 읽어 와서 시간 초과를 보고했고, 두 번째로 추가하지는 않았습니다. 저장 후 다시 보내기를 눌러야 할지 헷갈릴 때가 있다면, Action 로그에서도 같은 내용을 확인할 수 있습니다.

Open Library가 판본을 찾지 못했다고 반환하고 Shelf Notes가 독자에게 ISBN을 확인하라고 요청합니다. 없는 판본 테스트에서는 카탈로그가 404를 반환했습니다. Agent는 다른 식별자를 요청했고, 독서 기록장에는 두 행이 그대로 유지되었습니다.

다른 어시스턴트에서 Agent를 설정하고 싶다면, 키트에 Quickchat AI 계정 커넥터용 설정 요청이 들어 있습니다. action-recipes.md와 main-prompt.txt를 첨부한 뒤 setup-request.txt를 전달하세요. Action 5개를 검토하고, Google 인증은 직접 완료한 다음, 같은 독서 테스트를 실행해 보세요. ChatGPT 커넥터 · Claude 커넥터 · 계정 설정 가이드

자주 묻는 질문

ISBN으로 Google 스프레드시트에 책을 추가하려면 어떻게 하나요?

가지고 있는 책에 인쇄된 ISBN으로 Open Library에서 해당 판본을 조회하세요. 제목, 출판사, 연도를 확인하고 읽기 상태와 메모를 추가한 뒤 행을 확인합니다. 스타터 키트에는 시트 헤더, 수식, 그리고 다섯 가지 Quickchat AI Action 레시피가 모두 들어 있습니다.

이미 Google 스프레드시트에 있는 독서 기록장을 써도 되나요?

옮기고 싶은 항목을 Quickchat AI 연결이 만든 스프레드시트의 Events 탭에 복사하세요. 여덟 개 열을 맞추고 ISBN은 텍스트로 유지합니다. 다른 비공개 파일의 ID를 Action에 붙여 넣어도 그 파일을 열 권한이 생기지는 않습니다.

Open Library에서 내 ISBN을 찾지 못하면 어떻게 하나요?

바코드나 저작권 페이지에 있는 번호를 확인하세요. 앞의 0이나 마지막 X가 있으면 그것까지 포함합니다. 그래도 판본을 확인할 수 없으면 독서 기록장은 그대로 두세요. ISBN은 판본을 식별하는 번호일 뿐, 책 전문에 접근할 권한을 주지는 않습니다.

완독한 책 수를 세고 재독도 추적하려면 어떻게 하나요?

각 독서에 고유 ID를 부여하세요. 책을 중단하거나 완독해도 그 ID를 유지하고, 재독에는 새 ID를 부여합니다. 완독 항목은 Status 탭에서 집계하세요. 그러면 같은 판본을 두 번 완독한 경우 두 번으로 집계되고, 한 번의 독서에 대한 두 번의 업데이트는 한 번으로 집계됩니다.

채팅을 닫은 뒤에도 독서 메모를 다시 찾을 수 있나요?

예. 새 비공개 채팅에서 책이나 독서 ID를 요청하세요. history Action이 Events 탭을 다시 읽어, 날짜가 있는 기록과 원래 작성한 문구를 가져옵니다. Status 탭은 각 독서의 가장 최근에 기록된 상태를 제공합니다.

Quickchat AI Quickchat AI Ask Quickchat AI a question