Community연구 & 데이터 분석github.com

Yoyiyoniu/paper-search

공식 학술 API(arXiv, Semantic Scholar, Europe PMC, OpenAlex)를 검색하고, 합법적인 PDF를 읽어 인용된 노트를 작성합니다. 사용자가 과학 논문, 문헌 검토, 최신 기술 동향, 주제에 대한 증거, 알려진 DOI를 요구하거나 "busca papers sobre X"라고 말할 때 사용합니다.

paper-search란 무엇인가요?

이 스킬은 사용자가 과학 논문, 문헌 검토, 최신 기술 동향, 주제에 대한 증거, 알려진 DOI를 요구할 때 사용됩니다. arXiv, Semantic Scholar, Europe PMC, OpenAlex와 같은 공식 학술 API를 검색하고, 합법적인 PDF를 읽어 인용된 노트를 작성합니다. Claude Code, Cursor, Codex 등 다양한 AI 어시스턴트에서 사용할 수 있으며, `scripts/papers.py` 스크립트를 통해 검색 및 읽기 기능을 제공합니다. 이 스킬은 과학적 주장을 제시할 때 반드시 초록이나 이 세션에서 읽은 PDF 페이지에 근거하도록 하여, 기억이나 블로그 등 2차 자료에 의존하지 않도록 합니다. 문헌 검토나 종합 보고서가 필요한 경우 백그라운드 에이전트를 실행하여 PDF를 읽고 결과를 마크다운 파일로 저장하며, 단일 논문이나 DOI는 현재 대화에서 바로 처리합니다. 검색 쿼리는 자동으로 영어로 번역되며, 주제에 따라 최적의 API(예: AI/ML은 arXiv, 생물학/의학은 Europe PMC)로 라우팅됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yoyiyoniu/my-skills/tree/HEAD/paper-search

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

paper-search은(는) 무엇을 하나요?

공식 API를 검색하고 합법적인 PDF를 읽습니다. 과학적 주장은 이 세션에서 읽은 초록이나 PDF 페이지에 포함된 내용일 때만 허용됩니다. 기억이나 블로그, 그 외 2차 요약문에서 제공하지 마세요. 모든 주장을 해당 주장이 속한 논문까지 추적하세요.

연도, DOI, 인용 횟수는 스크립트 출력에서 가져옵니다. citations=-이면 출처가 인용 횟수를 제공하지 않은 것입니다. 그렇게 말하고 추정하지 마세요.

읽기 위임

문헌 검토, 최신 기술 동향, 또는 하나 이상의 논문이 필요한 보고서의 경우 백그라운드 에이전트를 실행하여 읽기를 진행함으로써 이 대화를 계속 진행할 수 있습니다. 단일 논문이나 알려진 DOI는 여기서 처리합니다.

백그라운드 에이전트의 작업:

  1. 논문 자체를 대상으로 질문을 조사하며, 2차 요약문을 사용하지 않습니다.
  2. 각 주장의 출처를 인용하여 단일 마크다운 파일로 결과를 작성합니다.
  3. 저장소가 이미 그러한 노트를 보관하는 위치에 저장합니다. 기존 규칙을 따릅니다. 규칙이 없으면 docs/notes/<topic>.md에 작성하고 위치를 알려줍니다.

scripts/papers.py의 절대 경로, 질문, 도메인, 출력 경로를 전달합니다. 아래 스크립트를 사용하며 API를 다시 구현하지 않습니다.

스크립트

scripts/papers.py는 이 파일 옆에 있습니다. 표준 라이브러리만 사용합니다. 절대 경로로 실행하세요.

python3 scripts/papers.py search "QUERY" [--domain auto|ml|phys|math|bio|psy|chem] [--limit N] [--year 2020|2020-2024|2020-] [--sort relevance|citations|date] [--abstract]
python3 scripts/papers.py read PDF_URL --pages 1-3 [--out notes.txt]
python3 scripts/papers.py oa 10.xxxx/yyyy

