Are.na 채널 정리의 필요성
Are.na를 즐겨 쓰는데, 쓸수록 채널이 늘어나고 블록이 여기저기 흩어져서 "이게 어디 있더라"를 반복하게 됐어요. 11개 채널에 자료 60개가 뒤섞여 있었고, 비공개 자료도 많아서 손으로 하나씩 정리하기 너무 귀찮았습니다.
그래서 Claude Code한테 제 Are.na 계정에 직접 접근해서 분석하고, 채널 구조도 추천해주고, 블록 이동까지 대신 시키는 걸 시도해봤습니다.
Claude Code를 활용한 자동화 과정
사용 도구: Claude Code
1단계 — Are.na와 Claude 연결하기
Open optionsauto
are.na 연결하고 싶어이 한 마디로 시작했습니다. Claude가 Are.na와 통신하는 연결 도구를 알아서 만들고 설치까지 해줬어요. 저는 Are.na 설정 페이지에서 토큰(일종의 비밀번호)만 발급해서 붙여넣으면 됐습니다.
2단계 — 첫 번째 시행착오: 토큰이 맞는데 왜 안 되지?
연결은 됐는데 막상 제 채널 목록을 가져오려 하니까 계속 "권한 없음" 오류가 났습니다. 토큰을 새로 발급해봐도 똑같았고요.
알고 보니 Are.na가 예전 방식(v2)에서 새 방식(v3)으로 API를 바꾸는 중이었는데, Claude가 만든 도구가 예전 방식 기준이었던 거였어요. Are.na 공식 개발자 문서를 복사해서 Claude한테 붙여줬더니 새 방식으로 바꿔서 바로 해결됐습니다.
3단계 — 내 자료 전체 분석 + 정리 추천받기
Open optionsauto
내 채널 블록을 다 읽고 어떻게 카테고리화 시킬지 추천해줘Claude가 제 채널 11개, 자료 60개를 전부 읽고 제목과 내용을 분석해서 이렇게 묶으면 어떻겠냐고 제안해줬어요.
4단계 — 블록 이동 시 두 번째 삽질
Open optionsauto
네가 제시해준대로 채널 바꾸고 블록 다 분류해서 옮겨줘블록을 새 채널에 연결하는 API 엔드포인트를 찾는 게 문제였습니다. POST /channels/:slug/contents는 405, v2 방식도 410(Gone). 공식 문서 탐색을 거쳐 POST /v3/connections에 channel_ids 배열로 넘겨야 한다는 걸 발견했고, 그제야 201이 떴습니다.
자동화 후의 결과와 배운 점
배운 점:
Are.na처럼 API가 마이그레이션 중인 서비스는 버전 번호를 먼저 확인해야 합니다. v2/v3 혼용이 생각보다 조용하게 실패합니다
"401인데 토큰이 맞다" 싶으면 엔드포인트 버전 문제일 가능성이 높습니다
막힐 때 공식 문서를 통째로 붙여넣는 게 제일 빠른 해결책이었습니다👍
앞으로의 계획:
brain dump 채널에 쌓인 블록을 주기적으로 다른 채널로 자동 분류하는 스크립트를 MCP에 추가해볼 예정입니다.😀
