{"id":13936210,"url":"https://github.com/9b/chirp","last_synced_at":"2026-01-25T18:06:35.665Z","repository":{"id":33502030,"uuid":"134169598","full_name":"9b/chirp","owner":"9b","description":"Interface to manage and centralize Google Alert information","archived":false,"fork":false,"pushed_at":"2022-12-08T00:58:39.000Z","size":7151,"stargazers_count":233,"open_issues_count":10,"forks_count":22,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-11-27T04:30:46.982Z","etag":null,"topics":["automation","business-intelligence","data-mining","google-alerts","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/google-alerts/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/9b.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-20T16:59:25.000Z","updated_at":"2024-09-12T08:11:28.000Z","dependencies_parsed_at":"2023-01-15T01:16:15.270Z","dependency_job_id":null,"html_url":"https://github.com/9b/chirp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/9b/chirp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/9b%2Fchirp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/9b%2Fchirp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/9b%2Fchirp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/9b%2Fchirp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/9b","download_url":"https://codeload.github.com/9b/chirp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/9b%2Fchirp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266019657,"owners_count":23864916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","business-intelligence","data-mining","google-alerts","python3"],"created_at":"2024-08-07T23:02:28.367Z","updated_at":"2026-01-25T18:06:35.636Z","avatar_url":"https://github.com/9b.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Chirp\n=====\nChirp is a metadata platform built on top of Google Alerts meant to manage monitors, alerts and notifications. It's built on an `unofficial abstraction API`_ from the web interface, written in python.\n\n.. _`unofficial abstraction API`: https://github.com/9b/google-alerts\n\n.. image:: screenshots/chirp-sample.png\n   :alt: Demo interface of Chirp filled with alerts\n\n\nGetting Started\n---------------\nInstall MongoDB and ensure it's running:\n\n   https://www.mongodb.com/\n\nSetup a virtual environment for Python3:\n\n   $  sudo virtualenv -p python3 venv3\n\nActivate your container:\n\n   $ source venv3/bin/activate\n\nInstall the requirements:\n\n   $ (venv3) pip install -r requirements.txt\n\nStart redis:\n\n    $ redis-server\n\nStart RabbiqMQ:\n\n    $ rabbitmq-server\n\nStart the Celery beat:\n\n    $ (venv3) sudo celery worker -A celery_worker.celery --loglevel=info -B --concurrency=1\n\nStart the server:\n\n    $ (venv3) sudo python server.py run\n\n\nHow Does it Work?\n-----------------\nChirp takes a set of Google credentials and makes use of the python Google alerts abstract library to create, update and delete monitors. Each monitor is turned into an RSS feed and then managed within Chirp. Asynchronous jobs poll the RSS feeds for new articles, summarizing the content, deriving tag data and then presenting them within the interface. All alert data is presented in one location with additional metadata paired from the user.\n\nWhy?\n----\nGoogle Alerts by themselves are great for a small number of focused monitors. If you want to direct the Google machine to a larger set of queries, it can quickly become overwhelming for managing and then handling alerts. Chirp was built for cases where Google Alerts was managing a lot of monitors and users needed a way to prioritize the alerting information that came back. Chirp completely abstracts away the Google Alert interface and provides a framework for collecting data on specific topics using Google scale.\n\nState of the Project\n--------------------\nThis platform is a work in progress and is being developed on an \"as needed\" basis. In other words, not all functionality is implemented and it's far from polished.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F9b%2Fchirp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F9b%2Fchirp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F9b%2Fchirp/lists"}