https://github.com/abovecolin/bs

Extracts data from
https://github.com/abovecolin/bs

Last synced: 6 days ago
JSON representation

Extracts data from

• Host: GitHub
• URL: https://github.com/abovecolin/bs
• Owner: AboveColin
• Created: 2020-11-05T18:09:11.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-10-06T10:19:50.000Z (over 1 year ago)
• Last Synced: 2024-11-09T17:38:49.532Z (2 months ago)
• Language: Python
• Homepage:
• Size: 51.8 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# BS

BS is a data extraction tool designed to streamline the process of retrieving information. It offers a range of functionalities, from querying specific data to saving and sharing the results. The tool is compatible with Google Chrome and can be easily set up and executed on a machine with Python 3.6 installed.

## Prerequisites

- Google Chrome Browser

- ChromeDriver binary compatible with your Chrome version

- Python 3.6 or higher

## Installation

Clone the repository and install the required dependencies using the following commands:

```sh

git clone 

cd 

pip install -r requirements.txt

```

## Usage

Execute the `main.py` script with appropriate arguments to start the search process:

```sh

python main.py 

```

### Arguments

#### Mode (One of the following is **REQUIRED**)

- **Composer Mode:**

  - Search by composer name.

  - Use: `-c "composer name"` or `--composer "composer name"`

  

- **Title Mode:**

  - Search by title name.

  - Use: `-t "title name"` or `--title "title name"`

  

- **Author Mode:**

  - Search by author name.

  - Use: `-a "author name"` or `--author "author name"`

#### Optional

- **List Mode:**

  - Display all information in a list without interruptions.

  - Use: `-l` or `--list`

  

- **Proxy:**

  - Access data using a specific proxy.

  - Use: `-p "127.0.0.1:1234"` or `--proxy "127.0.0.1:1234"`

  

- **Without Headless:**

  - Launch the script with the browser window visible.

  - Use: `-whl` or `--without_headless`

  

- **Save:**

  - Save the output to a text file located in the `saves/` directory.

  - Use: `-s` or `--save`

  

- **SQL:**

  - Store the data in a MySQL database.

  - Use: `-sql` or `--sql`

  

- **Discord Webhook (requires SQL to be enabled):**

  - Send new database entries to a specified Discord webhook.

  - Use: `-dwh` or `--discord_webhook`

## Examples

Search for information by composer name, display it in list form, and save the output to a text file:

```sh

python main.py -c "Beethoven" -l -s

```

Retrieve data by title, use a proxy for the connection, and save the results to a MySQL database:

```sh

python main.py -t "Moonlight Sonata" -p "127.0.0.1:1234" -sql

```

## Contributing

Feel free to fork the repository and submit pull requests. For major changes, please open an issue first to discuss what you would like to change.

## Acknowledgements

- Thanks to everyone who contributed to the development and enhancement of this tool.

---