Medium Digest

---
name: medium-digest
description: >
  Gmail의 Medium Daily Digest에서 아티클 목록을 결정론적으로 추출하고, 로그인된 Chrome
  (claude-in-chrome)으로 본문(member-only 포함)을 수집해 `private/medium/<date>/`에 저장한 뒤
  한국어 요약 → 총합 평가 → 클리핑 후보 추천까지 만든다. 사용자 승인분만 `Clippings/`로
  넘겨 기존 vault-ingest-claude가 이어받는다. 개인 읽기 파이프라인이라 1~5단계 산출은
  vault에 커밋하지 않는다.
origin: lemoncloud-io/knowledge@8480503:projects/second-brain/config/skills/medium-digest/SKILL.md
---

# medium-digest (Gmail Medium Daily Digest → 요약 → 승인 → Clippings)

## 언제 사용하는가

- 사용자가 "오늘 미디엄 정리해줘" / "메일링 온 아티클 요약해줘"라고 요청할 때
- Medium 아티클을 vault wiki로 넣고 싶은데 원문이 member-only라 Web Clipper·WebFetch로는 본문이
  안 잡힐 때

이 스킬은 **목록 추출 → 본문 수집 → 요약 → 추천 → (승인 후) Clippings 투입**까지 담당한다.
wiki 작성·raw 이동·PR은 하지 않는다 — `vault-ingest-claude`가 이어받는다.

## 전제 (실행 전 확인, 하나라도 없으면 즉시 보고하고 중단 — 자동 설치 금지)

| 도구 | 확인 | 비고 |
|---|---|---|
| workspace-mcp Gmail | `search_gmail_messages`·`get_gmail_message_content` 호출 가능 | 인증된 계정이 digest 수신자여야 한다 |
| claude-in-chrome | `list_connected_browsers`에 `isLocal: true` 브라우저 1개 이상 | Medium에 **로그인된** 사용자 Chrome. 본문의 유일한 경로다 |
| Node 24+ | `node --version` | 스크립트는 erasable TS(`.mts`), 의존성 0, `node <file>.mts`로 실행 |

**차단 실측(재시도 금지)**: WebFetch는 403, 비로그인 인앱 브라우저는 210단어 뒤 페이월. 이 두 경로로
member-only 본문을 얻으려는 시도는 하지 않는다.

## 디렉터리 계약

스크립트는 이 스킬 디렉터리에, 산출은 사용자 개인 공간에 둔다.

```
projects/second-brain/config/skills/medium-digest/
  SKILL.md
  scripts/parse-digest.mts     digest html → digest.json (결정론 파서)
  scripts/embed-images.mts     digest.html 이미지 인라인 임베딩(오프라인 열람판)

private/medium/<YYYY-MM-DD>/   ← gitignored(`private/`). 커밋 대상 아님
  digest.src.html              Gmail full export 원본 — embed 첫 실행 시 자동 보존
  digest.html                  열람판: 원격 이미지 → data URI, 트래킹 픽셀·외부 CSS 제거(≈1.5MB)
  digest.json                  파서 산출 (count, articles[n,title,subtitle,url,slug,author,handle,publication,member_only,read_min,claps,responses])
  bodies/NN-<slug>.md          본문(frontmatter + 정제 텍스트). NN = digest.json의 n(2자리)
  digest.md                    목록 표 + 요약 + 추천 (최종 산출)
  digest.part-<X>.md           병렬 실행 임시 파일 — 병합 후 삭제
```

## 절차

### 1. 메일 확보
- `search_gmail_messages(query="from:noreply@medium.com newer_than:1d", include_headers=true)`.
  From 이름이 **"Medium Daily Digest"**인 것만 대상(`newsletters@medium.com`·Medium Events 제외).
  0건이면 "오늘 digest 미도착"으로 보고하고 종료(발송은 22:50 UTC, KST 07:50경).
- `get_gmail_message_content(message_id, body_format="html", full=true)` → 응답의 "Saved to:" 파일을
  `<date>/digest.html`로 복사. **text 포맷은 쓰지 않는다** — 아티클 링크가 없다(프로필 링크만, 제목 절단).

### 2. 목록 추출 (결정론 — 모델이 링크를 손으로 옮기지 않는다)
```bash
node projects/second-brain/config/skills/medium-digest/scripts/parse-digest.mts private/medium/<date>/digest.html private/medium/<date>/digest.json
```
- stderr `N articles (member-only K)`. N=0이면 html 구조 변경 → 중단·보고. 통상 N=15, N<10이면
  `full=true` 누락 의심 → 1단계 재확인.
