{"id":16651030,"url":"https://github.com/jsetton/craigslist-renew","last_synced_at":"2025-09-03T14:32:01.442Z","repository":{"id":50423806,"uuid":"107356141","full_name":"jsetton/craigslist-renew","owner":"jsetton","description":"A tool to auto-renew all inactive craigslist posts and notify of expired posts","archived":false,"fork":false,"pushed_at":"2023-12-23T17:51:33.000Z","size":43,"stargazers_count":26,"open_issues_count":0,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-17T02:03:49.316Z","etag":null,"topics":["craigslist","docker","python"],"latest_commit_sha":null,"homepage":null,"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/jsetton.png","metadata":{"files":{"readme":"README.md","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-18T03:48:55.000Z","updated_at":"2024-11-06T21:12:56.000Z","dependencies_parsed_at":"2023-11-15T03:28:35.415Z","dependency_job_id":"9dd16255-71ef-4a51-9620-0e497417dbee","html_url":"https://github.com/jsetton/craigslist-renew","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsetton%2Fcraigslist-renew","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsetton%2Fcraigslist-renew/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsetton%2Fcraigslist-renew/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsetton%2Fcraigslist-renew/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jsetton","download_url":"https://codeload.github.com/jsetton/craigslist-renew/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231893694,"owners_count":18442043,"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":["craigslist","docker","python"],"created_at":"2024-10-12T09:23:31.672Z","updated_at":"2024-12-30T17:36:14.382Z","avatar_url":"https://github.com/jsetton.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# craigslist-renew\n\nThis is a simple python script that will auto-renew all your active Craigslist posts. It can also notify you when a post expires.\n\n## Requirements\n\nThis project depends on the following python modules:\n\n* `beautifulsoup4`\n* `html5lib`\n* `PyYAML`\n* `selenium`\n\nUse the python package manager to install them:\n\n```\npip3 install -r requirements.txt\n```\n\n## Usage\n\nCreate a yaml config file with the following content:\n```yaml\n---\n#\n# Required parameters\n#\nemail: \u003ccraigslist login\u003e\npassword: \u003ccraigslist password\u003e\nnotify: \u003ccomma separated list of emails\u003e\n#\n# Optional parameters\n#\n# specify sender email address\nfrom: \u003csender email address\u003e\n# specify smtp server settings (defaults to using sendmail command if omitted)\nsmtp:\n  server: \u003chost:port\u003e\n  username: \u003cmail username\u003e\n  password: \u003cmail password\u003e\n# set to 1 to suppress notification emails on renewal\nno_success_mail: \u003c1|0\u003e\n# set to 1 to renew all posts available for renewal\n# By default, only the first expired post gets renewed on each run\nrenew_all: \u003c1|0\u003e\n# specify path for logging actions taken\nlogfile: \u003cpath-to-logfile\u003e\n# specify selenium webdriver local path or remote url (defaults to using chromedriver in local path if omitted)\nwebdriver: \u003cpath-to-webdriver\u003e\n# specify the list of your current postings for expiration notifications\npostings:\n  - title: My post\n    area: nyc\n  - title: Another post\n    area: nyc\n```\n\nThen just schedule the script in cron to run at the schedule you want. Depending on the category and location, craigslist posts can be renewed about once every few days, so running the script every few hours should be more than sufficient:\n```cron\n0 */2 * * * /path/to/craigslist-renew.py /path/to/config.yml\n```\n\nYou can only renew a post so many times before it expires, so to get notified about expired posts, make sure you have configured the `postings` parameter in your configuration and add the following (daily) cronjob:\n```cron\n0 21 * * * /path/to/craigslist-renew.py --expired /path/to/config.yml\n```\n\n## Docker Image\n\n[![dockeri.co](https://dockeri.co/image/jsetton/craigslist-renew)](https://hub.docker.com/r/jsetton/craigslist-renew).\n\n### Supported tags\n\nBy default, the chromedriver package is included as local webdriver. If you rather use a [Selenium Grid](https://www.selenium.dev/docs/site/en/grid/) server instead, use the `remote` tag. If going with the latter, make sure to specify the remote url in the config file.\n\n|       Tags        | Description              |\n| :---------------: | ------------------------ |\n| `latest`, `local` | Local webdriver support  |\n|     `remote`      | Remote webdriver support |\n\n### Run commands\n\nMake sure that the configuration file `config.yml` is in the directory you are running the commands below or specify the proper directory path in the volume parameter. The log file path should be set to `/data/\u003clogfile\u003e` in the configuration file, if specified.\n\n#### Renew posts\n```bash\ndocker run --rm -v $(pwd):/data jsetton/craigslist-renew\n```\n\n#### Check expired posts\n```bash\ndocker run --rm -v $(pwd):/data jsetton/craigslist-renew --expired\n```\n\n## Kubernetes CronJob\n\nTo deploy this script as a [Kubernetes CronJob](https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/)\n\n### Create ConfMap\n\n``` bash\nkubectl create configmap craigslist-renew-config --from-file=config.yml\n```\n\n### Apply the Job\n\nAdjust `kubernetes/cronjob.yaml` cron schedule, defaults to every odd day.\n\n``` bash\nkubectl apply -f kubernetes/cronjob.yaml\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsetton%2Fcraigslist-renew","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjsetton%2Fcraigslist-renew","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsetton%2Fcraigslist-renew/lists"}