Communitygithub.com

lishn6/매일-경제-문헌-레이다

경제학 논문을 추적하고 요약하는 Codex 스킬입니다.

매일-경제-문헌-레이다란 무엇인가요?

Daily Literature Radar는 경제학 연구자와 경제 관련 업무 종사자를 위해 설계된 Codex 스킬로, 대상 저널, 작업 논문 소스, RSS 피드, 그리고 관찰 저자의 경제학 논문을 매일 자동으로 추적합니다. Crossref, NBER, CEPR, RePEc/NEP, 연방준비제도(FRB) 등 공개 메타데이터를 수집하여 사용자가 정의한 연구 프로필(분야, JEL 코드, 키워드, 방법론, 지리적 범위)과 비교하여 관련성 순위를 매깁니다. 기본 버전은 마크다운 다이제스트를 생성하며, 고급 버전은 Gmail SMTP와 스케줄러를 통해 매일 고정된 시간에 HTML 이메일로 다이제스트를 자동 발송합니다. 이 스킬은 Codex나 Claude Code와 함께 사용하도록 설계되어 사용자의 연구 관심사를 구성 파일로 변환하는 과정을 AI 에이전트가 도와줄 수 있으며, 유료 PDF나 전체 텍스트를 다운로드하지 않고 메타데이터와 초록만을 사용하여 안전하게 작동합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lishn6/daily-econ-literature-radar/tree/main

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

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

미리보기

스킬 README에서

렌더링된 HTML 이메일 미리보기

문서

매일 문헌 레이다 스킬

매일 문헌 레이다(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 저널이 기본적으로 활성화됩니다. 연구 프로필이 설정된 후, 스킬은 분야 최상위 저널을 추천할 수 있으며, 사용자는 추가할 추천을 선택해야 합니다. 각 저널에는 다음이 포함되어야 합니다:

  • name
  • tier
  • field
  • issn

예시:

{
  "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에 포함되어 있습니다. 실제 실행과 동일한 구조와 이메일 스타일을 유지하면서 합성 논문 메타데이터를 사용합니다.

렌더링된 HTML 이메일 미리보기

가져오기 JSON

fetch에 의해 생성:

daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json

각 논문 레코드는 다음을 포함할 수 있습니다:

  • title
  • authors
  • source
  • source_kind
  • date
  • date_type
  • doi
  • url
  • abstract
  • keywords
  • matched_terms
  • priority
  • score
  • notes

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 자동화
  • cron
  • launchd / 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/
  • .env
  • daily-econ-literature-radar-output/

이 스킬은 소스에서 제공하는 메타데이터와 초록만 사용합니다. 유료 PDF나 제한된 전체 텍스트를 다운로드하지 않습니다. 소스에 초록이 없는 경우, 다이제스트는 논문을 초록 없음/제목 전용으로 표시하고 결과를 추론하지 않습니다.

사용자 정의 참고 사항

  • max_papers를 다이제스트가 읽기 쉬울 정도로 작게 유지하세요.
  • Top 5 저널이 기본적으로 활성화되어 있습니다. 추천에서 선택한 후 확인된 ISSN으로 분야 최상위 저널을 추가하세요.
  • 이니셜 또는 이름 변형에 대한 별칭과 함께 대상 저자를 추가하세요.
  • RSS 피드를 점진적으로 추가하고 매일 전달을 예약하기 전에 품질을 검토하세요.
  • 소스 캡을 사용하여 하나의 소스가 다이제스트를 지배하지 않도록 하세요.

관련 스킬