주제/키워드로 arXiv에서 논문을 검색합니다. 결과는 관련도 순으로 정렬되며, 최근 1년 / 3년 / 5년 이내로 분류해 반환합니다.

Args: query: 검색 키워드 (예: "vision language model", "contrastive learning") max_results: 최대 논문 수 (기본 20, 최대 50) category: arXiv 카테고리 필터 (예: "cs.CV"). 비우면 전체 검색.

논문 ID로 상세 정보를 조회합니다. arXiv ID, DOI, Semantic Scholar ID를 모두 지원합니다.

Args: paper_id: arXiv ID (예: "2301.12597"), DOI (예: "10.48550/arXiv.2301.12597"), 또는 Semantic Scholar SHA ID.

Semantic Scholar의 콘텐츠 유사도 기반 추천 논문 k건을 반환합니다.

인용 그래프와는 별개의 신호 (D-4) — 새 토픽 탐색·관련 분야 발견에 적합. 현재 워크플로우(citation 중심)에는 자동 편입되지 않습니다.

Args: paper_id: arXiv ID (예: "2301.12597"), DOI, 또는 Semantic Scholar ID. k: 추천 논문 수 (기본 10).

논문이 참조(reference)한 논문들을 정렬해 반환합니다.

Args: paper_id: arXiv ID (예: "2301.12597"), DOI, 또는 Semantic Scholar ID. top_k: 반환할 상위 논문 수 (기본 20). max_fetch: 최대 수집 reference 수 (기본 500). 대부분 논문은 references가 100 이내라 한 번에 다 가져온다. sort: "velocity"(기본, ADR-004) 또는 "count"(인용수 순). current_year: velocity 계산 기준 연도. None이면 현재. min_velocity: velocity 모드일 때 최소 velocity 임계값 (기본 10). 신생 인용수 낮은 노이즈 논문을 제거한다.

논문을 인용(citation)한 후속 연구들을 정렬해 반환합니다.

SS citations endpoint는 publicationDate 내림차순으로 응답한다 (인기 논문은 첫 페이지가 인용수 0인 신생 논문으로 가득 차 의미 있는 결과 추출에 다수의 API 호출 필요). 이를 막기 위해 exclude_recent_year=True이면 publicationDateOrYear=:<year-1> 필터로 가장 최근 1년을 제외 — velocity ≥ 10 같은 임계값과 정합 (신생 1년 미만은 누적 인용 시간 부족).

Args: paper_id: arXiv ID (예: "2304.08485"), DOI, 또는 Semantic Scholar ID. top_k: 반환할 상위 논문 수 (기본 20). max_fetch: 최대 수집 citation 수 (기본 1000). sort: "velocity"(기본, ADR-004) 또는 "count". current_year: velocity 기준 연도. None이면 현재. min_velocity: velocity 모드일 때 최소 velocity (기본 10). exclude_recent_year: True면 publication 직전 연도까지로 SS 응답을 제한 (가장 최근 1년 신생 제외, 기본 True).

citing_id 논문이 cited_id 논문을 인용한 본문 문맥 스니펫을 반환합니다.

동적 토픽 분석 (ADR-009) 입력으로 사용 — Claude가 컨텍스트 + 초록을 결합해 토픽 태그와 cited_for 노트를 생성합니다.

Args: citing_id: 인용하는 논문 (arXiv ID / DOI / SS sha). cited_id: 인용된 논문.

arXiv 논문 PDF를 로컬에 다운로드해 두고 경로를 반환합니다. 이미 저장되어 있으면 재다운로드를 skip합니다.

Args: paper_id: arXiv ID (예: "2301.12597"). 'ARXIV:' prefix·버전 접미사 허용.

arXiv 논문 PDF를 (필요 시 다운로드 후) 전체 텍스트로 추출합니다.

캐시 hit이면 디스크에서 바로 읽고, miss면 다운로드 + 저장 후 진행.

Args: paper_id: arXiv ID (예: "2301.12597"). max_pages: 추출할 최대 페이지 수. 0이면 전체 (기본: 0).

캐시된 PDF에서 caption 매칭된 raster figure를 vault에 저장 (ADR-010, ADR-015, ADR-016).

