{"id":51503548,"url":"https://github.com/hpsummer/paper-research-downloader","last_synced_at":"2026-07-07T22:01:08.239Z","repository":{"id":367024345,"uuid":"1278736716","full_name":"HPSummer/paper-research-downloader","owner":"HPSummer","description":"Codex/Claude skill for lawful paper search, OA download, parsing, exports, Zotero checks, and Obsidian notes","archived":false,"fork":false,"pushed_at":"2026-06-24T07:45:59.000Z","size":340,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-24T10:28:41.453Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HPSummer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-24T04:02:25.000Z","updated_at":"2026-06-24T07:46:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/HPSummer/paper-research-downloader","commit_stats":null,"previous_names":["hpsummer/paper-research-downloader"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/HPSummer/paper-research-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpaper-research-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpaper-research-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpaper-research-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpaper-research-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HPSummer","download_url":"https://codeload.github.com/HPSummer/paper-research-downloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpaper-research-downloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35243953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-07-07T22:01:07.283Z","updated_at":"2026-07-07T22:01:08.221Z","avatar_url":"https://github.com/HPSummer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Paper Research Downloader\n\nPortable Codex/Claude skill for lawful scholarly paper search, open-access acquisition, parsing, citation export, and Obsidian literature-note ingestion.\n\n## What It Does\n\n- Search OpenAlex, Semantic Scholar, arXiv, Crossref, PubMed, PMC, and Unpaywall-backed OA locations.\n- Resolve DOI, arXiv, PMID, PMCID, URL, and mixed batch identifier files.\n- Download lawful open-access PDFs and cache/resume long runs.\n- Generate lawful access plans for paywalled publisher records.\n- Stage user-mediated institutional access by opening DOI/publisher/library-proxy URLs, then ingest PDFs the user manually downloads.\n- Fall back to PMC XML full text when PMCID PDF download is unavailable.\n- Parse PDFs to Markdown with read plans and end-of-paper sentinels.\n- Export `results.json`, `papers.csv`, `papers.bib`, `papers.ris`, `papers.csl.json`, `report.md`, and `report.html`.\n- Write duplicate-aware Obsidian notes with YAML frontmatter, tags, and wiki-link placeholders.\n- Run read-only local Zotero duplicate-candidate checks.\n\n## Install\n\nFor Codex:\n\n```powershell\nCopy-Item -Path .\\paper-research-downloader -Destination $env:USERPROFILE\\.codex\\skills\\paper-research-downloader -Recurse -Force\n```\n\nFor Claude:\n\n```powershell\nCopy-Item -Path .\\paper-research-downloader -Destination $env:USERPROFILE\\.claude\\skills\\paper-research-downloader -Recurse -Force\n```\n\nOr download `dist/paper-research-downloader-v1.4.0.zip` and extract the `paper-research-downloader` folder into your skills directory.\n\n## Quick Start\n\n```powershell\ncd .\\paper-research-downloader\npython .\\scripts\\paper_research_downloader.py check-env --zotero\npython .\\scripts\\paper_research_downloader.py config-init\npython .\\scripts\\paper_research_downloader.py resolve arxiv:2103.15348 --write-notes\npython .\\scripts\\paper_research_downloader.py batch --input .\\ids.txt --metadata-only --write-notes --delay 1\npython .\\scripts\\paper_research_downloader.py institutional-open \"10.xxxx/yyyy\" --proxy-prefix \"https://library.example.edu/login?url=\" --download-dir \"$env:USERPROFILE\\Downloads\" --wait-for-pdf --ingest-downloaded\n```\n\n## Notes\n\nThis skill only uses lawful open-access sources, author/repository copies, PMC/arXiv, publisher OA files, user-mediated institutional access, or user-provided PDFs. It does not use shadow libraries or credential bypasses.\n\nInstitutional login is user-mediated only. Do not store usernames, passwords, cookies, sessions, proxy credentials, or tokens in `config.local.json`, skill files, Git commits, release zips, or issue/PR text. The package command runs a private-data scan and blocks likely credential leaks.\n\n`ocrmypdf` is optional. If it is not installed, OCR fallback is skipped and recorded in the manifest.\n\n## Validation\n\n```powershell\npython .\\paper-research-downloader\\scripts\\paper_research_downloader.py test\npython .\\paper-research-downloader\\scripts\\paper_research_downloader.py self-test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhpsummer%2Fpaper-research-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhpsummer%2Fpaper-research-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhpsummer%2Fpaper-research-downloader/lists"}