매일 문헌 레이다 스킬
매일 문헌 레이다(Daily Literature Radar)는 Codex 스킬로, 대상 저널, 작업 논문 소스, RSS 피드, 그리고 관찰 저자의 경제학 논문을 추적합니다. 공개 메타데이터를 가져오고, 사용자 정의 연구 프로필과 비교하여 논문 순위를 매긴 후, 매일 다이제스트를 생성합니다.
기본 버전은 Markdown을 생성합니다. 고급 버전은 매일 스케줄에 따라 실행되며, HTML 이메일(대체 Markdown 포함)로 다이제스트를 전송합니다.
현재 소스 라이브러리에는 대상 저널용 Crossref, 공식 NBER 작업 논문 메타데이터, CEPR, RePEc/NEP, 연방준비제도 피드, 저널 알림 등의 일반 RSS/Atom 피드가 포함됩니다. 추가 작업 논문 리포지토리는 RSS 피드 또는 소스 어댑터로 추가할 수 있습니다.
권장: Codex와 함께 구성
이 스킬은 Codex 또는 Claude Code의 도움을 받아 구성하도록 설계되었습니다. 코딩 에이전트는 다음과 같은 방법으로 연구 관심사를 작동하는 daily-econ-literature-radar.config.json 파일로 변환하는 데 도움을 줄 수 있습니다:
- 연구 주제를
fields,keywords,jel_codes,methods,geographies로 변환 - 연구 프로필 정의 후 분야 최상위 저널을 추천하고, 사용자가 선택한 저널만 추가
- 저널 ISSN을 찾아 확인한 후
target_journals에 추가 - 대상 저자 및 이름 별칭 추가
- RSS 피드 또는 NBER 프로그램/작업 그룹 필터 추가
- 고급 고정 시간 매일 이메일 버전을 위한 Gmail SMTP 및 스케줄러 구성
기본 설정은 Markdown 출력만 필요합니다. 고급 설정은 Gmail SMTP 및 스케줄러 구성 후 매일 HTML 이메일 다이제스트를 자동으로 전송합니다.
수행 작업
- Crossref ISSN 쿼리를 통해 대상 저널 모니터링
- 공식 NBER 메타데이터 TSV 파일을 통해 NBER 작업 논문 모니터링
- CEPR, RePEc/NEP, 연방준비제도 피드 또는 저널 알림과 같은 RSS/Atom 소스 모니터링
- 가져온 모든 메타데이터에서 대상 저자 추적
- 소스, 대상 저널 상태, 대상 저자 일치, 주제 일치, JEL/방법/지리 일치, 초록/제목 키워드 일치를 기준으로 후보 논문 순위 매기기
- DOI 또는 제목/저자 대체를 기준으로 중복 논문 제거
- 실행당 최대
max_papers개의 논문 출력(기본값 10) - Markdown 다이제스트 생성
- Gmail SMTP 또는 다른 SMTP 제공업체를 통해 고정된 매일 스케줄에 따라 HTML 이메일 다이제스트 선택적 전송
- 유료 PDF 또는 제한된 전체 텍스트 다운로드하지 않음
프로젝트 구조
daily-econ-literature-radar/
├── README.md
├── config.example.json
├── example-output/
│ ├── sample-digest.md
│ ├── sample-email.html
│ └── sample-email-preview.png
├── .gitignore
└── daily-econ-literature-radar/
├── SKILL.md
├── agents/openai.yaml
├── references/
│ ├── default-config.md
│ ├── journal-watchlist.md
│ └── source-notes.md
└── scripts/
├── economics_literature_radar.py
├── render_digest.py
├── send_digest.py
└── run_daily_radar.py
입력
daily-econ-literature-radar.config.json에서 입력을 구성합니다.
연구 프로필
관련성 순위 매기기에 사용:
fields: 광범위한 연구 분야jel_codes: JEL 코드 또는 부분 JEL 패밀리keywords: 주제 키워드methods: 방법 또는 실증 설계geographies: 국가, 지역, 데이터셋 또는 설정
대상 저널
Crossref를 통한 정확한 저널 모니터링. 경제학 Top 5 저널이 기본적으로 활성화됩니다. 연구 프로필이 설정된 후, 스킬은 분야 최상위 저널을 추천할 수 있으며, 사용자는 추가할 추천을 선택해야 합니다. 각 저널에는 다음이 포함되어야 합니다:
nametierfieldissn
예시:
{
"name": "저널명",
"tier": "field_top",
"field": "labor",
"issn": ["0000-0000"]
}
추가하기 전에 ISSN을 확인하세요.
대상 저자
우선 순위를 지정할 저자 이름 및 별칭:
{
"name": "저자명",
"aliases": ["A. Name", "Author M. Name"],
"notes": "선택적 메모"
}
소스
nber: 공식 NBER 메타데이터 어댑터rss_feeds: CEPR, RePEc/NEP, Fed, 저널 알림 또는 기타 RSS/Atom 피드target_journals: Crossref ISSN 쿼리
제한
max_papers: 최종 다이제스트 크기per_source_rows: 소스 쿼리당 요청할 행 수source_caps: 한 소스 유형이 다이제스트를 독점하지 못하도록 하는 소프트 제한
이메일
이메일은 선택 사항입니다. SMTP 자격 증명을 구성한 후에만 email.enabled를 true로 설정하세요.
출력
예제 출력은 example-output/sample-digest.md, example-output/sample-email.html, example-output/sample-email-preview.png에 포함되어 있습니다. 실제 실행과 동일한 구조와 이메일 스타일을 유지하면서 합성 논문 메타데이터를 사용합니다.

