Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rubeniskov/audible-scraper
Audible Scraper is a command-line tool (CLI) written in Rust that allows you to scrape information about audiobooks from Audible
https://github.com/rubeniskov/audible-scraper
audible csv json jsonl scraper toml web web-scraping
Last synced: about 1 month ago
JSON representation
Audible Scraper is a command-line tool (CLI) written in Rust that allows you to scrape information about audiobooks from Audible
- Host: GitHub
- URL: https://github.com/rubeniskov/audible-scraper
- Owner: rubeniskov
- Created: 2024-11-06T10:30:29.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-06T16:52:39.000Z (3 months ago)
- Last Synced: 2024-11-14T18:26:25.448Z (3 months ago)
- Topics: audible, csv, json, jsonl, scraper, toml, web, web-scraping
- Language: HTML
- Homepage:
- Size: 395 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Audible Scraper
_Audible Scraper_ is a command-line tool (CLI) written in Rust that allows you to scrape information about audiobooks from Audible with various filters and output format options. It leverages internal modules to build customized queries and serialize results into formats like JSON, CSV, JSONL, and TOML.
## Features
- Filter audiobooks by narrator (optional).
- Export data in various formats, including:
- **JSON**
- **CSV**
- **JSONL**
- **TOML**
- Asynchronous implementation for scalability and efficiency.
## Installation using pre-built binaries
Got to the [release page](https://github.com/rubeniskov/audible-scraper/releases) and download the latest release for your operating system.
## Install from Source
Clone the repository and install dependencies using `cargo`:
### Prerequisites
1. **Rust**: Ensure that Rust is installed on your system. You can install it by following the instructions on [rust-lang.org](https://www.rust-lang.org/).
2. **Cargo**: Cargo should be available as part of Rust for managing dependencies and building the project.
```bash
git clone https://github.com/rubeniskov/audible-scraper.git
cd audible-scraper-main
cargo install --path .
```
## Usage
Below is a basic usage example of the CLI, allowing you to specify output format and optionally filter by narrator.
```bash
audible-scraper --format [--narrator ]
CLI to scrape Audible audiobooks
Usage: audible-scraper.exe [OPTIONS]
Options:
-n, --narrator Narrator name to filter audiobooks (optional)
-k, --keywords
-f, --format Output format: jsonl, csv, json, or toml [default: json] [possible values: jsonl, csv, json, toml]
-h, --help Print help
```
```bash
audible-scraper --narrator "Jordi Salas"
[
{
"title": "1793 (Spanish Edition)",
"narrator": "Jordi Salas",
"language": "Español (Castellano)",
"releaseDate": "2020-07-30",
"sampleUrl": "https://samples.audible.com/bk/rhsp/002067/bk_rhsp_002067_sample.mp3"
},
...
{
"title": "Una Visión Estratégica para los Retos Económicos del Siglo XXI (Narración en Castellano)",
"narrator": "Jordi Salas",
"language": "Español (Castellano)",
"releaseDate": "2020-11-19",
"sampleUrl": "https://samples.audible.com/bk/adbl/057704/bk_adbl_057704_sample.mp3"
}
]
```
## Command line Arguments
- `--format`: Defines the output format. Available options: `json`, `csv`, `jsonl`, `toml`. **Default**: `json`.
- `--narrator`: Filters results to include only audiobooks narrated by the specified name. **Optional**.
- `--keywords`: Filters results to include only audiobooks with the specified keywords. **Optional**.
## Project Structure
- **`src/main.rs`**: Entry point of the CLI application, defining argument handling and execution logic.
- **`src/audio_book.rs`**: Defines the `AudioBook` struct representing audiobook data.
- **`src/builder.rs`**: Contains the construction of custom queries.
- **`src/params.rs`**: Defines the query parameters.
- **`src/scraper.rs`**: Implements the main scraping logic for Audible.
## Common Error Handling
- **TOML Format Error**: If you encounter an `UnsupportedType(None)` error, ensure all fields in the `AudioBook` struct have simple types. Alternatively, use an intermediate data structure to serialize into `TOML`.
## Contributions
If you wish to contribute to this project:
1. Fork the repository.
2. Create a feature branch (`git checkout -b feature/AmazingFeature`).
3. Submit a pull request.