Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A command line tool that creates fulltext search indexes of your favourite websites on your machine, and allows you to search them locally

Project Description

About SiteSearcher

SiteSearcher is a command line tool that creates fulltext search indexes of your favourite websites on your machine, and allows you to search them locally.


sitesearcher indexer <mydomain> - Create a local search index for <mydomain>

sitesearcher search <mydomain> - Open search prompt for <mydomain>

Indexing of large sites can take quite long, but you can stop the indexer at any time and continue later at the point where you left off. To halt the indexer, simply type <CTRL>+C once and wait for graceful exit. To restart run the index command again with the --continue flag, i.e. sitesearcher indexer <mydomain> --continue.

Web Server Friendly

SiteSearcher tries to be web server friendly, while crawling. It obeys robot.txt, identifies itself with the "SiteSearcher" UserAgent and uses the Scrapy Autothrottle Extension to reduce the load on the server.

Installing SiteSearcher

If you have pip installed, you can use pip to download and install SiteSearcher.

pip install sitesearcher

SiteSearcher uses the Scrapy bot framework and therefore inherits its dependencies.

Getting the source

Download source releases from PyPI at

You can check out the latest version of source code from GitHub.

git clone

Python Version Support

SiteSearcher supports Python Versions 2.7 and 3.3+.

However switching between Python versions may require a rebuild of your indexes, as there is currently no support for SiteSearcher/Python 2 to read and write indexes created with SiteSearcher/Python 3 and vice versa.



  • Initial version of the SiteSearcher tool
  • Create Scrapy crawler to extract full text content of sites
  • Create Whoosh indexer to index stored sites
  • Create CLI for indexing and searching


  • Minor code cleanups

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(7.2 kB) Copy SHA256 Hash SHA256
Source None Sep 5, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting