# AutoSpider: A Smart, Automatic, Fast Web Spider for Python
This project is made for automatic web spider to make scraping easy.
It gets a url or the html content of a web page and a list of sample data which we want to scrape from that page. **This data can be text, url or any html tag value of that page.** It learns the spider rules and returns the similar elements. Then you can use this learned object with new urls to get similar content or the exact same element of those new pages.
## Installation
It's compatible with python 3.
- Install latest version from git repository using pip:
```bash
$ pip install git+https://github.com/khulnasoft-lab/autospider.git
```
- Install from PyPI:
```bash
$ pip install autospider
```
- Install from source:
```bash
$ python setup.py install
```
## How to use
### Getting similar results
Say we want to fetch all related post titles in a stackoverflow page:
```python
from autospider import AutoSpider
url = 'https://stackoverflow.com/questions/2081586/web-scraping-with-python'
# We can add one or multiple candidates here.
# You can also put urls here to retrieve urls.
wanted_list = ["What are metaclasses in Python?"]
scraper = AutoSpider()
result = scraper.build(url, wanted_list)
print(result)
```
Here's the output:
```python
[
'How do I merge two dictionaries in a single expression in Python (taking union of dictionaries)?',
'How to call an external command?',
'What are metaclasses in Python?',
'Does Python have a ternary conditional operator?',
'How do you remove duplicates from a list whilst preserving order?',
'Convert bytes to a string',
'How to get line count of a large file cheaply in Python?',
"Does Python have a string 'contains' substring method?",
'Why is “1000000000000000 in range(1000000000000001)” so fast in Python 3?'
]
```
Now you can use the `scraper` object to get related topics of any stackoverflow page:
```python
scraper.get_result_similar('https://stackoverflow.com/questions/606191/convert-bytes-to-a-string')
```
### Getting exact result
Say we want to scrape live stock prices from yahoo finance:
```python
from autospider import AutoSpider
url = 'https://finance.yahoo.com/quote/AAPL/'
wanted_list = ["124.81"]
scraper = AutoSpider()
# Here we can also pass html content via the html parameter instead of the url (html=html_content)
result = scraper.build(url, wanted_list)
print(result)
```
Note that you should update the `wanted_list` if you want to copy this code, as the content of the page dynamically changes.
You can also pass any custom `requests` module parameter. for example you may want to use proxies or custom headers:
```python
proxies = {
"http": 'http://127.0.0.1:8001',
"https": 'https://127.0.0.1:8001',
}
result = scraper.build(url, wanted_list, request_args=dict(proxies=proxies))
```
Now we can get the price of any symbol:
```python
scraper.get_result_exact('https://finance.yahoo.com/quote/MSFT/')
```
**You may want to get other info as well.** For example if you want to get market cap too, you can just append it to the wanted list. By using the `get_result_exact` method, it will retrieve the data as the same exact order in the wanted list.
**Another example:** Say we want to scrape the about text, number of stars and the link to issues of Github repo pages:
```python
from autospider import AutoSpider
url = 'https://github.com/khulnasoft-lab/autospider'
wanted_list = ['A Smart, Automatic, Fast and Lightweight Web Scraper for Python', '2.5k', 'https://github.com/khulnasoft-lab/autospider/issues']
scraper = AutoSpider()
scraper.build(url, wanted_list)
```
Simple, right?
### Saving the model
We can now save the built model to use it later. To save:
```python
# Give it a file path
scraper.save('yahoo-finance')
```
And to load:
```python
scraper.load('yahoo-finance')
```
## Issues
Feel free to open an issue if you have any problem using the module.
#### Happy Coding ♥️
Raw data
{
"_id": null,
"home_page": "https://github.com/khulnasoft-lab/autospider",
"name": "autospider",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "web scraping spider scraper",
"author": "KhulnaSoft DevOps",
"author_email": "info@khulnasoft.com",
"download_url": "https://files.pythonhosted.org/packages/45/22/a7a5c032f74063e3d36a8e0078ab8f68ae3a4e6d30f4e4e000c36389b1c9/autospider-1.1.11.tar.gz",
"platform": null,
"description": "# AutoSpider: A Smart, Automatic, Fast Web Spider for Python\n\nThis project is made for automatic web spider to make scraping easy. \nIt gets a url or the html content of a web page and a list of sample data which we want to scrape from that page. **This data can be text, url or any html tag value of that page.** It learns the spider rules and returns the similar elements. Then you can use this learned object with new urls to get similar content or the exact same element of those new pages.\n\n\n## Installation\n\nIt's compatible with python 3.\n\n- Install latest version from git repository using pip:\n```bash\n$ pip install git+https://github.com/khulnasoft-lab/autospider.git\n```\n\n- Install from PyPI:\n```bash\n$ pip install autospider\n```\n\n- Install from source:\n```bash\n$ python setup.py install\n```\n\n## How to use\n\n### Getting similar results\n\nSay we want to fetch all related post titles in a stackoverflow page:\n\n```python\nfrom autospider import AutoSpider\n\nurl = 'https://stackoverflow.com/questions/2081586/web-scraping-with-python'\n\n# We can add one or multiple candidates here.\n# You can also put urls here to retrieve urls.\nwanted_list = [\"What are metaclasses in Python?\"]\n\nscraper = AutoSpider()\nresult = scraper.build(url, wanted_list)\nprint(result)\n```\n\nHere's the output:\n```python\n[\n 'How do I merge two dictionaries in a single expression in Python (taking union of dictionaries)?', \n 'How to call an external command?', \n 'What are metaclasses in Python?', \n 'Does Python have a ternary conditional operator?', \n 'How do you remove duplicates from a list whilst preserving order?', \n 'Convert bytes to a string', \n 'How to get line count of a large file cheaply in Python?', \n \"Does Python have a string 'contains' substring method?\", \n 'Why is \u201c1000000000000000 in range(1000000000000001)\u201d so fast in Python 3?'\n]\n```\nNow you can use the `scraper` object to get related topics of any stackoverflow page:\n```python\nscraper.get_result_similar('https://stackoverflow.com/questions/606191/convert-bytes-to-a-string')\n```\n\n### Getting exact result\n\nSay we want to scrape live stock prices from yahoo finance:\n\n```python\nfrom autospider import AutoSpider\n\nurl = 'https://finance.yahoo.com/quote/AAPL/'\n\nwanted_list = [\"124.81\"]\n\nscraper = AutoSpider()\n\n# Here we can also pass html content via the html parameter instead of the url (html=html_content)\nresult = scraper.build(url, wanted_list)\nprint(result)\n```\nNote that you should update the `wanted_list` if you want to copy this code, as the content of the page dynamically changes.\n\nYou can also pass any custom `requests` module parameter. for example you may want to use proxies or custom headers:\n\n```python\nproxies = {\n \"http\": 'http://127.0.0.1:8001',\n \"https\": 'https://127.0.0.1:8001',\n}\n\nresult = scraper.build(url, wanted_list, request_args=dict(proxies=proxies))\n```\n\nNow we can get the price of any symbol:\n\n```python\nscraper.get_result_exact('https://finance.yahoo.com/quote/MSFT/')\n```\n\n**You may want to get other info as well.** For example if you want to get market cap too, you can just append it to the wanted list. By using the `get_result_exact` method, it will retrieve the data as the same exact order in the wanted list.\n\n**Another example:** Say we want to scrape the about text, number of stars and the link to issues of Github repo pages:\n\n```python\nfrom autospider import AutoSpider\n\nurl = 'https://github.com/khulnasoft-lab/autospider'\n\nwanted_list = ['A Smart, Automatic, Fast and Lightweight Web Scraper for Python', '2.5k', 'https://github.com/khulnasoft-lab/autospider/issues']\n\nscraper = AutoSpider()\nscraper.build(url, wanted_list)\n```\n\nSimple, right?\n\n\n### Saving the model\n\nWe can now save the built model to use it later. To save:\n\n```python\n# Give it a file path\nscraper.save('yahoo-finance')\n```\n\nAnd to load:\n\n```python\nscraper.load('yahoo-finance')\n```\n\n## Issues\nFeel free to open an issue if you have any problem using the module.\n\n\n#### Happy Coding \u2665\ufe0f\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Smart, Automatic, Fast and Lightweight Web Scraper for Python",
"version": "1.1.11",
"project_urls": {
"Homepage": "https://github.com/khulnasoft-lab/autospider"
},
"split_keywords": [
"web",
"scraping",
"spider",
"scraper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eeb853ac0511f09d7ed9b417688e3ad8ca312e276f8c6acb6343e84ef6d17eb4",
"md5": "0427eae8fbad5a4a58ea58dd8b8c4fca",
"sha256": "df30ee496d1aa59b926ad6af1bba96e98a2115629b5a3236c3370f6ae4dc8e12"
},
"downloads": -1,
"filename": "autospider-1.1.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0427eae8fbad5a4a58ea58dd8b8c4fca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 9754,
"upload_time": "2024-04-30T21:32:26",
"upload_time_iso_8601": "2024-04-30T21:32:26.201681Z",
"url": "https://files.pythonhosted.org/packages/ee/b8/53ac0511f09d7ed9b417688e3ad8ca312e276f8c6acb6343e84ef6d17eb4/autospider-1.1.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4522a7a5c032f74063e3d36a8e0078ab8f68ae3a4e6d30f4e4e000c36389b1c9",
"md5": "41bc81cf42b264d2327375df5417a214",
"sha256": "13e3d47f40cf0b108e612f0eed608cd51cc3514110c536ae65f5b5655f01bebd"
},
"downloads": -1,
"filename": "autospider-1.1.11.tar.gz",
"has_sig": false,
"md5_digest": "41bc81cf42b264d2327375df5417a214",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 10894,
"upload_time": "2024-04-30T21:32:27",
"upload_time_iso_8601": "2024-04-30T21:32:27.809463Z",
"url": "https://files.pythonhosted.org/packages/45/22/a7a5c032f74063e3d36a8e0078ab8f68ae3a4e6d30f4e4e000c36389b1c9/autospider-1.1.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-30 21:32:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "khulnasoft-lab",
"github_project": "autospider",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "autospider"
}
JSON
