{"id":22302600,"url":"https://github.com/dataoneorg/scythe","last_synced_at":"2025-07-29T03:33:17.043Z","repository":{"id":38333480,"uuid":"252312435","full_name":"DataONEorg/scythe","owner":"DataONEorg","description":"Scythe, the data citation harvester","archived":false,"fork":false,"pushed_at":"2024-09-18T23:47:29.000Z","size":2911,"stargazers_count":7,"open_issues_count":18,"forks_count":2,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-09-19T01:31:34.222Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DataONEorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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}},"created_at":"2020-04-01T23:52:49.000Z","updated_at":"2024-09-18T23:45:20.000Z","dependencies_parsed_at":"2024-09-18T00:40:02.477Z","dependency_job_id":null,"html_url":"https://github.com/DataONEorg/scythe","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataONEorg%2Fscythe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataONEorg%2Fscythe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataONEorg%2Fscythe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataONEorg%2Fscythe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DataONEorg","download_url":"https://codeload.github.com/DataONEorg/scythe/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227977908,"owners_count":17850475,"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","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-12-03T18:39:59.906Z","updated_at":"2024-12-03T18:40:00.540Z","avatar_url":"https://github.com/DataONEorg.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![R-CMD-check](https://github.com/DataONEorg/scythe/workflows/R-CMD-check/badge.svg)](https://github.com/DataONEorg/scythe/actions)\n[![Codecov test coverage](https://codecov.io/gh/DataONEorg/scythe/branch/develop/graph/badge.svg)](https://codecov.io/gh/DataONEorg/scythe?branch=develop)\n[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)\n\n- **Authors**: Jeanette Clark, Matthew B. Jones, Maya Samet, Althea Marks\n- [doi:10.18739/A2VT1GR7M](http://doi.org/10.18739/A2VT1GR7M)\n- **License**: [Apache 2](http://opensource.org/licenses/Apache-2.0)\n- [Package source code on Github](https://github.com/DataONEorg/scythe)\n- [**Submit Bugs and feature requests**](https://github.com/DataONEorg/scythe/issues)\n\nAutomates the full text harvesting of dataset citations from various full text article databases, \nincluding Scopus, PLOS, Springer, and XDD.\n\n## Installation\n\n### Released version\n\n```\nremotes::install_github(\"DataONEorg/scythe@v1.1.0\")\n```\n\nThe *scythe* R package should be available for use at this point.\n\n### Development version\n\nDevelopment versions can be installed from GitHub.\n\n```\nremotes::install_github(\"DataONEorg/scythe@develop\")\n```\n\n## Quick Start\n\nTo set API keys for use in the package, see the section below on authentication.\n\n```\nlibrary(scythe)\nscythe_set_key(source = \"scopus\", secret = \"YOUR KEY\")\n\nidentifier \u003c- \"10.18739/A22274\"\nresults \u003c- citation_search(identifier)\n```\n\n### Authorization Credentials \u0026 API Key Management\n\nThe function `scythe_set_key()` manages API keys using the [`keyring`](https://github.com/r-lib/keyring) package. `keyring` uses your operating system's credential store to securely keep track of key-value pairs. Running `scythe_set_key()` for the first time will prompt you to set a password for your keyring, should you need to lock or unlock it.\n\n#### Scopus\n\nTo obtain a Scopus API key, make an account at the [Elseviers Developers Portal](https://dev.elsevier.com/) and create API key. Once you've obtained your key, you can use `scythe_set_key()` to securely set your key. This key is accessed in the `citation_search()` function, but you can also retrieve the value using `keyring::key_get()`.\n\n```\nscythe_set_key(source = \"scopus\", secret = \"YOUR_KEY\")\nkeyring::key_get(\"scopus\", keyring = \"scythe\")\n```\n\n#### Springer\n\nThe Springer Nature API key is available by creating an application [here](https://dev.springernature.com/) after signing up for an account. The key can be set and retrieved using:\n\n```\nscythe_set_key(source = \"springer\", secret = \"YOUR_KEY\")\nkeyring::key_get(\"springer\", keyring = \"scythe\")\n```\n\n## Acknowledgments\nWork on this package was supported by:\n\n- NSF-PLR grant #1546024 to M. B. Jones, S. Baker-Yeboah, J. Dozier, M. Schildhauer, and A. Budden\n- NSF-PLR grant #2042102 to M. B. Jones, A. Budden, M. Schildhauer, and J. Dozier\n\n[![nceas_footer](https://live-ncea-ucsb-edu-v01.pantheonsite.io/sites/default/files/2020-03/NCEAS-full%20logo-4C.png)](https://www.nceas.ucsb.edu)\n\n[![dataone_footer](https://www.dataone.org/sites/all/images/DataONE_LOGO.jpg)](https://www.dataone.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataoneorg%2Fscythe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdataoneorg%2Fscythe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataoneorg%2Fscythe/lists"}