https://github.com/anapaulagomes/peneira
It's time to sift through some articles ðŸ¤
https://github.com/anapaulagomes/peneira
open-science openalex pubmed semanticscholar
Last synced: 2 months ago
JSON representation
It's time to sift through some articles ðŸ¤
- Host: GitHub
- URL: https://github.com/anapaulagomes/peneira
- Owner: anapaulagomes
- License: mit
- Created: 2024-05-13T09:13:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-19T03:15:56.000Z (4 months ago)
- Last Synced: 2025-07-02T13:19:29.901Z (4 months ago)
- Topics: open-science, openalex, pubmed, semanticscholar
- Language: Python
- Homepage:
- Size: 992 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# peneira
 [](https://github.com/anapaulagomes/peneira/actions/workflows/tests.yml)
It's time to sift through some articles ðŸ¤
With this CLI you can search for papers for your research
in different sources and export the results.
> DISCLAIMER: This is a work in progress. The code is under active development
> and it's not ready for production use.
## Available sources
- [x] [OpenAlex](https://openalex.org/)
- [x] [Semantic Scholar](https://api.semanticscholar.org/)
...and [many more to come](https://github.com/anapaulagomes/peneira/issues?q=is%3Aissue+is%3Aopen+label%3Asources)!
Feel free to contribute. There is [a world of papers](https://en.wikipedia.org/wiki/List_of_academic_databases_and_search_engines)
out there!
### OpenAlex
Here are some details about this source:
* [Data sources](https://help.openalex.org/how-it-works#our-data-sources)
* [Search syntax](https://docs.openalex.org/how-to-use-the-api/get-lists-of-entities/search-entities#boolean-searches)
* [Filters](https://docs.openalex.org/api-entities/works/search-works)
* [Rate limits and authentication](https://docs.openalex.org/how-to-use-the-api/rate-limits-and-authentication)
This library obeys the rate limits of the OpenAlex API (10 requests per second).
### Semantic Scholar
Here are some details about this source:
* [Data sources](https://www.semanticscholar.org/about/publishers)
* [Search syntax](https://api.semanticscholar.org/api-docs/#tag/Paper-Data/operation/get_graph_paper_bulk_search)
* [Rate limits and authentication](https://www.semanticscholar.org/product/api)
This library obeys the rate limits of the Semantic Scholar API (1 request per second).
## Usage
### CLI
You can interact with the CLI using `peneira`. For example, to search for papers on
_"artificial intelligence" and "syndromic surveillance"_ and save the results to a file, you can run:
```bash
peneira -s open_alex -s semantic_scholar --filename my-papers.json
```
You will be prompted to enter the search query for each source. The lib will search for papers in
OpenAlex and Semantic Scholar and store it in a file named `my-papers.json`.
If no filename is provided, the results will be stored to `results.json`.
You have also the option of export it to a bibtex file:
```bash
peneira -s open_alex -s semantic_scholar --format bibtex --filename my-papers.bib
```