https://github.com/VikParuchuri/apartment-finder

A Slack bot that helps you find an apartment.
https://github.com/VikParuchuri/apartment-finder

Last synced: 4 months ago
JSON representation

A Slack bot that helps you find an apartment.

• Host: GitHub
• URL: https://github.com/VikParuchuri/apartment-finder
• Owner: VikParuchuri
• License: mit
• Archived: true
• Created: 2016-03-16T05:23:45.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2019-08-08T21:06:26.000Z (over 5 years ago)
• Last Synced: 2024-09-26T22:24:24.924Z (5 months ago)
• Language: Python
• Homepage:
• Size: 21.5 KB
• Stars: 1,063
• Watchers: 54
• Forks: 328
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Apartment finder

-------------------

This repo contains the code for a bot that will scrape Craigslist for real-time listings matching specific criteria, then alert you in Slack.  This will let you quickly see the best new listings, and contact the owners.  You can adjust the settings to change your price range, what neighborhoods you want to look in, and what transit stations and other points of interest you'd like to be close to.

I successfully used this tool to find an apartment when I moved from Boston to SF.  It saved a good amount of time and money.  Read more about it [here](https://www.dataquest.io/blog/apartment-finding-slackbot/).

It's recommended to follow the Docker installation and usage instructions.

Settings

--------------------

Look in `settings.py` for a full list of all the configuration options.  Here's a high level overview:

* `MIN_PRICE` -- the minimum listing price you want to search for.

* `MAX_PRICE` -- the minimum listing price you want to search for.

* `CRAIGSLIST_SITE` -- the regional Craigslist site you want to search in.

* `AREAS` -- a list of areas of the regional Craiglist site that you want to search in.

* `BOXES` -- coordinate boxes of the neighborhoods you want to look in.

* `NEIGHBORHOODS` -- if the listing doesn't have coordinates, a list of neighborhoods to match on.

* `MAX_TRANSIT_DISTANCE` -- the farthest you want to be from a transit station.

* `TRANSIT_STATIONS` -- the coordinates of transit stations.

* `CRAIGSLIST_HOUSING_SECTION` -- the subsection of Craigslist housing that you want to look in.

* `SLACK_CHANNEL` -- the Slack channel you want the bot to post in.

External Setup

--------------------

Before using this bot, you'll need a Slack team, a channel for the bot to post into, and a Slack API key:

* Create a Slack team, which you can do [here](https://slack.com/create#email).  

* Create a channel for the listings to be posted into.  [Here's](https://get.slack.help/hc/en-us/articles/201402297-Creating-a-channel) help on this.  It's suggested to use `#housing` as the name of the channel.

* Get a Slack API token, which you can do [here](https://api.slack.com/docs/oauth-test-tokens).  [Here's](https://get.slack.help/hc/en-us/articles/215770388-Creating-and-regenerating-API-tokens) more information on the process.

Configuration

--------------------

## Docker

* Create a folder called `config`, then put a file called `private.py` inside.

* Specify new values for any of the settings above in `private.py`.

    * For example, you could put `AREAS = ['sfc']` in `private.py` to only look in San Francisco.

    * If you want to post into a Slack channel not called `housing`, add an entry for `SLACK_CHANNEL`.

    * If you don't want to look in the Bay Area, you'll need to update the following settings at the minimum:

        * `CRAIGSLIST_SITE`

        * `AREAS`

        * `BOXES`

        * `NEIGHBORHOODS`

        * `TRANSIT_STATIONS`

        * `CRAIGSLIST_HOUSING_SECTION`

        * `MIN_PRICE`

        * `MAX_PRICE`

## Manual

* Create a file called `private.py` in this folder.

    * Add a value called `SLACK_TOKEN` that contains your Slack API token.

    * Add any other values you want to `private.py`.

Installation + Usage

--------------------

## Docker

* Make sure to do the steps in the configuration section above first.

* Install Docker by following [these instructions](https://docs.docker.com/engine/installation/).

* To run the program with the default configuration:

    * `docker run -d -e SLACK_TOKEN={YOUR_SLACK_TOKEN} dataquestio/apartment-finder`

* To run the program with your own configuration:

    * `docker run -d -e SLACK_TOKEN={YOUR_SLACK_TOKEN} -v {ABSOLUTE_PATH_TO_YOUR_CONFIG_FOLDER}:/opt/wwc/apartment-finder/config dataquestio/apartment-finder`

    

## Manual

* Look in the `Dockerfile`, and make sure you install any of the apt packages listed there.

* Install Python 3 using Anaconda or another method.

* Install the Python requirements with `pip install -r requirements.txt`.

* Run the program with `python main_loop.py`. Results will be posted to your #Housing channel if successful.

Troubleshooting

---------------------

## Docker

* Use `docker ps` to get the id of the container running the bot.

* Run `docker exec -it {YOUR_CONTAINER_ID} /bin/bash` to get a command shell inside the container.

* Run `sqlite listings.db` to run the sqlite command line tool and inspect the database state (the only table is also called `listings`).

    * `select * from listings` will get all of the stored listings.

    * If nothing is in the database, you may need to wait for a bit, or verify that your settings aren't too restrictive and aren't finding any listings.

    * You can see how many listings are being found by looking at the logs.

* Inspect the logs using `tail -f -n 1000 /opt/wwc/logs/afinder.log`.

## Manual

* Look at the stdout of the main program.

* Inspect `listings.db` to ensure listings are being added.

Deploying

---------------------

* Create a server that has Docker installed.  It's suggested to use Digital Ocean.

* Follow the configuration + installation instructions for Docker above.