{"id":19264201,"url":"https://github.com/cphyc/adsquery","last_synced_at":"2025-07-22T17:02:58.131Z","repository":{"id":55393642,"uuid":"60105979","full_name":"cphyc/adsquery","owner":"cphyc","description":"CLI interface to query the ADS.","archived":false,"fork":false,"pushed_at":"2021-01-03T14:44:04.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-23T19:15:05.405Z","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/cphyc.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}},"created_at":"2016-05-31T16:31:25.000Z","updated_at":"2021-01-03T14:44:06.000Z","dependencies_parsed_at":"2022-08-14T23:20:15.954Z","dependency_job_id":null,"html_url":"https://github.com/cphyc/adsquery","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cphyc/adsquery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cphyc%2Fadsquery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cphyc%2Fadsquery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cphyc%2Fadsquery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cphyc%2Fadsquery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cphyc","download_url":"https://codeload.github.com/cphyc/adsquery/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cphyc%2Fadsquery/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266535676,"owners_count":23944274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":"2024-11-09T19:40:20.485Z","updated_at":"2025-07-22T17:02:58.106Z","avatar_url":"https://github.com/cphyc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# adsquery\n\nThis tool let you query the ADS using a simple CLI.\n\n## Installation\nYou'll need an API key from NASA ADS labs. Sign up for the newest version of ADS search at https://ui.adsabs.harvard.edu, visit account settings and generate a new API token. The official documentation is available at https://github.com/adsabs/adsabs-dev-api.\n\nYou can then install the tool through pip:\n```\n$ pip install adsquery\n```\n\nAfter that, you should be able to use it under the name `adsquery`:\n```\n$ adsquery --help\n$ adsquery query --help\n```\n\n## Querying\nTo make a query to the ADS, try:\n```\n$ adsquery query [my-query]\n```\nThe query can either be an ADS compatible query or a bashist one. For example:\n```\n$ adsquery query --first-author Einstein 1915\n$ adsquery query ^Einstein 1915\n```\nwill result in the same results (papers by Einstein in 1915).\n\n\n## Examples\nImagine we're looking at the original 1915 Einstein's paper that's explaining for the first time the advance of the perihelion of Mercury. Here's an example of how to use adsquery\n```\n$ adsquery query --first-author Einstein --year 1915\n[0]: 1915, Annalen der Physik — Einstein, A., Antwort auf eine Abhandlung M. v. Laues Ein Satz der Wahrscheinlichkeitsrechnung und seine Anwendung auf die Strahlungstheorie\n[1]: 1915, Sitzungsberichte der Königlich Preußischen Akademie der Wissenschaften (Berlin — Einstein, Albert, Die Feldgleichungen der Gravitation\n[2]: 1915, Naturwissenschaften — Einstein, A., Experimenteller Nachweis der Ampèreschen Molekularströme\n[3]: 1915, Sitzungsber. preuss.Akad. Wiss — Einstein, A., Erklarung der Perihelionbewegung der Merkur aus der allgemeinen Relativitatstheorie\n[4]: 1915, Sitzungsberichte der Königlich Preußischen Akademie der Wissenschaften (Berlin — Einstein, Albert, Erklärung der Perihelbewegung des Merkur aus der allgemeinen Relativitätstheorie\n[5]: 1915, Sitzungsberichte der Königlich Preußischen Akademie der Wissenschaften (Berlin — Einstein, Albert, Zur allgemeinen Relativitätstheorie\n[6]: 1915, Koninklijke Nederlandse Akademie van Wetenschappen Proceedings Series B Physical Sciences — Einstein, A., de Haas, W. J., Experimental proof of the existence of Ampère's molecular currents\n[7]: 1915, Sitzungsberichte der Königlich Preußischen Akademie der Wissenschaften (Berlin — Einstein, Albert, Zur allgemeinen Relativitätstheorie (Nachtrag)\n[8]: 1915, Deutsche Physikalische Gesellschaft — Einstein, Albert, de Haas, Wander Johannes, Notiz zu unserer Arbeit \"Experimenteller Nachweis der Ampèreschen Molekularströme\"\n[9]: 1915, Deutsche Physikalische Gesellschaft — Einstein, Albert, Berichtigung zu meiner gemeinsam mit Herrn J. W. de Haas veröffentlichten Arbeit \"Experimenteller Nachweis der Ampèreschen Molekularströme\"\n```\nHere we see we got a few papers from the period, let's keep only the ones matching the work `Merkur` (Mercury in German)\n```\nComma separated articles to download [e.g. 1-3, 4], [m] for more [q] to quit or add more parameters to request [e.g. year:2016]: Merkur\n[0]: 1915, Sitzungsberichte der Königlich Preußischen Akademie der Wissenschaften (Berlin — Einstein, Albert, Erklärung der Perihelbewegung des Merkur aus der allgemeinen Relativitätstheorie\n\n# Now let's download it\nComma separated articles to download [e.g. 1-3, 4], [m] for more [q] to quit or add more parameters to request [e.g. year:2016]: 0\nDownload [d], bibtex[b], quit[q]? d\n```\nThe file is now located at `~/ADS/1915SPAW.......831E_Einstein.pdf`. If you wanted the bibtex entry, you should replace the last `d` by `b`.\n\n# Features\n- [x] query the ADS\n- [x] interactively prompt the user\n  - [x] show bibtex reference\n  - [x] download pdf file\n\n## Bugs and suggestions\nFeel free to fill in an issue if you have any problem or suggestion\n\n## Thanks\nSpecial thanks to andycasey for providing https://github.com/andycasey/ads and the ADS!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcphyc%2Fadsquery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcphyc%2Fadsquery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcphyc%2Fadsquery/lists"}