저장 위치: vault/papers/<slug>/figures/fig_<n>.png. slug 미지정 시 arxiv_id를 fallback (legacy 호환).

Args: paper_id: arXiv ID (예: "2301.12597") — PDF 캐시 검색용. slug: vault 디렉토리명 (title-slug). 비우면 arxiv_id 사용.

vault의 papers/<slug>/figures/ 에서 keep에 명시된 파일만 남기고 나머지 삭제 (ADR-015, ADR-016).

LLM이 extract_paper_figures 결과의 caption을 보고 핵심 architecture / 결과 plot만 선별 → 선별 결과를 keep으로 넘겨 호출. 나머지 figure는 디스크에서 제거.

Args: paper_id: arXiv ID (정규화 검사용). keep: 남길 figure의 파일 식별자 리스트. "figures/fig_1.png" 또는 "fig_1.png" 둘 다 허용. 빈 리스트면 모든 figure 삭제. slug: vault 디렉토리명 (title-slug). 비우면 arxiv_id 사용 (legacy 호환).

캐시된 PDF에서 caption 기준 영역 crop으로 table을 vault에 저장 (ADR-018).

저장 위치: vault/papers/<slug>/tables/table_<n>.png. 각 table은 caption + 그 아래 일정 영역을 raster로 렌더해 1 PNG에 보존 (table 본체는 PDF 내부 vector text라 sub-image 분리가 불가능 — 영역 crop이 유일한 방법).

Args: paper_id: arXiv ID. slug: vault 디렉토리명. 비우면 arxiv_id 사용.

vault의 papers/<slug>/tables/ 에서 keep에 명시된 파일만 남기고 나머지 삭제.

Args: paper_id: arXiv ID. keep: 남길 table 파일 식별자 ("tables/table_1.png" 또는 "table_1.png"). slug: vault 디렉토리명.

PDF의 특정 페이지를 통째로 PNG로 렌더해 vault에 저장 (ADR-018 옵션).

ColPali 스타일 page-as-image의 단순 도구. figure crop이 잡지 못한 케이스나 수식이 많은 페이지를 시각적으로 보존하고 싶을 때 사용.

Args: paper_id: arXiv ID. page: 1-base 페이지 번호. slug: vault 디렉토리명. dpi: 렌더 해상도 (기본 150).

Obsidian 노트 전문 조회 (frontmatter 포함).

Args: slug: arxiv_id ("2301.12597") 또는 vault 상대경로 ("topics/vlm").

노트 저장 (frontmatter + body). 폴더 자동 생성.

Args: slug: arxiv_id 또는 vault 상대경로. frontmatter: YAML로 직렬화될 dict. MCP 클라이언트가 string으로 보내면 JSON으로 parse 시도 (parse 실패 시 빈 frontmatter로 처리). body: 마크다운 본문.

vault 안 디렉토리의 노트 목록 (papers/topics/digests 등).

Args: prefix: vault root 기준 디렉토리. 기본 'papers'.

source 노트 본문 끝에 - [[target]] 라인 추가. 중복이면 skip.

Args: source: 링크를 추가할 노트 slug. target: 가리킬 노트 slug (Obsidian wikilink). note: 링크 옆 한 줄 설명 (옵션).

Hugging Face Daily Papers를 받아 인기 순으로 반환합니다 (ADR-006 fallback chain).

Args: date: YYYY-MM-DD. 비우면 오늘(UTC). limit: 상위 N개 (기본 10).

anchor + 토픽 그룹으로 시각화 산출. Mermaid는 응답, Canvas는 vault에 저장.

방향: references → anchor → citations (인과 흐름).

Args: anchor: {arxiv_id, title, year, citation_count, citation_velocity?}. ref_groups: anchor가 인용한 논문들의 동적 토픽 그룹. [{"topic": str, "papers": [{arxiv_id, title, year, citation_count}, ...]}]. cite_groups: anchor를 인용한 논문들의 동적 토픽 그룹. 동일 스키마. slug: vault/canvases/<slug>.canvas 파일명. 비우면 anchor.arxiv_id 사용. direction: Mermaid 방향 ("LR" 기본, "TD"·"RL"·"BT" 가능).