가져오기 JSON
fetch에 의해 생성:
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
각 논문 레코드는 다음을 포함할 수 있습니다:
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
Markdown 다이제스트
render_digest.py에 의해 생성:
daily-econ-literature-radar-output/YYYY-MM-DD.md
각 논문에는 제목, 저자, 소스, 게시/업데이트 날짜, DOI/URL, 일치 용어, 우선순위, 초록 및 메모가 포함됩니다.
이메일 다이제스트
이메일이 활성화된 경우 send_digest.py 또는 run_daily_radar.py에 의해 생성됩니다. 이메일에는 다음이 포함됩니다:
- 읽기 쉬운 Gmail/Outlook 표시를 위한 HTML 본문
- 대체 일반 텍스트 Markdown
사용 방법
팁: Codex 또는 Claude Code에 연구 프로필, 분야 최상위 저널 선택, 대상 저자 및 예약된 이메일 전송 구성을 요청하세요. Gmail SMTP와 Google 앱 비밀번호가 테스트되어 작동합니다.
기본 버전: Markdown만
프로젝트 루트에서:
cp config.example.json daily-econ-literature-radar.config.json
연구 프로필, 저자 및 소스를 사용하여 daily-econ-literature-radar.config.json을 편집합니다. 원하는 경우 기본 Top 5 저널을 유지하고, 추천에서 선택한 후 분야 최상위 저널을 추가합니다.
논문 가져오기:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json
Markdown 렌더링:
python3 daily-econ-literature-radar/scripts/render_digest.py \
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json \
--output daily-econ-literature-radar-output/YYYY-MM-DD.md
다이제스트를 검토한 후, 성공적인 처리를 표시합니다:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py mark-success \
--config daily-econ-literature-radar.config.json \
--data daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
mark-success는 state.json을 업데이트하여 이후 실행에서 동일한 논문을 반복하지 않도록 합니다.
고급 버전: 고정 시간 매일 이메일
고급 버전은 예약된 워크플로우입니다. 스크립트 자체로는 백그라운드 데몬으로 실행되지 않습니다. Codex 자동화, cron, macOS LaunchAgent 또는 Windows 작업 스케줄러와 같은 스케줄러가 원하는 시간에 매일 run_daily_radar.py를 호출해야 합니다.
스케줄러에서 원하는 전달 시간을 구성합니다. config에 기록할 수도 있습니다:
"push_time": "09:00",
"timezone": "America/Toronto"
Gmail SMTP
현재 구현은 Gmail SMTP 및 Google 앱 비밀번호로 테스트되었습니다.
daily-econ-literature-radar.config.json에서 설정:
"email": {
"enabled": true,
"provider": "gmail_smtp",
"from": "매일 문헌 레이다 <[email protected]>",
"to": "[email protected]",
"smtp_host": "smtp.gmail.com",
"smtp_port": 587,
"smtp_username": "[email protected]",
"smtp_password_env": "DAILY_RADAR_GMAIL_APP_PASSWORD",
"smtp_password_file": ".secrets/gmail_app_password",
"use_starttls": true
}
Gmail은 일반적으로 일반 Google 비밀번호 대신 Google 앱 비밀번호가 필요합니다. Google 계정 보안 설정에서 생성한 후 다음 방법 중 하나로 저장하세요.
환경 변수:
export DAILY_RADAR_GMAIL_APP_PASSWORD="your-app-password"
무시된 로컬 파일:
mkdir -p .secrets
printf '%s' 'your-app-password' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password
.gitignore 파일은 .secrets/, .env, 로컬 구성 및 출력을 제외합니다.
하나의 다이제스트 전송
python3 daily-econ-literature-radar/scripts/send_digest.py \
daily-econ-literature-radar-output/YYYY-MM-DD.md \
--config daily-econ-literature-radar.config.json
전체 이메일 파이프라인 실행
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
다음 순서로 실행됩니다:
fetch -> render Markdown -> send HTML email -> mark-success
이메일 전송이 성공한 후에만 성공을 표시합니다.
매일 전달 예약
선택한 시간에 매일 한 번씩 이 명령을 실행하도록 예약합니다:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
해당 명령은 전체 매일 이메일 워크플로우를 수행합니다:
fetch -> render Markdown -> send HTML email -> mark-success
예약 옵션
Codex 자동화
이 프로젝트 디렉토리에서 실행되는 매일 cron 자동화를 생성합니다:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
선호하는 로컬 시간대와 시간(예: 매일 09:00)을 사용합니다.
macOS Cron 또는 LaunchAgent
이 프로젝트는 MacBook/macOS 환경에서 Python 3로 개발 및 테스트되었습니다. 가장 간단한 macOS 예약 옵션은 다음과 같습니다:
- Codex 자동화
cronlaunchd/ LaunchAgent
cron의 경우, 작업이 프로젝트 디렉토리에서 시작되고 테스트에서 작동했던 동일한 Python 실행 파일을 사용하는지 확인하세요.
Windows 호환성
현재 버전은 MacBook/macOS에서 테스트되었습니다. Python 스크립트는 표준 라이브러리만 사용하므로 이식 가능해야 하지만, Windows 사용자는 다음을 조정해야 합니다:
python3대신python또는py -3사용- PowerShell 경로 구문 사용 및 공백이 포함된 경로 인용
- cron/launchd 대신 Windows 작업 스케줄러 사용
chmod 600을 Windows 파일 권한으로 대체하거나 앱 비밀번호를 환경 변수에 저장- 파일 시크릿을 사용하는 경우 Windows 경로에
.secrets\gmail_app_password사용 - 로컬 방화벽 또는 바이러스 백신 도구에서 TLS SMTP 연결이 허용되는지 확인
PowerShell 명령 예시:
cd "C:\path\to\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json
개인정보 보호 및 안전
다음을 커밋하지 마십시오:
daily-econ-literature-radar.config.json.secrets/.envdaily-econ-literature-radar-output/
이 스킬은 소스에서 제공하는 메타데이터와 초록만 사용합니다. 유료 PDF나 제한된 전체 텍스트를 다운로드하지 않습니다. 소스에 초록이 없는 경우, 다이제스트는 논문을 초록 없음/제목 전용으로 표시하고 결과를 추론하지 않습니다.
사용자 정의 참고 사항
max_papers를 다이제스트가 읽기 쉬울 정도로 작게 유지하세요.- Top 5 저널이 기본적으로 활성화되어 있습니다. 추천에서 선택한 후 확인된 ISSN으로 분야 최상위 저널을 추가하세요.
- 이니셜 또는 이름 변형에 대한 별칭과 함께 대상 저자를 추가하세요.
- RSS 피드를 점진적으로 추가하고 매일 전달을 예약하기 전에 품질을 검토하세요.
- 소스 캡을 사용하여 하나의 소스가 다이제스트를 지배하지 않도록 하세요.