- 링크는 `medium.com/@author/slug-<hexid>?source=…`, 전체 제목은 썸네일 `<img alt>`, member-only는
  `alt="Member-only content"`로 식별한다(파서가 처리).

### 2b. 열람판
```bash
node projects/second-brain/config/skills/medium-digest/scripts/embed-images.mts private/medium/<date>
```
첫 실행이 `digest.html`을 `digest.src.html`로 보존하고 임베딩판을 새로 쓴다. stderr `embedded K/K images` 확인.
사용자에게 보여줄 때는 이 파일을 보낸다(뷰어가 원격 이미지를 막아도 썸네일이 보인다).

### 3. 본문 수집 (Chrome)
- 브라우저가 2개 이상 연결돼 있으면 **`isLocal: true`**를 쓴다(서브에이전트는 사용자에게 묻지 못한다 —
  로컬 우선, 로컬이 둘이면 먼저 나온 것). `tabs_context_mcp(createIfEmpty=true)`로 탭 1개 확보.
- `browser_batch`로 아티클마다 `navigate(url)` → `computer(wait, 2초)` → `get_page_text(tabId)` 3연을 묶어
  실행. **wait 필수** — navigate 직후 곧바로 읽으면 직전 페이지(다른 아티클) 본문이 에러 없이 반환된다.
  반환 본문의 첫 제목이 요청 아티클과 일치하는지 반드시 대조한다.
- batch 크기: 3~5건. `read_min ≥ 10`인 글은 2건 이하(3건이면 응답이 60KB를 넘어 파일로 우회된다).
- 리다이렉트는 정상(`pub.towardsai.net`, `medium.com/<pub>/…`, `<handle>.medium.com`, 퍼블리케이션 자체 도메인).
- 페이월 판정: 본문 끝 2,500자에 `create an account` / `read the full story` / `members only`가 있거나
  단어수 < `read_min × 120`이면 불완전 → `status: partial`로 저장하고 보고. 완전 수집분은 `status` 필드를 쓰지 않는다.
- **정제 = 노이즈 제거만.** `Press enter or click to view image in full size` 줄·단독 `--` 줄·상단 태그 목록 제거,
  저자 소개·추천 글 꼬리는 `[… 절삭]`으로 절삭, 코드 블록은 ``` 보존, ASCII 표는 100줄 초과 시
  `[표 생략: 한 줄 요약]`. 어조·인칭·문장 순서는 바꾸지 않는다(1인칭 → "the author" 의역 금지).
- `bodies/NN-<slug>.md` frontmatter: digest, n, title, author, publication, url, resolved_url, member_only,
  published, read_min, words_measured, collected, cleaning. 빈 값은 명시적 `null`.
- 끝나면 `tabs_close_mcp`. 병렬 파트끼리 같은 Chrome 프로필을 쓰므로 "not in tab group" 에러는 정상 종료로 간주.

### 4. 요약 (`<date>/digest.md`)
frontmatter: `type: medium-digest`, `date`, `digest_message_id`, `articles`(N), `collected`(수집한 n 목록).
1. `## 목록` — 표: n · 제목(링크) · 작성자·퍼블리케이션 · M(member-only) · 분 · 수집 여부
2. `## 요약` — 수집한 건마다 `### NN. 제목 — 작성자 (M, 16m)` 아래
   - **요지** 3~5줄(한국어, 저자 주장 그대로, 평가 섞지 않음)
   - **핵심** 3개(각 1~2줄 상한 — 실행 가능한 사실·수치·명령을 골라낸다, 재서술 금지)
   - **관련성** `높음|중간|낮음` + 한 줄(이 vault의 어느 프로젝트·관행에 닿는지, 없으면 "없음")
   - **원문** url · **본문** `bodies/NN-<slug>.md`
3. `## 운영 메모` — partial·리다이렉트·소요 등 1~3줄

### 5. 총합 평가·추천 (상위 세션)
전 건 요약이 모이면 상위 세션이 한 번에 읽고 **클리핑 후보 최대 3건**을 고른다.
- 채점(각 0~2, 합 6): **유용성** — vault/프로젝트 작업에 바로 쓰이는 사실·절차·수치 · **창의성** — 기존
  wiki에 없는 관점(중복이면 0, `wiki/INDEX.md` 대조) · **근거** — 실측·코드·수치(선언·홍보·클릭베이트 0).
- 제외: 광고·수익 노하우류, 같은 주제 wiki 노트가 이미 `complete`인 것.
- `## 추천` 절: 채점표(전 건, **로컬 본문 링크 열** 포함) · 후보별 사유 · 로컬 원문 링크 + 원본 URL ·
  기대 wiki slug(신규/갱신) · 클리핑 형태(발췌판/전문) · 비추천 요약 1줄.
