{"id":47974171,"url":"https://github.com/seonghobae/oai-pmh-scraper","last_synced_at":"2026-04-04T10:52:23.029Z","repository":{"id":346680281,"uuid":"1190679406","full_name":"seonghobae/oai-pmh-scraper","owner":"seonghobae","description":"Tooling to harvest open-access papers via OAI-PMH and store in Snowflake","archived":false,"fork":false,"pushed_at":"2026-03-31T11:11:46.000Z","size":232,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T10:52:21.835Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seonghobae.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security/api-security-checklist.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-24T14:13:28.000Z","updated_at":"2026-03-25T01:56:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/seonghobae/oai-pmh-scraper","commit_stats":null,"previous_names":["seonghobae/oai-pmh-scraper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/seonghobae/oai-pmh-scraper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seonghobae%2Foai-pmh-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seonghobae%2Foai-pmh-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seonghobae%2Foai-pmh-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seonghobae%2Foai-pmh-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seonghobae","download_url":"https://codeload.github.com/seonghobae/oai-pmh-scraper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seonghobae%2Foai-pmh-scraper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31397055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T10:52:22.677Z","updated_at":"2026-04-04T10:52:23.007Z","avatar_url":"https://github.com/seonghobae.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OAI-PMH Paper Harvester\n\nOAI-PMH에서 공개되는 메타데이터를 수집해 Snowflake에 적재하는 파이썬 수집기입니다.\n\n## 특징\n\n- OAI-PMH `ListRecords`를 사용한 증분 수집\n- `resumptionToken` 기반 페이지네이션 처리\n- 중복 식별자 중 최신 datestamp 기반 dedupe\n- 오픈 액세스 판별 후 저장 필터링 (옵션)\n- Snowflake `MERGE` 업서트\n- 로컬 상태 파일 기반 재개 지원\n\n## 빠른 실행\n\n```bash\npython -m venv .venv\nsource .venv/bin/activate\npip install -e .[dev]\n\nexport OAI_BASE_URL=\"https://export.arxiv.org/oai2\"\nexport OAI_METADATA_PREFIX=\"oai_dc\"\nexport SNOWFLAKE_ACCOUNT=\"\u003caccount\u003e\"\nexport SNOWFLAKE_USER=\"\u003cuser\u003e\"\nexport SNOWFLAKE_PASSWORD=\"\u003cpassword\u003e\"\nexport SNOWFLAKE_DATABASE=\"HARMONIA\"\nexport SNOWFLAKE_SCHEMA=\"PUBLIC\"\nexport SNOWFLAKE_TABLE=\"PAPERS\"\n\noai-pmh-harvester\n```\n\n드라이런:\n\n```bash\noai-pmh-harvester --dry-run\n```\n\n## 환경 변수\n\n| 이름 | 설명 | 기본값 |\n| --- | --- | --- |\n| `OAI_BASE_URL` | OAI-PMH 엔드포인트 URL | `required` |\n| `OAI_METADATA_PREFIX` | 메타데이터 포맷 | `oai_dc` |\n| `OAI_SET` | set 매개변수 | 없음 |\n| `OAI_FROM` | UTC datetime/date | 없음 |\n| `OAI_UNTIL` | UTC datetime/date | 없음 |\n| `OPEN_ACCESS_ONLY` | 오픈 액세스만 저장 (`true`/`false`) | `false` |\n| `OPEN_ACCESS_TERMS` | 오픈 액세스 판별 키워드 (`,` 구분) | 기본 내장 |\n| `HARVEST_BATCH_SIZE` | 업서트 배치 크기 (`0`이면 전체 일괄) | `500` |\n| `OAI_REQUEST_TIMEOUT` | API 요청 타임아웃(초) | `30` |\n| `OAI_USER_AGENT` | 요청 User-Agent 문자열 | `oai-pmh-scraper/0.1.0` |\n| `OAI_STATE_FILE` | 상태 파일 경로 | `.oai_harvest_state.json` |\n\nSnowflake 인증:\n\n| 이름 | 설명 | 기본값 |\n| --- | --- | --- |\n| `SNOWFLAKE_ACCOUNT` | Snowflake 계정 | - |\n| `SNOWFLAKE_USER` | 사용자 | - |\n| `SNOWFLAKE_PASSWORD` | 비밀번호 | - |\n| `SNOWFLAKE_ROLE` | 역할 | - |\n| `SNOWFLAKE_WAREHOUSE` | 웨어하우스 | - |\n| `SNOWFLAKE_DATABASE` | DB | `HARMONIA` |\n| `SNOWFLAKE_SCHEMA` | SCHEMA | `PUBLIC` |\n| `SNOWFLAKE_TABLE` | 테이블 | `PAPERS` |\n\n## 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseonghobae%2Foai-pmh-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseonghobae%2Foai-pmh-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseonghobae%2Foai-pmh-scraper/lists"}