Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/9b/chirp
Interface to manage and centralize Google Alert information
https://github.com/9b/chirp
automation business-intelligence data-mining google-alerts python3
Last synced: about 2 months ago
JSON representation
Interface to manage and centralize Google Alert information
- Host: GitHub
- URL: https://github.com/9b/chirp
- Owner: 9b
- License: mit
- Created: 2018-05-20T16:59:25.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T00:58:39.000Z (about 2 years ago)
- Last Synced: 2024-08-08T23:23:05.007Z (6 months ago)
- Topics: automation, business-intelligence, data-mining, google-alerts, python3
- Language: Python
- Homepage: https://pypi.org/project/google-alerts/
- Size: 6.82 MB
- Stars: 232
- Watchers: 18
- Forks: 21
- Open Issues: 10
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
Chirp
=====
Chirp 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... _`unofficial abstraction API`: https://github.com/9b/google-alerts
.. image:: screenshots/chirp-sample.png
:alt: Demo interface of Chirp filled with alertsGetting Started
---------------
Install MongoDB and ensure it's running:https://www.mongodb.com/
Setup a virtual environment for Python3:
$ sudo virtualenv -p python3 venv3
Activate your container:
$ source venv3/bin/activate
Install the requirements:
$ (venv3) pip install -r requirements.txt
Start redis:
$ redis-server
Start RabbiqMQ:
$ rabbitmq-server
Start the Celery beat:
$ (venv3) sudo celery worker -A celery_worker.celery --loglevel=info -B --concurrency=1
Start the server:
$ (venv3) sudo python server.py run
How Does it Work?
-----------------
Chirp 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.Why?
----
Google 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.State of the Project
--------------------
This 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.