Skip to content

netgoPython Search Toolkit & Wikimedia APIs

Lightweight Python library for scraping search engines, extracting clean page content, parsing sitemaps, and querying Wikimedia APIs.

Architecture Overview ​

  • netgo: Top-level package exports and convenient high-level functions (search, search_many, fetch).
  • netgo.search: Google and Bing backends, consistent Result models, pagination, error handling.
  • netgo.page: Article body extraction engine, HTML boilerplate filtering, and Page data model.
  • netgo.sitemap: Robots.txt discovery, XML/text sitemap parsing, index crawling, and prefix filtering.
  • netgo.wiki: MediaWiki Action API client, Wikipedia, Wikidata, Commons, and Wiktionary interfaces.

Submodule API Reference ​

ModuleDocumentation LinkDocumented ClassesDocumented Functions
netgonetgo00
netgo.pagenetgo.page00
netgo.page.errorsnetgo.page.errors30
netgo.page.extractnetgo.page.extract010
netgo.page.fetchnetgo.page.fetch01
netgo.page.modelsnetgo.page.models10
netgo.searchnetgo.search02
netgo.search.bingnetgo.search.bing06
netgo.search.errorsnetgo.search.errors20
netgo.search.googlenetgo.search.google06
netgo.search.modelsnetgo.search.models20
netgo.sitemapnetgo.sitemap00
netgo.sitemap.errorsnetgo.sitemap.errors30
netgo.sitemap.fetchnetgo.sitemap.fetch06
netgo.sitemap.modelsnetgo.sitemap.models20
netgo.sitemap.parsenetgo.sitemap.parse04
netgo.wikinetgo.wiki00
netgo.wiki.clientnetgo.wiki.client13
netgo.wiki.corenetgo.wiki.core015
netgo.wiki.errorsnetgo.wiki.errors30
netgo.wiki.modelsnetgo.wiki.models110
netgo.wiki.wikidatanetgo.wiki.wikidata013
netgo.wiki.wikimedianetgo.wiki.wikimedia05
netgo.wiki.wiktionarynetgo.wiki.wiktionary07

Runnable Examples ​

End-to-end runnable scripts are located in the GitHub Examples Directory and documented on the Code Examples Page.

Example FilePurpose / FeatureGitHub Source
01_search.pySearch Google and Bing through the same engine-agnostic API.View Source
02_parallel_search.pyRun many search queries at once with netgo.search_many.View Source
03_read_page.pyFetch any web page and read just its main content.View Source
04_wikipedia.pyDeep-dive into a Wikipedia article with netgo.wiki.View Source
05_wikidata.pyFrom a Wikipedia title to structured Wikidata facts.View Source
06_commons.pyFind Wikimedia Commons files and inspect their metadata.View Source
07_wiktionary.pyDictionary data from Wiktionary.View Source
08_research_pipeline.pyThe full journey in one script: search -> fetch -> enrich with Wikipedia.View Source
09_sitemap.pyDiscover and read a site's XML sitemaps.View Source

Released under the MIT License.