oa는 Unpaywall에서 is_oa=와 pdf=를 출력합니다. 한 번의 쿼리, --limit는 최대 10입니다. 결과 목록이 잘못되었으면 쿼리를 변경하세요. 페이지를 넘기지 마세요.

선택 사항: SEMANTIC_SCHOLAR_API_KEY (429 오류 감소) 및 PAPER_SEARCH_EMAIL (OpenAlex 및 Unpaywall).

라우팅

검색 전 쿼리를 영어로 번역하세요.

주제--domain첫 번째 출처실패 시
AI / ML / NLP / 비전 / 로보틱스 / CSmlarXivSemantic Scholar, 이후 OpenAlex
물리학 / 천문학physarXivSemantic Scholar, 이후 OpenAlex
수학matharXivSemantic Scholar, 이후 OpenAlex
생물학 / 의학 / 유전학 / 제약bioEurope PMCSemantic Scholar, 이후 OpenAlex
심리학 / 인지 과학psyEurope PMCSemantic Scholar, 이후 OpenAlex
화학 / 재료chemSemantic ScholarOpenAlex
혼합 또는 불명확autoSemantic ScholarOpenAlex
  • 최신 기술 동향 또는 "가장 많이 인용된": --sort citations. arXiv에는 인용 횟수가 없으므로 해당 정렬은 Semantic Scholar에서 시작합니다.
  • 새로운 것: --sort date 또는 --year 2023-.
  • 제목으로 지정된 논문: 해당 영어 제목을 검색합니다. --sort relevance를 사용하면 동일한 제목이 첫 번째로 순위가 매겨집니다.

선별

--abstract와 함께 검색을 실행합니다. 사용할 논문만 유지하세요.

  • 획기적: 많이 인용되었고 2년 이상 지난 논문.
  • 최근: 최근 2년 이내의 해당 주제 논문. 인용 횟수가 적더라도 포함.
  • 주변적: 주제와 거리가 먼 논문. 노트에서 제외합니다.

읽기

  1. 사용자가 방법, 숫자 또는 인용문을 요청하지 않는 한 초록으로 충분합니다.
  2. 그런 경우에만 PDF를 엽니다: read URL --pages 1-3. 마지막 부분은 마지막 2-4페이지를 읽습니다. 길이를 모르면 1-3페이지를 유지하세요. 페이지 번호를 추측하지 마세요.
  3. ERROR: not a PDF 또는 pdf=(no open PDF…): oa <DOI>를 실행하고 출력된 pdf=를 읽습니다. pdf=-이면 합법적인 직접 PDF가 없는 것입니다. 초록을 유지하세요. url= 랜딩 페이지를 논문으로 취급하지 마세요.
  4. 다음 호스트는 직접 읽을 수 있습니다: arxiv.org, europepmc.org, ncbi.nlm.nih.gov, 대학 저장소. 다른 호스트는 먼저 oa를 거쳐야 합니다.
  5. Sci-Hub, Library Genesis 또는 기타 그림자 라이브러리 미러를 사용하지 마세요.

실행당 최대 3개의 PDF를 읽습니다. 질문에 더 많은 PDF가 필요하면 초록으로 마무리하고 열지 않은 PDF를 나열하세요.

노트

# <질문>

## 발견 사항
- 초록이나 명명된 페이지에 있는 경우에만 주장을 기재합니다. (Vaswani et al. 2017, 10.48550/arXiv.1706.03762, 초록)

## 논문
- **Attention Is All You Need** (2017) — 120404 인용, OpenAlex
  - doi: 10.48550/arXiv.1706.03762
  - pdf: https://arxiv.org/pdf/1706.03762
  - 읽기: 초록만
  - 포함 이유: 해당 텍스트에서 가져온 한 줄

## 읽지 않음
- 주제에서 벗어나 제외된 논문, 또는 열지 않은 PDF.

채팅에서는 파일을 가리키세요. 내용을 다시 붙여넣지 마세요. 파일로 만들어지지 않은 단일 논문 답변에도 동일한 인용 규칙이 적용됩니다: 저자, 연도, DOI, 출처가 초록인지 어떤 페이지인지 명시.

관련 스킬