{"id":23606262,"url":"https://github.com/vaibhavk97/amalert","last_synced_at":"2025-04-25T11:10:40.720Z","repository":{"id":143304099,"uuid":"141611752","full_name":"vaibhavk97/AmAlert","owner":"vaibhavk97","description":"Asynchronous Amazon product tracker","archived":false,"fork":false,"pushed_at":"2018-07-28T13:55:02.000Z","size":20,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-27T13:20:24.501Z","etag":null,"topics":["alert","amazon","asynchronous","python","slack-api","tracker"],"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/vaibhavk97.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}},"created_at":"2018-07-19T17:34:41.000Z","updated_at":"2021-12-09T12:33:19.000Z","dependencies_parsed_at":"2023-05-12T07:45:47.255Z","dependency_job_id":null,"html_url":"https://github.com/vaibhavk97/AmAlert","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/vaibhavk97%2FAmAlert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaibhavk97%2FAmAlert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaibhavk97%2FAmAlert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaibhavk97%2FAmAlert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vaibhavk97","download_url":"https://codeload.github.com/vaibhavk97/AmAlert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250805795,"owners_count":21490189,"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":["alert","amazon","asynchronous","python","slack-api","tracker"],"created_at":"2024-12-27T13:19:54.065Z","updated_at":"2025-04-25T11:10:40.666Z","avatar_url":"https://github.com/vaibhavk97.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"AmAlert\n==================\n\nAn asynchronous Amazon product tracker that sends alerts on slack when the price of product(s) reaches a threshold.\n\n## Dependencies\n```\nrequests_futures\nbs4\nslackclient\nhtml5lib\n```\n## Installation\nThe code was written in python 3.6 , may work for python 3.2+.\nIn the command prompt/terminal run the following commands\n```\ngit clone https://github.com/vaibhavk97/AmAlert.git\ncd AmAlert/\npip install -r requirements.txt\n```\n## Configuration\nConfiguration is held in json format in the file `config.json` . \n```\nslack-token : the token for your slack workspace.\nmain-channel : The channel on your workspace where you will receive the main alerts.\nerror-channel : The channel where errors will be reported if found.\nstatus-channel : The channel where the state of the program will be updated hourly the format is similiar to the output file.\nfail_delay : The time for pausing in between sending the requests (low value might lead to ip ban).\nworkers : Determines the  number of parallel requests to send at once.\n```\nYou can get the slack token for your workspace from here : https://goo.gl/duqpz5.  \nSet the price field as a empty string if you want in stock notification.  \nThe details for products are also held in json format in the `data.json` file. The fields are as follows\n```\ncheck_prime : Whether to check for prime seller or not {true/false}.\nalert_price : the threshold price to send alert.\nsingle_alert : Whether to send a single alert or multiple alerts when the condition is met.\n```\nThe key represents the ASIN(Amazon Standard Identication Number) of the product which can be found in the product info on the amazon page.  \nSample products have been added to the file , you can add more separated by commas in the same format.\n## OUTPUT\nThe program saves the current progress in the output.txt file . The fields are as follows:\n```\ncolumn 1 : Number of requests sent for the product\ncolumn 2 : Number of alert messages sent on slack for the product.\ncolumn 3 : Current lowest price of the product (excludes shipping).\ncolumn 4 : Whether the seller is prime or not.\ncolumn 5 : seller name\ncolumn 6 : product name\n```\n## TODO\n```\nAdd proxy support\nAdd dynamic updation and changes in the data files via slack.\nAdd price history graphs.\nAdd support for amazon pantry.\nAdd support for amazon in other countries than india.\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaibhavk97%2Famalert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaibhavk97%2Famalert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaibhavk97%2Famalert/lists"}