paper-trending

# Paper Trending — 트렌딩 논문 한줄 요약 리포트 + 다운로드 HuggingFace Daily Papers API에서 트렌딩 논문을 수집하고 한국어 한줄 요약 테이블로 출력한다. 사용자가 요청하면 논문 PDF를 arxiv에서 다운로드하거나 HTML 버전을 읽어 상세 분석한다. ## 인자 파싱 `/paper-trending` 뒤의 인자를 분석하여 범위를 결정한다: | 인자 예시 | 해석 | API 파라미터 | |----------|------|-------------| | `2026-03-14` | 특정 날짜 | `?date=2026-03-14` | | `2026-W11` | 특정 주차 | `?week=2026-W11&sort=trending` | | `이번 주`, `이번주`, `이번 주간`, `this week` | 현재 ISO 주차 | `?week={현재주차}&sort=trending` | | `최근`, `recent` | 최근 2주 | 현재 주 + 이전 주 각각 호출 | | (인자 없음), `기본`, `default` | 최근 1개월 | `?month={현재월}&sort=trending` | | `2026-03` | 특정 월 | `?month=2026-03&sort=trending` | **추가 액션 인자** (범위 인자와 조합 가능): | 인자 | 동작 | |------|------| | `다운로드`, `download`, `dl` | 트렌딩 리포트 출력 후 상위 N개 논문 PDF 다운로드 | | `다운로드 5`, `dl 3` | 상위 N개만 다운로드 (기본: 5) | | `다운로드 all` | 리포트의 모든 논문 다운로드 | | `읽기 {arxiv_id}`, `read {arxiv_id}` | 특정 논문의 HTML 버전을 읽어 상세 분석 | 예시: `/paper-trending 이번 주 다운로드 3` → 이번 주 트렌딩 리포트 + 상위 3개 PDF 다운로드 **현재 날짜 기준**: 오늘 날짜에서 ISO 주차와 월을 계산한다. ## 워크플로우 ### Step 1: 범위 결정 인자를 파싱하여 API 호출 URL을 결정한다. - ISO 주차 계산이 필요하면 `date +%G-W%V` 또는 Python으로 계산 - "최근"인 경우 현재 주 + 이전 주 2개의 API 호출 필요 ### Step 2: API 호출 WebFetch로 HuggingFace API를 호출한다. **기본 URL**: `https://huggingface.co/api/daily_papers` **파라미터 (소스 코드 확인된 정확한 사양):** - `date=YYYY-MM-DD` — 특정 날짜 - `week=YYYY-WNN` — 주간 - `month=YYYY-MM` — 월간 - `sort=trending` — 트렌딩 알고리즘 정렬 (주간/월간에서 권장) - `sort=publishedAt` — 발행일 정렬 (기본값) - `p=0,1,2...` — 페이지 번호 - `limit=50` — 페이지당 결과 수 (기본 50) **호출 예시:** ``` # 이번 주 트렌딩 https://huggingface.co/api/daily_papers?week=2026-W11&sort=trending # 이번 달 https://huggingface.co/api/daily_papers?month=2026-03&sort=trending # 특정 날짜 https://huggingface.co/api/daily_papers?date=2026-03-14 ``` **"최근" (2주)인 경우** — 두 주차를 병렬로 WebFetch: ``` https://huggingface.co/api/daily_papers?week=2026-W11&sort=trending https://huggingface.co/api/daily_papers?week=2026-W10&sort=trending ``` 결과가 16개 이하이면 `p=1`로 다음 페이지도 호출하여 더 많은 논문 수집. ### Step 3: 데이터 추출 API 응답 JSON에서 각 논문의 다음 정보를 추출: ``` paper.id → arxiv ID paper.title → 제목 paper.upvotes → upvotes (해당 기간 내 획득분) paper.ai_summary → AI 요약 (없으면 paper.summary 사용) paper.authors[0].name → 첫 번째 저자 paper.organization.fullname → 소속 기관 paper.githubRepo → GitHub 저장소 paper.githubStars → GitHub 스타 수 ``` ### Step 4: 출력 upvotes 내림차순으로 정렬하여 마크다운 테이블로 출력한다. **출력 형식:** ```markdown # {범위} 트렌딩 논문 ({날짜 범위}) | # | 논문 | UP | 한줄 요약 | |---|------|---:|---------| | 1 | **{제목}** ({기관}) | {upvotes} | {ai_summary를 한국어 1문장으로 요약} | | 2 | ... | | | | ... | | | | **키워드**: {전체 논문에서 추출한 주요 트렌드 키워드 3-5개} ``` **규칙:** - 한줄 요약은 **한국어**로, ai_summary 또는 summary를 1문장으로 압축 - 기관명이 있으면 제목 옆에 괄호로 표시 - 기본적으로 상위 15개까지 표시. 사용자가 더 요청하면 추가 - upvotes가 0인 논문은 제외 - "최근" 모드에서 두 주차 결과가 합쳐지면 중복 제거 (arxiv ID 기준) ### Step 5: 논문 다운로드 (선택적 — `다운로드`/`download` 인자가 있을 때) arxiv 논문은 인증 없이 자유롭게 다운로드 가능하다. **다운로드 URL 패턴:** | 형식 | URL | 용도 | |------|-----|------| | PDF | `https://arxiv.org/pdf/{arxiv_id}` | 원본 논문 다운로드 | | HTML | `https://arxiv.org/html/{arxiv_id}` | 브라우저 읽기용 (모든 논문에 있지는 않음) | | Abstract | `https://arxiv.org/abs/{arxiv_id}` | 메타데이터 + 초록 페이지 | **다운로드 절차:** 1. 작업 디렉토리에 `papers/` 폴더 생성 (없으면) 2. 대상 논문 목록 결정: - `다운로드 N` → 리포트 상위 N개 - `다운로드 all` → 리포트 전체 - `다운로드` → 기본 상위 5개 3. 각 논문을 Bash `curl`로 다운로드: ```bash curl -L "https://arxiv.org/pdf/{arxiv_id}" -o "papers/{arxiv_id}.pdf" ``` 4. 다운로드 완료 후 결과 테이블 출력: ```markdown ## 다운로드 완료 | 논문 | 파일 | 크기 | |------|------|------| | {제목} | papers/{arxiv_id}.pdf | {size} | ``` **주의사항:** - PDF 파일은 수~수십 MB 가능. 대량 다운로드 시 사용자에게 확인 - arxiv에 과도한 요청을 보내지 않도록 다운로드 간 1초 간격 유지 - 다운로드 실패 시 해당 논문 스킵하고 보고 ### Step 6: 논문 읽기 (선택적 — `읽기`/`read` 인자가 있을 때) 특정 논문의 내용을 상세 분석한다. **절차:** 1. 논문이 이미 `papers/{arxiv_id}.pdf`로 다운로드되어 있으면 Read 도구로 PDF 읽기 2. 없으면 HTML 버전을 시도: WebFetch로 `https://arxiv.org/html/{arxiv_id}` 호출 3. HTML도 없으면 PDF 다운로드 후 Read 도구로 읽기 4. 논문 내용을 한국어로 요약: - 연구 목적/동기 - 핵심 방법론 - 주요 실험 결과 - 한계점/향후 연구 - 실용적 시사점 ## 에러 핸들링 | 상황 | 대응 | |------|------| | API 응답 실패 | 1회 재시도. 실패 시 사용자에게 알림 | | 빈 응답 | "해당 기간에 트렌딩 논문이 없습니다" 출력 | | 잘못된 인자 | 인자 형식 안내 후 기본값(1개월)으로 진행할지 확인 | | PDF 다운로드 실패 | 해당 논문 스킵, 나머지 계속. 실패 목록 보고 | | HTML 버전 없음 (404) | PDF 다운로드 후 Read 도구로 대체 | | PDF 용량 과대 (>50MB) | 사용자에게 알리고 다운로드 여부 확인 | ## 사용 예시 ``` /paper-trending → 이번 달 트렌딩 /paper-trending 이번 주 → 이번 주 트렌딩 /paper-trending 최근 → 최근 2주 트렌딩 /paper-trending 2026-03-14 → 특정 날짜 /paper-trending 2026-W11 → 특정 주차 /paper-trending 2026-03 → 특정 월 /paper-trending 이번 주 다운로드 → 이번 주 트렌딩 + 상위 5개 PDF 다운로드 /paper-trending 이번 주 다운로드 3 → 이번 주 트렌딩 + 상위 3개 PDF 다운로드 /paper-trending 이번 주 dl all → 이번 주 트렌딩 + 전체 PDF 다운로드 /paper-trending 읽기 2603.03143 → 특정 논문 상세 분석 ```