goose3

library3.1.21pypypi✓ verified 83d ago

Goose3 is an HTML content/article extractor and web scraper for Python 3 (requires Python >=3.9). It extracts the main content, title, authors, metadata (OpenGraph, schema.org), and images from news articles and web pages. The current version is 3.1.21, with irregular releases as fixes accumulate.

data http-networking

pip install goose3

github ↗package ↗

INSTALL

IMPORT

SIG · GOOSE3

goose3

datapythonv3.1.21

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Goose

✓ from goose3 import Goose

✗ from goose import Goose

The old 'goose' library is a different, unmaintained project.

Article

✓ from goose3.article import Article

Article is typically accessed via Goose.extract() return, not imported directly by users.

Extract article title and cleaned text from a URL.

from goose3 import Goose url = 'https://www.bbc.com/news/world-us-canada-68942345' with Goose() as g: article = g.extract(url=url) print(article.title) print(article.cleaned_text[:200])

Debug

Known issues

deprecatedcamelCase methods (e.g., `getTags()`, `getTones()`) are deprecated since v3.1.13. Use snake_case equivalents (`tags`, `tones`).

fix

Replace `article.getTags()` with `article.tags`, `article.getTones()` with `article.tones`.

affects: >=3.1.13

gotchaGoose3 does not handle JavaScript-rendered pages. Only static HTML content is extracted.

fix

Use a headless browser like Selenium or Playwright to get the rendered HTML, then pass it to Goose3.

affects: all

breakingPython 3.7 and 3.8 support removed in v3.1.20. Requires Python >=3.9.

fix

Upgrade Python to 3.9 or higher.

affects: >=3.1.20

gotchaThe `extract()` method can raise `requests.exceptions.MissingSchema` if the URL doesn't include a scheme (e.g., 'example.com' instead of 'https://example.com').

fix

Always provide a full URL with http:// or https:// scheme.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'goose'

Attempting to import from the old 'goose' library (Python 2) instead of 'goose3'.

fix

Install goose3: pip install goose3 and import from goose3 import Goose.

requests.exceptions.MissingSchema: Invalid URL 'example.com/article': No schema supplied. Perhaps you meant http://example.com/article?

URL passed to extract() is missing the scheme (http:// or https://).

fix

Prepend 'https://' to the URL before calling extract().

TypeError: 'NoneType' object is not iterable

Occasionally occurs when accessing article.tags or article.authors if extraction fails (e.g., network error or non-article page).

fix

Check that article is not None and that the page contains the expected data.

Upgrade

Version history

3.1.21latest on PyPI · released Nov 30, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/goose3/goose3 ↗

packagehttps://pypi.org/project/goose3/ ↗