https://github.com/e-e-e/bookcovers
A federated search API for finding image thumbnails for book covers.
https://github.com/e-e-e/bookcovers
Last synced: 8 months ago
JSON representation
A federated search API for finding image thumbnails for book covers.
- Host: GitHub
- URL: https://github.com/e-e-e/bookcovers
- Owner: e-e-e
- License: mit
- Created: 2019-10-09T10:10:16.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T02:13:17.000Z (about 3 years ago)
- Last Synced: 2025-06-26T19:54:10.251Z (8 months ago)
- Language: JavaScript
- Size: 665 KB
- Stars: 97
- Watchers: 5
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bookcovers
A federated search API for finding image thumbnails for book covers.
Performs a combined search of _Amazon_, _Google Books_ and _Open Library_ to find thumbnails corresponding to isbn numbers.
_bookcovers_ is node library and cli tool. It currently does not work in browser environments.
## Install
```
npm i -g bookcovers
```
## Example Usage
As a library within a node application:
```js
const bookcovers = require("bookcovers");
bookcovers
.withIsbn("9781570273148")
.then(results => ...);
```
As a cli:
```bash
bookcovers ;
# logs out book cover data in the form " "
```
Specify which service to use:
```bash
bookcovers --type amazon;
# only searches Amazon
```
## API
#### bookcovers.withIsbn(isbn: string, options?: { ... });
Returns a promise that resolves to an object containing urls from each of the sources.
```js
{
amazon: {
'1x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY218_ML3_.jpg',
'1.5x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY327_FMwebp_QL65_.jpg',
'2x': 'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY436_FMwebp_QL65_.jpg',
'2.2935x':'https://m.media-amazon.com/images/I/51z2HY7kn4L._AC_UY500_FMwebp_QL65_.jpg'
},
google: {
smallThumbnail: 'http://books.google.com/books/content?id=wDVV6y-8YHEC&printsec=frontcover&img=1&zoom=5&source=gbs_api',
thumbnail: 'http://books.google.com/books/content?id=wDVV6y-8YHEC&printsec=frontcover&img=1&zoom=1&source=gbs_api'
},
openLibrary: {
small: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-S.zip&file=369091-S.jpg',
medium: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-M.zip&file=369091-M.jpg',
large: 'http://ia801606.us.archive.org/zipview.php?zip=/26/items/olcovers36/olcovers36-L.zip&file=369091-L.jpg'
}
}
```
### Options
- `type` - Specify a service: `'amazon' | 'google' | 'openLibrary'`. Default: `null` (all).
- `amazon` - Specify additional options for puppeteer amazon scraper
- `google` - Specify additional options for request google scraper
- `openLibrary` - Specify additional options for request open library scraper