https://github.com/jamesturk/scrapeghost

👻 Experimental library for scraping websites using OpenAI's GPT API.
https://github.com/jamesturk/scrapeghost

gpt openai-api webscraping

Last synced: 25 days ago
JSON representation

👻 Experimental library for scraping websites using OpenAI's GPT API.

• Host: GitHub
• URL: https://github.com/jamesturk/scrapeghost
• Owner: jamesturk
• License: other
• Created: 2023-03-18T01:37:10.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-05T10:00:52.000Z (3 months ago)
• Last Synced: 2024-10-01T12:22:44.805Z (about 1 month ago)
• Topics: gpt, openai-api, webscraping
• Language: Python
• Homepage: https://jamesturk.github.io/scrapeghost/
• Size: 1.66 MB
• Stars: 1,425
• Watchers: 20
• Forks: 87
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Code of conduct: docs/code_of_conduct.md

Awesome Lists containing this project

• awesome-ChatGPT-repositories - scrapeghost - 👻 Experimental library for scraping websites using OpenAI's GPT API. (Openai)
• jimsghstars - jamesturk/scrapeghost - 👻 Experimental library for scraping websites using OpenAI's GPT API. (Python)

README

        
# scrapeghost

![scrapeghost logo](docs/assets/scrapeghost.png)

`scrapeghost` is an experimental library for scraping websites using OpenAI's GPT.

Source: [https://github.com/jamesturk/scrapeghost](https://github.com/jamesturk/scrapeghost)

Documentation: [https://jamesturk.github.io/scrapeghost/](https://jamesturk.github.io/scrapeghost/)

Issues: [https://github.com/jamesturk/scrapeghost/issues](https://github.com/jamesturk/scrapeghost/issues)

[![PyPI badge](https://badge.fury.io/py/scrapeghost.svg)](https://badge.fury.io/py/scrapeghost)

[![Test badge](https://github.com/jamesturk/scrapeghost/workflows/Test%20&%20Lint/badge.svg)](https://github.com/jamesturk/scrapeghost/actions?query=workflow%3A%22Test+%26+Lint%22)

**Use at your own risk. This library makes considerably expensive calls ($0.36 for a GPT-4 call on a moderately sized page.) Cost estimates are based on the [OpenAI pricing page](https://beta.openai.com/pricing) and not guaranteed to be accurate.**

![](screenshot.png)

## Features

The purpose of this library is to provide a convenient interface for exploring web scraping with GPT.

While the bulk of the work is done by the GPT model, `scrapeghost` provides a number of features to make it easier to use.

**Python-based schema definition** - Define the shape of the data you want to extract as any Python object, with as much or little detail as you want.

**Preprocessing**

* **HTML cleaning** - Remove unnecessary HTML to reduce the size and cost of API requests.

* **CSS and XPath selectors** - Pre-filter HTML by writing a single CSS or XPath selector.

* **Auto-splitting** - Optionally split the HTML into multiple calls to the model, allowing for larger pages to be scraped.

**Postprocessing**

* **JSON validation** - Ensure that the response is valid JSON.  (With the option to kick it back to GPT for fixes if it's not.)

* **Schema validation** - Go a step further, use a [`pydantic`](https://pydantic-docs.helpmanual.io/) schema to validate the response.

* **Hallucination check** - Does the data in the response truly exist on the page?

**Cost Controls**

* Scrapers keep running totals of how many tokens have been sent and received, so costs can be tracked.

* Support for automatic fallbacks (e.g. use cost-saving GPT-3.5-Turbo by default, fall back to GPT-4 if needed.)

* Allows setting a budget and stops the scraper if the budget is exceeded.