- **여기서 멈추고 사용자 승인을 요청한다.** 승인 없이 6단계로 넘어가지 않는다.

### 6. 클리핑 (승인된 건만)
- `bodies/NN-<slug>.md` → `Clippings/<정규화된 제목>.md`. 파일명은 이 시점에 `docs/raw-layout.md`
  § 파일명 정규화를 적용해 짓는다(`:` 등 금지 문자 제거, 공백 접기) — raw 이동 시 rename이 생기지 않는다.
- frontmatter는 **Web Clipper 표준 7키만**(`vault_verify` 계약, 추가 키 금지):
  `title`(원제) · `source`(리다이렉트 전 medium.com URL) · `author: ["[[<author>]]"]` · `published` ·
  `created`(오늘) · `description` · `tags: ["clippings", "medium-digest"]`.
  digest 출처는 본문 첫 인용 블록에 `Medium Daily Digest <date> #<n>` 한 줄로 표기한다.
- **member-only 원문은 발췌판이 기본.** Clippings→raw는 팀 repo에 커밋되므로 전문을 올리지 않고
  구조·주장·근거·사례를 정리한 발췌판(짧은 인용 ≤ 3)으로 만든다. 전문 보존은 사용자가 승인 시 명시할 때만.
  무료 아티클은 전문 가능.
- 여기서 git을 만지지 않는다 — 시작 커밋(`chore: stage N clippings for ingest`)은 ingest 스킬 몫.

### 7. Ingest 인계
- `vault-ingest-claude.md` 절차 그대로(`ingest/<date>-<author-slug>` 브랜치, wiki, run-log, verify, PR).
  머지는 사용자.
- run-log `Details`에 유입 레인이 medium-digest임과 발췌판 여부를 적는다. 완료 후 `digest.md` `## 추천`에
  PR 번호·생성/갱신 노트를 기록한다.

## 실행 모드

- **단일**: 소넷 1기가 1~4단계를 순차 수행. 15건 본문 ≈ 32k 단어(≈45k 토큰 입력), 한 세션에서 가능.
  부분 실행은 `--only 9,13`처럼 n 목록을 받아 해당 건만 3~4단계, `digest.md`가 있으면 `## 요약`에 **추가**.
- **병렬**: 소넷 2기에 n을 반씩 나눠 각자 `digest.part-A.md`/`digest.part-B.md`에 `###` 절만 쓰게 한다
  (`digest.md` 동시 편집 금지). 상위 세션이 n 오름차순으로 병합하고 파트 파일을 지운다. 병합 후 전건
  실측 대조: 파일 존재·단어수 vs `read_min×120`·페이월 문구·본문 첫 제목 = frontmatter 제목.
- Chrome MCP는 디스크에 직접 쓰지 못해 본문이 모델을 거친다(읽기+쓰기 ≈ 2배 토큰). 15건 병렬 실측:
  2기 합계 ≈ 327k 토큰, 12분.

## 하지 말 것

- 1~5단계 산출을 `raw/`·`Clippings/`·`wiki/`·`outputs/`에 쓰거나 git에 올리지 않는다.
- 링크·제목을 메일 text에서 손으로 옮기지 않는다 — 항상 파서 산출을 쓴다.
- 비로그인 경로(WebFetch, 인앱 브라우저)를 재시도하지 않는다.
- 5단계 추천을 승인 없이 6단계로 넘기지 않는다. 클리핑·ingest는 사용자 승인이 게이트.
- Clippings frontmatter에 표준 7키 외 필드를 추가하지 않는다.

## 검증 이력

- 2026-09-03: 15/15 파싱, Chrome 전건 전문 접근(member-only 13, 페이월 0). 소넷 서브에이전트 단일
  (`--only` 2건, 127k tok/6.8분)·병렬(2기, 12건, 327k tok/12분) 자율 완주, 상위 세션 파일 실측 대조 정합.
  발견 → 규칙: 브라우저 2개 시 로컬 우선 · 빈 값 `null` · 핵심 1~2줄 · navigate 후 2초 wait(다른 글 본문
  반환 2건) · 의역 금지(1인칭→3인칭 2건) · 긴 글 batch 2건 이하 · `status`는 partial에만.
- 2026-09-03: 6·7단계 첫 실행 — #9 발췌판 클리핑 → wiki 신규 1/갱신 2, `vault_verify --lane ingest` PASS,
  PR #281 머지. 원 개발은 `private/medium/SKILL.md`(v0.1→0.2)에서 진행 후 이 경로로 승격.